From 257ba03baee92d2d8aab3c08a572318defed7a68 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 28 May 2026 03:12:25 +0000
Subject: [PATCH 1/7] Add Slack channel support via slack-bolt Socket Mode

Implements SlackChannel following the same conventions as the existing
Discord and Telegram channels. Wires it into bg_server and config
(env vars SLACK_BOT_TOKEN, SLACK_APP_TOKEN, SLACK_ALLOW_FROM).

https://claude.ai/code/session_01Fa64TcstSLyfugG93cjYR2
---
 app/bg_server.py            |  25 +++-
 app/channels/channel.py     |   1 +
 app/channels/slack.py       | 122 +++++++++++++++++
 app/config.py               |  13 +-
 pyproject.toml              |   2 +-
 tests/test_slack_channel.py | 263 ++++++++++++++++++++++++++++++++++++
 uv.lock                     | 147 +++++++++++---------
 7 files changed, 506 insertions(+), 67 deletions(-)
 create mode 100644 app/channels/slack.py
 create mode 100644 tests/test_slack_channel.py

diff --git a/app/bg_server.py b/app/bg_server.py
index 4409e01..d4f206c 100755
--- a/app/bg_server.py
+++ b/app/bg_server.py
@@ -15,6 +15,10 @@ async def start_server() -> None:
     telegram_agent = None
     discord_channel = None
     discord_agent = None
+    web_channel = None
+    web_agent = None
+    slack_channel = None
+    slack_agent = None
 
     # Change CWD to PROJECT_HOME/workspace to ensure all file operations are relative to this directory
     # This is important for the agent to read/write files in the workspace
@@ -44,8 +48,6 @@ async def start_server() -> None:
             discord_channel.start()
             discord_agent = BackgroundAgent(mq=discord_mq, channel=discord_channel, max_iterations=runtime.get("max_iterations", 250))
 
-    web_channel = None
-    web_agent = None
     if config.get("websocket"):
         from .channels.web_channel import WebChannel
         ws_config = config.get("websocket")
@@ -57,7 +59,19 @@ async def start_server() -> None:
         web_channel.start()
         web_agent = BackgroundAgent(mq=web_mq, channel=web_channel, max_iterations=runtime.get("max_iterations", 250))
 
-    if not telegram_channel and not discord_channel and not web_channel:
+    if config.get("slack"):
+        slack_bot_token = config.slack.get("BOT_TOKEN")
+        slack_app_token = config.slack.get("APP_TOKEN")
+        if not slack_bot_token or not slack_app_token:
+            log.error("Slack BOT_TOKEN and APP_TOKEN are required, skipping Slack channel")
+        else:
+            from .channels.slack import SlackChannel
+            slack_mq = MessageQueue()
+            slack_channel = SlackChannel(slack_mq, bot_token=slack_bot_token, app_token=slack_app_token, allow_from=config.slack.get("ALLOW_FROM", []))
+            slack_channel.start()
+            slack_agent = BackgroundAgent(mq=slack_mq, channel=slack_channel, max_iterations=runtime.get("max_iterations", 250))
+
+    if not telegram_channel and not discord_channel and not web_channel and not slack_channel:
         log.error("No channels configured, exiting...")
         return
 
@@ -73,6 +87,9 @@ async def start_server() -> None:
         from .channels.channel import ChannelType
         channels[ChannelType.WEB.value] = web_channel
         mqs[ChannelType.WEB.value] = web_mq
+    if slack_channel:
+        channels["slack"] = slack_channel
+        mqs["slack"] = slack_mq
 
     tasks = ScheduledTasks(mqs=mqs, channels=channels)
 
@@ -83,5 +100,7 @@ async def start_server() -> None:
         coros.extend([discord_channel.run_polling(), discord_agent.process_incoming(), discord_mq.process_outgoing()])
     if web_channel:
         coros.extend([web_channel.run_polling(), web_agent.process_incoming(), web_mq.process_outgoing()])
+    if slack_channel:
+        coros.extend([slack_channel.run_polling(), slack_agent.process_incoming(), slack_mq.process_outgoing()])
 
     await asyncio.gather(*coros)
diff --git a/app/channels/channel.py b/app/channels/channel.py
index 844e9dd..1e0e98c 100755
--- a/app/channels/channel.py
+++ b/app/channels/channel.py
@@ -5,6 +5,7 @@ class ChannelType(Enum):
     CLI = "cli"
     TELEGRAM = "telegram"
     DISCORD = "discord"
+    SLACK = "slack"
     WEB = "web"
 
 class Channel(ABC):
diff --git a/app/channels/slack.py b/app/channels/slack.py
new file mode 100644
index 0000000..cfb3541
--- /dev/null
+++ b/app/channels/slack.py
@@ -0,0 +1,122 @@
+import asyncio
+import logging
+
+from slack_bolt.async_app import AsyncApp
+from slack_bolt.adapter.socket_mode.async_handler import AsyncSocketModeHandler
+
+from .message_queue import MessageQueue
+from .channel import Channel, ChannelType
+from .message import OutgoingMessage, IncomingMessage
+
+log = logging.getLogger(__name__)
+
+MAX_SLACK_LENGTH = 3000
+
+
+class SlackChannel(Channel):
+    def __init__(
+        self,
+        mq: MessageQueue,
+        bot_token: str,
+        app_token: str,
+        allow_from: list[str] = None,
+    ) -> None:
+        self.bot_token = bot_token
+        self.app_token = app_token
+        self.allow_from = allow_from or []
+        self.mq = mq
+        self.stopped = False
+        self._last_channel_id: str | None = None
+        self._bot_user_id: str | None = None
+        self.app = AsyncApp(token=bot_token)
+        mq.register(self, self.send_message)
+        self._register_handlers()
+
+    def _register_handlers(self) -> None:
+        self.app.event("message")(self._handle_message)
+
+    @property
+    def has_stopped(self) -> bool:
+        return self.stopped
+
+    def clear_stopped(self) -> None:
+        self.stopped = False
+
+    @property
+    def channel_type(self) -> ChannelType:
+        return ChannelType.SLACK
+
+    @property
+    def default_metadata(self) -> dict:
+        return {"channel_id": self._last_channel_id} if self._last_channel_id else {}
+
+    async def _handle_message(self, event: dict, say) -> None:
+        # ignore bot messages and message edits/deletes
+        if event.get("bot_id") or event.get("subtype"):
+            return
+
+        user_id = event.get("user", "")
+        if self.allow_from and user_id not in self.allow_from:
+            log.warning(f"Slack: ignoring message from unauthorized user id={user_id}")
+            await say("Sorry, you are not authorized to use this bot.")
+            return
+
+        content = (event.get("text") or "").strip()
+        if not content:
+            return
+
+        channel_id = event.get("channel", "")
+        metadata = {"channel_id": channel_id}
+
+        if content.startswith("/"):
+            cmd_name = content[1:].split(maxsplit=1)[0].lower()
+            if cmd_name == "whoami":
+                await self.send_message(OutgoingMessage(
+                    content=f"Your user ID is {user_id}.",
+                    channel=ChannelType.SLACK,
+                    metadata=metadata,
+                ))
+                return
+            if cmd_name == "stop":
+                self.stopped = True
+                await self.send_message(OutgoingMessage(
+                    content="Stopped.",
+                    channel=ChannelType.SLACK,
+                    metadata=metadata,
+                ))
+                return
+
+        self._last_channel_id = channel_id
+        await self.mq.incoming.put(
+            IncomingMessage(
+                content=content,
+                channel=ChannelType.SLACK,
+                metadata=metadata,
+            )
+        )
+
+    async def send_message(self, msg: OutgoingMessage) -> None:
+        channel_id = msg.metadata.get("channel_id")
+        if not channel_id:
+            log.error("Slack: cannot send message, no channel_id in metadata")
+            return
+        for i in range(0, len(msg.content), MAX_SLACK_LENGTH):
+            chunk = msg.content[i : i + MAX_SLACK_LENGTH]
+            await self.app.client.chat_postMessage(channel=channel_id, text=chunk)
+
+    async def process_message(self, message) -> None:
+        pass  # handled by slack bolt event handlers
+
+    def error_handler(self, update, context) -> None:
+        log.error(f"Slack error: {context}")
+
+    def start(self) -> None:
+        log.info("Starting Slack channel...")
+
+    async def run_polling(self) -> None:
+        handler = AsyncSocketModeHandler(self.app, self.app_token)
+        await handler.start_async()
+        try:
+            await asyncio.Event().wait()
+        finally:
+            await handler.close_async()
diff --git a/app/config.py b/app/config.py
index ed9f4d8..d021a4f 100644
--- a/app/config.py
+++ b/app/config.py
@@ -44,6 +44,12 @@ def load(path: Path | str = HOME_CONFIG_PATH) -> None:
             _config.setdefault("websocket", {})["PORT"] = int(v)
         except ValueError:
             raise ValueError(f"WEBSOCKET_PORT must be an integer, got: {v!r}") from None
+    if v := os.environ.get("SLACK_BOT_TOKEN"):
+        _config.setdefault("slack", {})["BOT_TOKEN"] = v
+    if v := os.environ.get("SLACK_APP_TOKEN"):
+        _config.setdefault("slack", {})["APP_TOKEN"] = v
+    if v := os.environ.get("SLACK_ALLOW_FROM"):
+        _config.setdefault("slack", {})["ALLOW_FROM"] = [x.strip() for x in v.split(",") if x.strip()]
 
 
 def get(key: str, default=None):
@@ -51,7 +57,7 @@ def get(key: str, default=None):
 
 def set(key: str, value) -> None:
     _config[key] = value
-    
+
 def __getattr__(name: str):
     if name in _config:
         return _config[name]
@@ -75,4 +81,9 @@ def get_default_config() -> str:
 [websocket]
 HOST = "127.0.0.1"
 PORT = 8765
+
+[slack]
+BOT_TOKEN = ""   # xoxb-... bot token
+APP_TOKEN = ""   # xapp-... app-level token (required for Socket Mode)
+ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty means allow all.
 """
diff --git a/pyproject.toml b/pyproject.toml
index f20fb52..e5803a7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,6 +12,7 @@ dependencies = [
     "discord-py>=2.7.1",
     "python-fasthtml>=0.14.2",
     "uvicorn[standard]>=0.48.0",
+    "slack-bolt>=1.18.0",
 ]
 
 [dependency-groups]
@@ -25,4 +26,3 @@ dev = [
 [tool.pytest.ini_options]
 asyncio_mode = "strict"
 
-
diff --git a/tests/test_slack_channel.py b/tests/test_slack_channel.py
new file mode 100644
index 0000000..6c4a51c
--- /dev/null
+++ b/tests/test_slack_channel.py
@@ -0,0 +1,263 @@
+import pytest
+from unittest.mock import patch, MagicMock, AsyncMock
+
+from app.channels.channel import ChannelType
+from app.channels.slack import SlackChannel, MAX_SLACK_LENGTH
+from app.channels.message import OutgoingMessage
+from app.channels.message_queue import MessageQueue
+
+
+def make_slack_channel(allow_from=None):
+    mq = MessageQueue()
+    with patch("app.channels.slack.AsyncApp"), \
+         patch("app.channels.slack.AsyncSocketModeHandler"):
+        sc = SlackChannel(mq=mq, bot_token="xoxb-test", app_token="xapp-test", allow_from=allow_from)
+    return sc, mq
+
+
+# --- Initialization ---
+
+def test_registers_delivery_function():
+    sc, mq = make_slack_channel()
+    assert sc in mq._delivery
+    assert mq._delivery[sc].__func__ is SlackChannel.send_message
+
+
+def test_stores_tokens():
+    sc, _ = make_slack_channel()
+    assert sc.bot_token == "xoxb-test"
+    assert sc.app_token == "xapp-test"
+
+
+def test_channel_type():
+    sc, _ = make_slack_channel()
+    assert sc.channel_type == ChannelType.SLACK
+
+
+def test_initial_stopped_false():
+    sc, _ = make_slack_channel()
+    assert sc.has_stopped is False
+
+
+def test_clear_stopped_resets_state():
+    sc, _ = make_slack_channel()
+    sc.stopped = True
+    sc.clear_stopped()
+    assert sc.has_stopped is False
+
+
+# --- default_metadata ---
+
+def test_default_metadata_empty_before_any_message():
+    sc, _ = make_slack_channel()
+    assert sc.default_metadata == {}
+
+
+# --- _handle_message ---
+
+@pytest.mark.asyncio
+async def test_handle_message_puts_to_incoming_queue():
+    sc, mq = make_slack_channel()
+    say = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "hello", "channel": "C456"},
+        say=say,
+    )
+
+    assert not mq.incoming.empty()
+    msg = await mq.incoming.get()
+    assert msg.content == "hello"
+    assert msg.channel == ChannelType.SLACK
+    assert msg.metadata == {"channel_id": "C456"}
+
+
+@pytest.mark.asyncio
+async def test_handle_message_ignores_bot_messages():
+    sc, mq = make_slack_channel()
+    say = AsyncMock()
+
+    await sc._handle_message(
+        event={"bot_id": "B123", "text": "i am a bot", "channel": "C456"},
+        say=say,
+    )
+
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_ignores_subtypes():
+    sc, mq = make_slack_channel()
+    say = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "edited", "channel": "C456", "subtype": "message_changed"},
+        say=say,
+    )
+
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_rejects_unauthorized_user():
+    sc, mq = make_slack_channel(allow_from=["U111", "U222"])
+    say = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U999", "text": "hello", "channel": "C456"},
+        say=say,
+    )
+
+    assert mq.incoming.empty()
+    say.assert_called_once()
+    assert "not authorized" in say.call_args[0][0]
+
+
+@pytest.mark.asyncio
+async def test_handle_message_allows_when_allow_from_empty():
+    sc, mq = make_slack_channel(allow_from=[])
+
+    await sc._handle_message(
+        event={"user": "U999", "text": "hello", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    assert not mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_allows_authorized_user():
+    sc, mq = make_slack_channel(allow_from=["U123"])
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "hello", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    assert not mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_trims_whitespace():
+    sc, mq = make_slack_channel()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "  hi there  ", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    msg = await mq.incoming.get()
+    assert msg.content == "hi there"
+
+
+@pytest.mark.asyncio
+async def test_handle_message_ignores_empty_text():
+    sc, mq = make_slack_channel()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "   ", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_updates_last_channel_id():
+    sc, mq = make_slack_channel()
+
+    for ch in ["C1", "C2", "C3"]:
+        await sc._handle_message(
+            event={"user": "U123", "text": "hi", "channel": ch},
+            say=AsyncMock(),
+        )
+        await mq.incoming.get()
+
+    assert sc._last_channel_id == "C3"
+    assert sc.default_metadata == {"channel_id": "C3"}
+
+
+# --- commands ---
+
+@pytest.mark.asyncio
+async def test_whoami_replies_with_user_id():
+    sc, mq = make_slack_channel()
+    sc.send_message = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "/whoami", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    sc.send_message.assert_called_once()
+    sent = sc.send_message.call_args[0][0]
+    assert "U123" in sent.content
+    assert sent.metadata == {"channel_id": "C456"}
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_stop_sets_stopped_flag():
+    sc, mq = make_slack_channel()
+    sc.send_message = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "/stop", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    assert sc.has_stopped is True
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_other_command_enqueued():
+    sc, mq = make_slack_channel()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "/status", "channel": "C456"},
+        say=AsyncMock(),
+    )
+
+    assert not mq.incoming.empty()
+    msg = await mq.incoming.get()
+    assert msg.content == "/status"
+
+
+# --- send_message ---
+
+@pytest.mark.asyncio
+async def test_send_message_posts_to_channel():
+    sc, _ = make_slack_channel()
+    sc.app.client.chat_postMessage = AsyncMock()
+
+    msg = OutgoingMessage(content="hello", channel=ChannelType.SLACK, metadata={"channel_id": "C456"})
+    await sc.send_message(msg)
+
+    sc.app.client.chat_postMessage.assert_called_once_with(channel="C456", text="hello")
+
+
+@pytest.mark.asyncio
+async def test_send_message_splits_long_content():
+    sc, _ = make_slack_channel()
+    sc.app.client.chat_postMessage = AsyncMock()
+
+    long_content = "x" * (MAX_SLACK_LENGTH + 100)
+    msg = OutgoingMessage(content=long_content, channel=ChannelType.SLACK, metadata={"channel_id": "C456"})
+    await sc.send_message(msg)
+
+    assert sc.app.client.chat_postMessage.call_count == 2
+
+
+@pytest.mark.asyncio
+async def test_send_message_logs_error_when_no_channel_id(caplog):
+    import logging
+    sc, _ = make_slack_channel()
+    sc.app.client.chat_postMessage = AsyncMock()
+
+    msg = OutgoingMessage(content="hello", channel=ChannelType.SLACK, metadata={})
+    with caplog.at_level(logging.ERROR):
+        await sc.send_message(msg)
+
+    assert sc.app.client.chat_postMessage.call_count == 0
+    assert "channel_id" in caplog.text
diff --git a/uv.lock b/uv.lock
index ae9276e..6045ac8 100644
--- a/uv.lock
+++ b/uv.lock
@@ -138,62 +138,62 @@ wheels = [
 
 [[package]]
 name = "apsw"
-version = "3.53.1.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/5a/5f/0fabac91b26d222f5ad1bf8af92f6c80d82af2e50dafb401a250a02b2f53/apsw-3.53.1.0.tar.gz", hash = "sha256:4f8978ae8c7c405d0133a6ea590f3342f839143bdf39e46029cb36e2fa418692", size = 1242069, upload-time = "2026-05-05T18:49:59.721Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/2b/a6/6fe7389415d0b57879870fc8a40800b13dd8efd346a2979745c00eab6880/apsw-3.53.1.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:92c2597c5d5b1b916f3e90384a6361c7b553d918a9591c1b71d1321f381b2cc7", size = 3271352, upload-time = "2026-05-05T18:48:20.597Z" },
-    { url = "https://files.pythonhosted.org/packages/23/9c/0b33ce05221eedeb71a644618c417f3349dd5c785ad860931199cd5657ff/apsw-3.53.1.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ab7a8a0c61e784b429b8b109fa15fe41561bf40cc3fe9fa8b4afc44cdfa18e39", size = 3067463, upload-time = "2026-05-05T18:48:22.385Z" },
-    { url = "https://files.pythonhosted.org/packages/ac/bf/94352cdd603e159efb0de1669f19e75579171158f5331adeba08538ad8b4/apsw-3.53.1.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:ee7e61b7496a8cdecd238d154b525e48531e99ba6def117466a6dcfbc01d6299", size = 3486388, upload-time = "2026-05-05T18:48:23.997Z" },
-    { url = "https://files.pythonhosted.org/packages/76/0b/c793186312df0ad7ce49ad6215f6184dd08a9d87f9dd9e1b09cf0548caf2/apsw-3.53.1.0-cp312-cp312-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:1eaf42de9782b1d43c6d2f8d281a0fb7f7d6998818cd9c6e9918e36557499ec8", size = 3270824, upload-time = "2026-05-05T18:48:25.66Z" },
-    { url = "https://files.pythonhosted.org/packages/08/15/e703f205f82ff53a6a196a35fd2df76545fd7e891ad4a11ce695d5faf3c6/apsw-3.53.1.0-cp312-cp312-manylinux_2_28_i686.whl", hash = "sha256:93a3ba00b64e5ada05d25e3c57cd911f1e3a8a0bf241c76ab20f61876137c523", size = 3879312, upload-time = "2026-05-05T18:48:27.287Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/ba/527c0697db61f59f376567437a681c2fa47fc828085a6676a3aa8e72864d/apsw-3.53.1.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:892a7b63db72280e42c388684bb41144822a25fd2d5a6c28e2f719b09468d5f0", size = 3640415, upload-time = "2026-05-05T18:48:29.392Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/df/02ba47709eff8f4e8df7a245f569803422aba22d50cc878575382b84b929/apsw-3.53.1.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a026dccbf8716bc5e3f041fdc1b853cace802aa215a3a4a18a060a4dd16cd421", size = 3493205, upload-time = "2026-05-05T18:48:31.412Z" },
-    { url = "https://files.pythonhosted.org/packages/10/c1/6a8485acba0383d1c1674537d0da679a5a72ba996f2d96a1cc6b17fae3f7/apsw-3.53.1.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:908d0a1b393eb434e79bb38c8c7f8a1946db88a0d63a11a0ed615976d03a0435", size = 3278486, upload-time = "2026-05-05T18:48:33.463Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/b8/8ef2b5173f2e0c552c396c5ff51d35b5a9b7f25dd0b91f2a6c5a51d04c22/apsw-3.53.1.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:3241518163ced48c31c660b76fff6035cbb40c838705e47f6f687d348bd94602", size = 3896255, upload-time = "2026-05-05T18:48:35.207Z" },
-    { url = "https://files.pythonhosted.org/packages/0f/66/9e72093a080afcd40dfa6f4aa3f2794ca59c5602a65ed570e3679536990e/apsw-3.53.1.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2e6a8f5b5c0cdf5dbb9574d3fbe941b1065bbe23281ff11c7be4ae223391cece", size = 3648722, upload-time = "2026-05-05T18:48:37.04Z" },
-    { url = "https://files.pythonhosted.org/packages/50/9c/51e1b8b075d92660a7375ac7d2dda89a31f196e051cf4353f98b820e8603/apsw-3.53.1.0-cp312-cp312-win32.whl", hash = "sha256:e526dadd9544885c47dfd9179cae6c37aed81b303ab962afe085be840d6d0993", size = 2909476, upload-time = "2026-05-05T18:48:38.721Z" },
-    { url = "https://files.pythonhosted.org/packages/57/3d/ee6bfbe2dac4b3d2735083e2e3f781d388ffa4445830eb180fda193169f5/apsw-3.53.1.0-cp312-cp312-win_amd64.whl", hash = "sha256:8a97dd446862cc28c4c2b611413cb9ea994dda8fb9d6e2d7a4239bfda09ce347", size = 3220782, upload-time = "2026-05-05T18:48:40.786Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/d1/c875f4a521d717f1effaaf36c9456a42a525d1f46e23ee4a74b60b200ba4/apsw-3.53.1.0-cp312-cp312-win_arm64.whl", hash = "sha256:56e1ad4847adc0f785dff374004c4cd9bfb095470f6ba60063758ab9df08fc43", size = 2875529, upload-time = "2026-05-05T18:48:42.393Z" },
-    { url = "https://files.pythonhosted.org/packages/41/b5/262c63adb3b9f4e4021a9326ddedc5d5026c43a749303e622949e9f4227f/apsw-3.53.1.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:12bf947396fc8ac652f63e52de754459865c50500073627d200ba4c800e909a9", size = 3268427, upload-time = "2026-05-05T18:48:44.434Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/e5/e8ecbd46eaaef62600e54d237808f92ce91a309d50afb6e2552c49279743/apsw-3.53.1.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5c81c4854c70d69a472e897d238a874032abf4df23717f925c75e1859b8f4912", size = 3065309, upload-time = "2026-05-05T18:48:46.076Z" },
-    { url = "https://files.pythonhosted.org/packages/9d/2b/fc45e8746414a2311bd5cea4627a5645f5339a863837f2d2c3ef0d245b65/apsw-3.53.1.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:d8525ebbc4b9a77110fd0c69d7c1859619d55b1455e4750b7260be8959fcbd6b", size = 3486465, upload-time = "2026-05-05T18:48:48.658Z" },
-    { url = "https://files.pythonhosted.org/packages/88/cc/2051660762aefa2aa5a55b82952dc5034b46bce1959b29713adefebd8b51/apsw-3.53.1.0-cp313-cp313-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:bf295a288f46e6f8f018b940e6555b238699adc5ae61980bbbf15abf1644c47a", size = 3272768, upload-time = "2026-05-05T18:48:50.342Z" },
-    { url = "https://files.pythonhosted.org/packages/87/4e/1c7c318ad5497a238ec1e0311e4722a012237ee88cb29888ca6d9b0e8f36/apsw-3.53.1.0-cp313-cp313-manylinux_2_28_i686.whl", hash = "sha256:e2e9b4abc58d375bb79c35136d0107e7efb804f64e6592e620dc665f8a9985d5", size = 3871154, upload-time = "2026-05-05T18:48:51.958Z" },
-    { url = "https://files.pythonhosted.org/packages/d0/e4/aedd6ecd2f63d3c08ba8009adeea3b9f25fab277f6877206e3b2471f9b72/apsw-3.53.1.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:e477a06eef7e17454487837db88506fc9581e9167f9a0ecc7ac17dfb10623fda", size = 3642123, upload-time = "2026-05-05T18:48:53.889Z" },
-    { url = "https://files.pythonhosted.org/packages/60/77/61fedaa8ee285e63242b20162c4465d94993887fb8f2860affb2aa18dbdd/apsw-3.53.1.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:fd47f31af34eb054430cdc2f7468c6d28f993bcf2ef0f5584402c12d6f0e798b", size = 3489257, upload-time = "2026-05-05T18:48:55.727Z" },
-    { url = "https://files.pythonhosted.org/packages/be/c6/9ff3673bf4dc59fb9d7a51eded0f0752a35097922dab6ec6b4a4f3829903/apsw-3.53.1.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:51321e757ae553df2feb2854fb727f660d21201863faf691ffcf0b6190b72bb3", size = 3281737, upload-time = "2026-05-05T18:48:57.598Z" },
-    { url = "https://files.pythonhosted.org/packages/f1/df/f40c83870f508d2bda148516ac9755591d0ac290545cfc80bb4c506029be/apsw-3.53.1.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:b8dad0d22c93ca7a1e9f8b981708ce25ebdf2a252ee1bd9ede7959e9fc3f24b4", size = 3889131, upload-time = "2026-05-05T18:48:59.457Z" },
-    { url = "https://files.pythonhosted.org/packages/29/7c/ce760653165df3284d6d4c2f7def44105f9cc080da51a10f9411e0491189/apsw-3.53.1.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:bb89433a540c572040fe3cfa3104bfb5039730bed473b5d54c6285bd06f821cb", size = 3650898, upload-time = "2026-05-05T18:49:01.752Z" },
-    { url = "https://files.pythonhosted.org/packages/2c/8e/3c6ad293b7e637c4f9ba82db6777c8a26c81035abd7d9d0ab4d77c6c0831/apsw-3.53.1.0-cp313-cp313-win32.whl", hash = "sha256:e19ef1981681225ea66c90bdc04bf01767854132ab328dd2ec9ae7729a57ed54", size = 2908457, upload-time = "2026-05-05T18:49:03.53Z" },
-    { url = "https://files.pythonhosted.org/packages/ab/11/71c1afe3bbd2dba9654480445c9d98ef6805f947ee4980c8436440c9e7e1/apsw-3.53.1.0-cp313-cp313-win_amd64.whl", hash = "sha256:f039e2947f16b95fc4f8705e348c6e916b7eaf7fb48dbbf8751ddec9c7529b93", size = 3219700, upload-time = "2026-05-05T18:49:05.364Z" },
-    { url = "https://files.pythonhosted.org/packages/69/03/cba7d6d4eec3c8d04fcbfd3b931250e9a290b161c77f1d7f2da0374a1956/apsw-3.53.1.0-cp313-cp313-win_arm64.whl", hash = "sha256:805a9a11b6aec22c7e0ecb31e8e08f250efce5d4cedb222113c5fdc80be2250c", size = 2874907, upload-time = "2026-05-05T18:49:07.475Z" },
-    { url = "https://files.pythonhosted.org/packages/47/68/0652d2de5140c51b727a1395f251f83e21092171445ad591c43e1b2a322c/apsw-3.53.1.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:b420e3c3b2805bdbbe9f32e3badc6923e7344ffd932b9be2a811c045837f3880", size = 3272671, upload-time = "2026-05-05T18:49:09.419Z" },
-    { url = "https://files.pythonhosted.org/packages/7e/3b/f4a93929c4a633ddeeed58e67506aa9f03dab98057a2e73dc5c2408dabcf/apsw-3.53.1.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ee3ede9d7e6360da95983a4481f3375873aeadbd2c405a59bcf4de3e4a6c568d", size = 3065765, upload-time = "2026-05-05T18:49:11.156Z" },
-    { url = "https://files.pythonhosted.org/packages/18/3b/840e0389155828e16028a0dc94db5742ab154445a7af9a0b4c421d576cd1/apsw-3.53.1.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:668010ec0751d17a6980dbe2cbe646fa8787abb5d37614745e2b260bb5bdce23", size = 3486748, upload-time = "2026-05-05T18:49:12.958Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/c0/06104cb012a9850d46053e0fc32e06cca4401230105c2550cab19554b80b/apsw-3.53.1.0-cp314-cp314-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:f9a3d6b911c2e502391c700005696d255c88317aa0460723689854727ec59c6d", size = 3271733, upload-time = "2026-05-05T18:49:14.894Z" },
-    { url = "https://files.pythonhosted.org/packages/c1/54/15272dfd87cfc05a2bdfb7141b7f38ca8aaac3628991a3847c31102254e1/apsw-3.53.1.0-cp314-cp314-manylinux_2_28_i686.whl", hash = "sha256:2c42b5d1e6249ea1e0d9751d2a9cf89e26466d4b2f61517f450fcf711790424d", size = 3871553, upload-time = "2026-05-05T18:49:17.574Z" },
-    { url = "https://files.pythonhosted.org/packages/22/90/e6515ff917ad2c6a6ce9e738f5322023c9e3a26b0be75ab4edecda4094c8/apsw-3.53.1.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:9e60a0806171dacd69c85b28db6712c502f08b6b7ae679395127fe8b664170c8", size = 3641685, upload-time = "2026-05-05T18:49:19.648Z" },
-    { url = "https://files.pythonhosted.org/packages/48/7d/75c34344c7440bfaf05e649e8fac4d6aab883efea2807f4193c4daa4175e/apsw-3.53.1.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:60b41d360dcad2238b13f89bc84c4d226d9a0e7062414c65b0095af311fc71f3", size = 3489852, upload-time = "2026-05-05T18:49:21.922Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/da/467afc2fddc7244410dbce70f0dd0d83ebceeb79e37fa4f7a4d2ba04ed6a/apsw-3.53.1.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:400a3d2ef918aca7970bca7d68b8cc0a8854a1c2c689cc0790f1bb0ae8fcdf17", size = 3279539, upload-time = "2026-05-05T18:49:23.757Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/62/9559cac2112cc9fee73d39f8cc10152a6dbbc23cd4c61ed16282abf98493/apsw-3.53.1.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:bf2c428b0f33a0458dfd952c818fe09330152439f44994ffd3bb9c73b819462d", size = 3889124, upload-time = "2026-05-05T18:49:25.659Z" },
-    { url = "https://files.pythonhosted.org/packages/79/dc/d79de5565b8c4c3787d30878a436c56e7ea082c3034367b517ab87f2b1b9/apsw-3.53.1.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:db1636427f24f4cfbffeb616ccb3689bb9b7af029a92c50e565f43755a5ba20b", size = 3650776, upload-time = "2026-05-05T18:49:27.359Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/6e/faccb565607146d0aee0635a32a2ee72e83fdd750810db3d836b8c6cb82e/apsw-3.53.1.0-cp314-cp314-win32.whl", hash = "sha256:31c7c293cb426a22f2e045d5a3b1bdedb1c87808175d46982a80068171287c18", size = 2977195, upload-time = "2026-05-05T18:49:29.275Z" },
-    { url = "https://files.pythonhosted.org/packages/38/db/9dfa71127bac4fee50c0e91f3b71161300ec41294974b32c05358b5569a9/apsw-3.53.1.0-cp314-cp314-win_amd64.whl", hash = "sha256:5c1a18a175ee64968d2440f9ae0399accaaab3c77a4dc49331000e025c89a5d3", size = 3299067, upload-time = "2026-05-05T18:49:31.091Z" },
-    { url = "https://files.pythonhosted.org/packages/f6/89/15b2310eec1c08bc54226e5d8095ce2455046e11509b024973f13a850902/apsw-3.53.1.0-cp314-cp314-win_arm64.whl", hash = "sha256:4715e6bf3f93bdefc2ad07859757ca7a9cf04b654ed5d5531f177de903405eda", size = 2948915, upload-time = "2026-05-05T18:49:33.099Z" },
-    { url = "https://files.pythonhosted.org/packages/88/a1/cba969fc5b9a94c95ac2a94b9ad048816f575e2974eac61f0f60d28bf618/apsw-3.53.1.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:e6bb77d3a0abf3f4e6e967da48cd891d53dc3749c523751ef042b3c81269a1f2", size = 3281983, upload-time = "2026-05-05T18:49:34.959Z" },
-    { url = "https://files.pythonhosted.org/packages/3c/06/29c595b70fea64a1ef846360d63c7dc546f63979dd214bfe14d07925f1d8/apsw-3.53.1.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:26af656a6bf4a45cb60d75550d7bae25d4d22940b9ecc9973a3bcc5f5c53b159", size = 3075203, upload-time = "2026-05-05T18:49:36.759Z" },
-    { url = "https://files.pythonhosted.org/packages/8c/fc/11e42e77b2797c8cfc95cfa0c975dd2f473b81ee856627b8dba47bc5deab/apsw-3.53.1.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:92501b0633d683554393f3e422692aaa22ebdd221424e3349edb97ede291c0a2", size = 3462395, upload-time = "2026-05-05T18:49:38.646Z" },
-    { url = "https://files.pythonhosted.org/packages/ef/cf/5dc6d0f34cb51293655ee28926e4a7eb3a51696d286e6f0da9faeda823a5/apsw-3.53.1.0-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:22ac2ed00e42b94918b484f4d29b8d39eb3c09c376b6d8e2ecc43828b23b68c3", size = 3251985, upload-time = "2026-05-05T18:49:40.465Z" },
-    { url = "https://files.pythonhosted.org/packages/b2/a6/817e0433f497743b2e82d868e128003bd76c8b7ed3fbe0522b5332e8d4f4/apsw-3.53.1.0-cp314-cp314t-manylinux_2_28_i686.whl", hash = "sha256:6658020f966995e7f9e87384f84e1e7785804609c9080df8a66d0e1723d3836e", size = 3843056, upload-time = "2026-05-05T18:49:42.435Z" },
-    { url = "https://files.pythonhosted.org/packages/cc/0f/4c3f0178a0ec419c0568808e0c3ce172d032aa6df1bb9adee74fee132356/apsw-3.53.1.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:39ef0857da46c1827e35f9d49bd5b548a21894409d4fa072667a333c542faf4f", size = 3618201, upload-time = "2026-05-05T18:49:44.382Z" },
-    { url = "https://files.pythonhosted.org/packages/ee/76/6565a97ae2e800935716d7b1eb884a2b9bf7fbc6222d65ecff03da0df666/apsw-3.53.1.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5b026bc42008622a115cf8c235c9f9c96363d52e6ea0914633659265a639fe1c", size = 3465453, upload-time = "2026-05-05T18:49:46.186Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/00/d68a27a17ffb991ffbd739d86526b562a86cd5e97f953adbe8005ad392b0/apsw-3.53.1.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:6166755e34d11b2e51926cc1c749ad7a66596dbc0376c312fe5f843ca8f8650b", size = 3256806, upload-time = "2026-05-05T18:49:48.099Z" },
-    { url = "https://files.pythonhosted.org/packages/05/c2/9931e56ba32b80cb0f28f33af85cbe413dd504bbf14f7845bf39fa4d4eb0/apsw-3.53.1.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:bce33072929b57c72812d7ecf8517e82d3d38524ee556f59282270ecbf33b942", size = 3860492, upload-time = "2026-05-05T18:49:49.905Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/d2/66ad79db6ad6e941649972c5814d569bf5c86830ff844b24f7577a9b0959/apsw-3.53.1.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:1248e3e432aa7a5461be32d2313732f0590c6fa6cba24abf223a061a03b17983", size = 3627536, upload-time = "2026-05-05T18:49:51.794Z" },
-    { url = "https://files.pythonhosted.org/packages/87/40/be8f8166b3b8c58ff57c6aa4d62e8422524e072d0607eadc84f6feee62da/apsw-3.53.1.0-cp314-cp314t-win32.whl", hash = "sha256:adc9d3196a764b6413e33209845c170315670fa86a31cac4bcd9c9fe9a20aa0b", size = 2989839, upload-time = "2026-05-05T18:49:53.934Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/48/ea8b2cef1c32d8bd0d4978bcefe31ff669fc4248fba4530bf13a3d4f561f/apsw-3.53.1.0-cp314-cp314t-win_amd64.whl", hash = "sha256:5ffce724a757c0b57210c1189c033cc264a8be8b45335a694839f6918c71a842", size = 3315024, upload-time = "2026-05-05T18:49:55.731Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/5c/fac06fc153fb1634651e4fbed5a9343d0415a72920b5bb3c8c0f7422eb47/apsw-3.53.1.0-cp314-cp314t-win_arm64.whl", hash = "sha256:bbabe95cc743ae70cc20d5675d35f84d7612a2e9d13c6894404410518c350269", size = 2951484, upload-time = "2026-05-05T18:49:58.051Z" },
+version = "3.53.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/df/8e/6db1f1b21e461bb77b455bc20ff8ab5fb9642ff8370338743dd812483f8d/apsw-3.53.2.0.tar.gz", hash = "sha256:5c59bde36e20a33c0a0399bfe4021f2cd6fc049ac1b15d58f0dc25b48ed1d87f", size = 1242392, upload-time = "2026-06-04T22:09:21.886Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9f/6e/bef995245fc48ac653c1dd12950e888571c426113caa327c705785c472fb/apsw-3.53.2.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:2f9661e54199c06fe69d5b0169338e4ca7699a837fa7ea764c678570a3a05627", size = 3272016, upload-time = "2026-06-04T22:07:55.036Z" },
+    { url = "https://files.pythonhosted.org/packages/03/e8/3e6b4b11247a3c598f1cfb3d58b6bebbf75afbee828374eaec568d46a02e/apsw-3.53.2.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:b9f3674889cf74e10da4db24f69d1f091d73ab35dd59655e71b4041e8fd3e90f", size = 3067363, upload-time = "2026-06-04T22:07:56.467Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/f9/efed37d9adde90ad3c4fbc4c820e1c11da2552c8c1aa6169f29fd347d42d/apsw-3.53.2.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:3b9136c4625c2d060a6c1a566ad730bbf903c768c5dd5561016b4811c34e85ea", size = 3481500, upload-time = "2026-06-04T22:07:57.839Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/80/b9b37868f2cd2892b667b4c4add2b6f0f1615e437897b440ea01db0c4937/apsw-3.53.2.0-cp312-cp312-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:13f69e65fcd185adf44a6b8133209c5a4de58bc8cb65a94796d293279e237d82", size = 3267137, upload-time = "2026-06-04T22:07:59.316Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/54/6ed3e9b982348dc9c6b34e73a5ab1c9ecf1089a6aea3d14e0b5ba34cd8d6/apsw-3.53.2.0-cp312-cp312-manylinux_2_28_i686.whl", hash = "sha256:e019e03b6745da1f7b1d854f3ea92164f0862e69c9fd42c236005c8083df41cc", size = 3874092, upload-time = "2026-06-04T22:08:00.823Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/eb/6febeb9bf282119e327ed4382d0afc990e4c4e6998be74262b8411ab2ee6/apsw-3.53.2.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:73163b53467433cd68e7cb7bee65b55fab63f6744be1653171c276fdc68c874c", size = 3640547, upload-time = "2026-06-04T22:08:02.245Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/6c/5921524bf30b26ed4c707d52f22fa00d2055fd7d296bc5c47363c845c7c9/apsw-3.53.2.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:78ebb133079c060f614209b6313543850b1ff0b1729841a79b1e98d25366c265", size = 3489086, upload-time = "2026-06-04T22:08:04.299Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/54/4ea1369f909bc1103659ba1169de1525b6e1fed8e336518afcc4e9dafd1e/apsw-3.53.2.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:72c83f1a52cdf7bea471007e97625b99873149a9f45be700c5cf0f31e6816aa7", size = 3276012, upload-time = "2026-06-04T22:08:05.962Z" },
+    { url = "https://files.pythonhosted.org/packages/43/6c/d652c23db7c509bd513f70e9db46c1f5b3b2a89fe836bf4bf1dbc38882fd/apsw-3.53.2.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:2aa9f2740b21940e230db86feb7959dbbb240f556070918936592d7b6d7516b8", size = 3892828, upload-time = "2026-06-04T22:08:07.525Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/f7/494232eb3e80bedef3f5868248bc301ae1b6f598d923b6746f24a6d47266/apsw-3.53.2.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:8129988659b85e00ecbc27754cb8b0830f51c13d53ce601dbb421bbba5dc81e7", size = 3646562, upload-time = "2026-06-04T22:08:09.362Z" },
+    { url = "https://files.pythonhosted.org/packages/74/ed/5543b43eddae532622418e612b874d0a3d6edac73e622692f59822a4289c/apsw-3.53.2.0-cp312-cp312-win32.whl", hash = "sha256:4c5851d2c4dd1ad6e6979703e2f8ed0f532360e241078a7424085beb5202ea76", size = 2904918, upload-time = "2026-06-04T22:08:10.946Z" },
+    { url = "https://files.pythonhosted.org/packages/25/fb/a7fab980d4eb31a1ce4d2a855fb3aac8d46466337b1113203eca8024f193/apsw-3.53.2.0-cp312-cp312-win_amd64.whl", hash = "sha256:a3c3d8a257b830b72b0e178784611b19c3e0c910236ccb77475726f367958427", size = 3220526, upload-time = "2026-06-04T22:08:12.432Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/63/f8518c71e51edcf3236818d4a4aae17190a22ba43f9989ee9f7f78bc6e28/apsw-3.53.2.0-cp312-cp312-win_arm64.whl", hash = "sha256:ca708d0d79c3b970fabe4f2ab1511af60d7a7d6576bb8848f8111c9e0ec1cdaf", size = 2870535, upload-time = "2026-06-04T22:08:13.924Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/5b/2a1625f300a15820c2a30aad6c157b1d74269e6b777a5907c955217eed46/apsw-3.53.2.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:38b9fe5e06a985765e45a0f7986d115756939e4186c0c6aaf5089903d1904a44", size = 3269255, upload-time = "2026-06-04T22:08:15.433Z" },
+    { url = "https://files.pythonhosted.org/packages/49/41/132fd87b6d8667cd91f74bc6705c35fa4478ccb82175ec2336a000eb0332/apsw-3.53.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45b8d428f2ede3863620c73d5bec8f56f72b0f901280164dce1eef38548cdaa1", size = 3065187, upload-time = "2026-06-04T22:08:18.097Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/87/6e840fa23c6984dba8c5eccc86b1acf8dd7006ea0004225480e08146316a/apsw-3.53.2.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:b01d57e3a5f110d2ec7a93d7c5e0099874dde72425aedd7a3f6850d130128f54", size = 3481382, upload-time = "2026-06-04T22:08:19.866Z" },
+    { url = "https://files.pythonhosted.org/packages/93/e3/53cde467ffc33d124f98cd67ba48f08b0c1b79e8c9fbae194ac29fe82c67/apsw-3.53.2.0-cp313-cp313-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:5a188b67cb8c21bbd3376084fb769bc7247f37502f2b292a1e30295e80241d53", size = 3270241, upload-time = "2026-06-04T22:08:21.311Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/0f/7c734603ac19c7c750d910ffc8f995e0d9d9408ba25768e420b09ca200cb/apsw-3.53.2.0-cp313-cp313-manylinux_2_28_i686.whl", hash = "sha256:722229abe220bbda1da1a6cb2058c85890a4458a832fbfd8db9c0162dbebdcb7", size = 3869738, upload-time = "2026-06-04T22:08:22.831Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/3e/2ff08df5db380b111bcd7ff7cddc5516f24a84769570b6951e35c8a4f636/apsw-3.53.2.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:0efdad2f84c669ef940ef4bd0cb39dc08d07f67ff94987ce42eccc3479790ee3", size = 3639825, upload-time = "2026-06-04T22:08:24.291Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/5a/78f6e1bdeebfedac8bf63e60d1509eedce2e3c2d1a3bddfa032cfc4197ae/apsw-3.53.2.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6c45bc518e81826e7d3c7a3902e6bd9c28964673b417dd240b3790cb941b5f52", size = 3487448, upload-time = "2026-06-04T22:08:25.813Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/24/36ece077cb090acaab801552ead0b8771b9393b1679f616fcb8f171fb522/apsw-3.53.2.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:dc8d4e6474b033718d427990ff85f8dbdda80bce328bff7e0056a88211b0f998", size = 3277822, upload-time = "2026-06-04T22:08:27.436Z" },
+    { url = "https://files.pythonhosted.org/packages/37/99/4c6c25ec83489fc4e59d5283b68c45ad19140384cf765e7b5c4e8e829f4b/apsw-3.53.2.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:bd546e3a436782ed61f30a91a1397cb2c8a04b408780d95ec17dff22f278ec34", size = 3887507, upload-time = "2026-06-04T22:08:29.228Z" },
+    { url = "https://files.pythonhosted.org/packages/21/4d/bda72f52ee9f524f8cfbb59de2c2d81e2fba699b273a69f45e8167928ce4/apsw-3.53.2.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:f0981ec85bf39ec5c8b3647463c5f0a46a6b0769e230564f27744fc07f50c191", size = 3645822, upload-time = "2026-06-04T22:08:30.8Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/20/fef0eafec420cd661ff9b7c1593a864fad2f4260f7feeed76c01a94cd396/apsw-3.53.2.0-cp313-cp313-win32.whl", hash = "sha256:2b1ea7d48a6778cace2d83ed3918c6e6ede87e48b5522c163ed85ff7c735568d", size = 2903951, upload-time = "2026-06-04T22:08:33.07Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/f9/547270cfa6f1a15aba3c6a053e4428bf9eb7e6157fd2b4f1023b8a38d255/apsw-3.53.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:e78b9e3f6d9ec739c6997d43f245f19669994d372d72f9e7b941240ff7f3a452", size = 3219378, upload-time = "2026-06-04T22:08:34.688Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/e3/248faea7c4915017d1036967c4ba51e793c163a0be9816d3fa7530f5f56e/apsw-3.53.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:852402b11a0873deb2cbe34d54a79344200ebe8569547b8014b8640d4070efbe", size = 2869623, upload-time = "2026-06-04T22:08:36.562Z" },
+    { url = "https://files.pythonhosted.org/packages/58/e0/037289244bd0193db0f2464ebeb74174330f9d42b912e1b0c8a256d11836/apsw-3.53.2.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:93e724281df13e9b75245bbe7b57edd43d813f988d422fc8196283ee4da13f96", size = 3273298, upload-time = "2026-06-04T22:08:38.243Z" },
+    { url = "https://files.pythonhosted.org/packages/82/31/4cc170ade6774a2969c84ffe365e0db2d0b10f4a2b93b42e10d1cd0b40b7/apsw-3.53.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:47dbc9f868cc6798fbf82aaa1bf28c35d009e570a78b1867587cce4faafd73ae", size = 3065423, upload-time = "2026-06-04T22:08:39.988Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/19/53c56c489fe226936202281e7af0a9940777081e89ce2bd817106fba33fd/apsw-3.53.2.0-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:d69c5f73cd17ff5aa4f5417e90f2c9865b638eb610999d56ec7a490b6ccf58fc", size = 3482226, upload-time = "2026-06-04T22:08:41.633Z" },
+    { url = "https://files.pythonhosted.org/packages/df/dd/a3faa32893a9031316d02f3d85307e644b8a06f53dc3fb237b81e8c570cb/apsw-3.53.2.0-cp314-cp314-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:951553b94ad33a92f797d9d7c4930797b6be5da7504b790453f5c883372a15b6", size = 3268910, upload-time = "2026-06-04T22:08:43.331Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/c1/3762f40829c6e3a12dda099e5cb621cb30b37052e4fe8744616572611a3d/apsw-3.53.2.0-cp314-cp314-manylinux_2_28_i686.whl", hash = "sha256:4309a3cc957cc4baa9b4a775e0ca359bbaf084cbc443fbbc9a8c1e169fb95b57", size = 3870003, upload-time = "2026-06-04T22:08:44.885Z" },
+    { url = "https://files.pythonhosted.org/packages/33/25/5dee50e279e8e0e9be97ca5a7717bcd9289f4fb27aaf70595dc83cf82a10/apsw-3.53.2.0-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:16e457d1fbdb2358791de55eb4bd5518c3f7b2d434322056dc9089503be5bba2", size = 3640426, upload-time = "2026-06-04T22:08:46.329Z" },
+    { url = "https://files.pythonhosted.org/packages/45/65/8a7f4b11858de6f5ccb1f1fbcbf211c7050ce3b5eb763e9b81e5fd47a5d0/apsw-3.53.2.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0f758403843ec59b5f855b67c882859fde2fc42d5f226c5583f1aff79bef92d4", size = 3488248, upload-time = "2026-06-04T22:08:48.089Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9a/00a529e5c8bf5b8620d7ea249ca3172f22648b48804ec545b7e09ca8a6cc/apsw-3.53.2.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:32bb9e0437f6f42127954ec015661aa6168312f65a14c54411b441a6a1ff7fa9", size = 3276281, upload-time = "2026-06-04T22:08:49.858Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/77/6bae1bbce9f904c524b9e7eefb761e822c3f90f35d77cdf97a534f9219d4/apsw-3.53.2.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:2cc3037ce66fa2b0a412ea9e835ce299ad8e90bd62c12ced30fbd7b6e36dae54", size = 3887532, upload-time = "2026-06-04T22:08:51.546Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/e3/0a07f04180a16618453b6dc830c1676cd29675d2543a6854538dabb14d2f/apsw-3.53.2.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:cbe7c0674f0d01ab2c053b7c51bb313e22453dde676e7ecb7b000cd15da5a9c3", size = 3645972, upload-time = "2026-06-04T22:08:53.186Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/25/54071dbf630651bcd0458ff12337aacd76001aa93053c0ede64bbe401ad2/apsw-3.53.2.0-cp314-cp314-win32.whl", hash = "sha256:6bd831376552028524b67ca5a82a75d48fee3d12a97dafc28f4657b5c7fe61d7", size = 2971678, upload-time = "2026-06-04T22:08:54.778Z" },
+    { url = "https://files.pythonhosted.org/packages/66/d3/2511136b4fe0a8b9f9f27ba80eb4c6cc8d4262a2fa44985c8ba42bd9ee43/apsw-3.53.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:3b8fd7c8dd031cea029ff0e14872f4653fd11866c4890895916308316db3ce84", size = 3298275, upload-time = "2026-06-04T22:08:56.331Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/35/2a28b23ca8bd886b8599e269111ae1bf8070c9cf84512b8201f004551686/apsw-3.53.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:83ad743297e3b4f76343d4a0ed3ff9880d6f4009a0a0803a0a1e6203d548d71e", size = 2943411, upload-time = "2026-06-04T22:08:58.203Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/f4/cf4b6eb59171809063f59700bd1a78a1143dcc29e756ce8f420d449ba349/apsw-3.53.2.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:ef24cb8ff8099647528c6b38aca1003439d99c5ad8b288886f74ab323b5d1411", size = 3281514, upload-time = "2026-06-04T22:08:59.836Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/06/8fab296bdbd57d3aeb716acf6dc3b0f7920998042d62701f4eb856a0412b/apsw-3.53.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:422f7bd7bb847fc0199137671c82cd0f6d91b29bb27a9c91099e952a9e13dbad", size = 3076785, upload-time = "2026-06-04T22:09:01.712Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/69/09ceafb924b5f23f6559da7a2bb2326ca4af214f86e725485c1136e71043/apsw-3.53.2.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:2d3894121e09a13a89704efebc195756486bfa3cde75a9b3d77b7ae85b59a4d6", size = 3456082, upload-time = "2026-06-04T22:09:03.18Z" },
+    { url = "https://files.pythonhosted.org/packages/09/8c/e77bd8850fd8654dd01a5bb74b734418d2115d1bb61c2e4ced1719d60029/apsw-3.53.2.0-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7449e74aa39210492473507070722255641ce75df4057a6d27cc2a087358a813", size = 3248645, upload-time = "2026-06-04T22:09:04.845Z" },
+    { url = "https://files.pythonhosted.org/packages/23/49/a6d663791db4cebdd07da76efbb886f6275d4c7312e02538e76f18c04d04/apsw-3.53.2.0-cp314-cp314t-manylinux_2_28_i686.whl", hash = "sha256:68790d967d8af7010dd3b815df81f443ebe8fc63c8f60ac767cc822d92db8402", size = 3837908, upload-time = "2026-06-04T22:09:06.679Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/41/1b931de12f2ca2b216ff681db671e4f8d92dc3b13be9a6c9d5524398b9d6/apsw-3.53.2.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:7264a55582bd176bd9901ba02ade5f5e618fd1d9c334dcefc041c185f8331eeb", size = 3614087, upload-time = "2026-06-04T22:09:08.497Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/31/43f6f504e5c23ea8d18862c1b5b6ea9985abf9879bdb1c5b5d832d1029f4/apsw-3.53.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:750665199fe6efc39f5b50c872de1cabb68ee61ba75844fd9dbc455c333b6e31", size = 3461514, upload-time = "2026-06-04T22:09:10.033Z" },
+    { url = "https://files.pythonhosted.org/packages/33/9a/fd6a5c67b876b90bdf4ee781caeeb145ccf67d6cc8aae2e62b9cdf046e3a/apsw-3.53.2.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:e3a2f5e8bd34ad3676f2d9a99a3652b816869d81743119ba92e04d717cda2e68", size = 3254505, upload-time = "2026-06-04T22:09:11.631Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/fa/a2bc21bdbc9f6e02f3afd16f6b099b34aaf9084614b392d1c0688b59c89f/apsw-3.53.2.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:fb3d6459f773ff853d897220c10b21d41fbf23cbdcfc26d486c3e1c3c0aaa11e", size = 3856800, upload-time = "2026-06-04T22:09:13.479Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/7b/c623f85f71ab3a6644517fdcf1ac948284aebc51730126f65af4a2871a32/apsw-3.53.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:135870e8720c2188976cccb0194954ec7bf82a4bae4a0a563fed47d05982b2c5", size = 3623113, upload-time = "2026-06-04T22:09:15.205Z" },
+    { url = "https://files.pythonhosted.org/packages/51/49/7f0432542e6ffba14dfddba8725eff17ef8fac36e21824d1efe030694be0/apsw-3.53.2.0-cp314-cp314t-win32.whl", hash = "sha256:66fa0a440801e999ca6436def12fd6f36b8da0729552efc10579ded3209f7e4a", size = 2985253, upload-time = "2026-06-04T22:09:16.6Z" },
+    { url = "https://files.pythonhosted.org/packages/98/4f/5e25a774f6eca5524df7f410de2bfd15a11c950edc1910c80d03fbadbc25/apsw-3.53.2.0-cp314-cp314t-win_amd64.whl", hash = "sha256:3200500d55831182fa354cb5db3ff2eeef5cb5107cf8b707d6bfaa7fde9e41f3", size = 3314505, upload-time = "2026-06-04T22:09:18.34Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/d8/36d4583a51f99325f30be924af865998ee507bf7329bcf577eca5ab7e33b/apsw-3.53.2.0-cp314-cp314t-win_arm64.whl", hash = "sha256:549d3935245ae9b17dab73ed7b0192dc5ef9932aba196d0715a0e1eb2cb093d3", size = 2946179, upload-time = "2026-06-04T22:09:19.861Z" },
 ]
 
 [[package]]
@@ -378,6 +378,7 @@ dependencies = [
     { name = "python-fasthtml" },
     { name = "python-telegram-bot" },
     { name = "requests" },
+    { name = "slack-bolt" },
     { name = "uvicorn", extra = ["standard"] },
 ]
 
@@ -399,6 +400,7 @@ requires-dist = [
     { name = "python-fasthtml", specifier = ">=0.14.2" },
     { name = "python-telegram-bot", specifier = ">=22.7" },
     { name = "requests", specifier = ">=2.32.5" },
+    { name = "slack-bolt", specifier = ">=1.18.0" },
     { name = "uvicorn", extras = ["standard"], specifier = ">=0.48.0" },
 ]
 
@@ -1293,11 +1295,11 @@ wheels = [
 
 [[package]]
 name = "python-multipart"
-version = "0.0.30"
+version = "0.0.32"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/4b/82/c8cd43a6e0719bf5a3b034f6726dd701f75829c08944c83d4b95d02ed0e8/python_multipart-0.0.30.tar.gz", hash = "sha256:0edfe0475c1f46ddd3ff7785a626f6118af32bdcf359bb21260367313bb32118", size = 46316, upload-time = "2026-05-31T19:24:55.198Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5b/42/55c32bb9b12693c092ad250a0e82edb5b31ddeda6eb772de5f308b3804ad/python_multipart-0.0.32.tar.gz", hash = "sha256:be54b7f3fa167bb83e4fcd936b887b708f4e57fe75911c02aebf53efaf8d938e", size = 46881, upload-time = "2026-06-04T16:18:58.647Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1c/fd/0318007beb234790993d3ec5afd051d1dbceb733e81e3afe2b981ece3f37/python_multipart-0.0.30-py3-none-any.whl", hash = "sha256:830964def8c90607ac5daa00514e3987815865713ade8d20febc9177ac0c3c5b", size = 29730, upload-time = "2026-05-31T19:24:53.814Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/04/e8135ebd1ad02c56ec633277529b2602ff99ff634be76cdba5744cf554fd/python_multipart-0.0.32-py3-none-any.whl", hash = "sha256:ff6d3f776f16878c894e52e107296ffc890e913c611b1a4ec6c44e2821fe2e23", size = 30042, upload-time = "2026-06-04T16:18:57.319Z" },
 ]
 
 [[package]]
@@ -1420,6 +1422,27 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
 ]
 
+[[package]]
+name = "slack-bolt"
+version = "1.28.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "slack-sdk" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5c/97/a62dde97e84027b252807f2044bed2edcda2d063a5cb0c535fb2be8d9b5d/slack_bolt-1.28.0.tar.gz", hash = "sha256:bfe367d867e8fb157a057248ebd4ac2d7f43acac6d0700fa31381db1e10f3b0f", size = 130768, upload-time = "2026-04-06T23:24:59.936Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/a9/697b6a92c728f09d5ef6b8e83dc6c8a87bc6d59499b2933ed067f11b7e30/slack_bolt-1.28.0-py2.py3-none-any.whl", hash = "sha256:738d1ca5e7c7039b6e18103d29267ced6e18c2517053eff18991fdd593acce5c", size = 234819, upload-time = "2026-04-06T23:24:58.278Z" },
+]
+
+[[package]]
+name = "slack-sdk"
+version = "3.42.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0e/00/16258bfa547559b2c936b50c882b4f0a36ebf6b69639eb763d8fa5e8d6cb/slack_sdk-3.42.0.tar.gz", hash = "sha256:873db9e1f632ac650ffdbf9d8ba825f3e9e7e576a1e4f9604ccb2a15b3727e3d", size = 252136, upload-time = "2026-05-18T17:50:44.727Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ce/ef/8a1556bd4843443993fc116783790a7cc553601a37f7d965ec26eef95e76/slack_sdk-3.42.0-py2.py3-none-any.whl", hash = "sha256:eb39aff97e476e10cc5a8ac29bd2e79a9959e880d9fe0c03b4e8f05b2ac996ff", size = 315469, upload-time = "2026-05-18T17:50:41.972Z" },
+]
+
 [[package]]
 name = "sniffio"
 version = "1.3.1"
@@ -1495,15 +1518,15 @@ wheels = [
 
 [[package]]
 name = "uvicorn"
-version = "0.48.0"
+version = "0.49.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/e6/bf/f6544ba992ddb9a6077343a576f9844f7f8f06ab819aefd00206e9255f18/uvicorn-0.48.0.tar.gz", hash = "sha256:a5504207195d08c2511bf9125ede5ac4a4b71725d519e758d01dcf0bc2d31c37", size = 91074, upload-time = "2026-05-24T12:08:41.925Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c4/1f/fa18009dea8469069cca78a4e877a008ab78f08b064bfc9ab891579077ff/uvicorn-0.49.0.tar.gz", hash = "sha256:ebf4271aa580d9de97f93192d4595176df6e91f9aae919ca73e4fc07df1e66a3", size = 91284, upload-time = "2026-06-03T22:01:30.448Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/01/be/72532be3da7acc5fdfbccdb95215cd04f995a0886532a5b423f929cda4cc/uvicorn-0.48.0-py3-none-any.whl", hash = "sha256:48097851328b87ec36117d3d575234519eb58c2b22d79666e9bbc6c49a761dad", size = 71410, upload-time = "2026-05-24T12:08:40.258Z" },
+    { url = "https://files.pythonhosted.org/packages/88/fa/e1388bbcf24ef3274f45c0c1c7b501fd14971037c1b6ee23610553307497/uvicorn-0.49.0-py3-none-any.whl", hash = "sha256:ba3d14c3ee7e41c6c654c46c9eb489d33213cdd30aa1696eab1374337c13f68f", size = 71376, upload-time = "2026-06-03T22:01:29.037Z" },
 ]
 
 [package.optional-dependencies]

From ce9039bbc2c727d3336f951d02678b4100167bbb Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 30 May 2026 00:57:20 +0000
Subject: [PATCH 2/7] Address PR review: fix subtype filtering, error handler,
 docs, dead code
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Remove dead _bot_user_id field
- Only filter system subtypes (message_changed/deleted, join/leave, etc.)
  instead of all subtypes — allows file_share, me_message, thread_broadcast
- Register a slack_bolt-compatible error handler via app.error()
- Update README: add Slack to feature list, config, Docker section, env table
- Update Dockerfile: add SLACK_ALLOW_FROM env default and usage comments
- Remove Slack from roadmap (shipped)

https://claude.ai/code/session_01Fa64TcstSLyfugG93cjYR2
---
 Dockerfile                  |  4 ++++
 README.md                   | 30 ++++++++++++++++++++++++++----
 app/channels/slack.py       | 21 ++++++++++++++++++---
 tests/test_slack_channel.py | 21 +++++++++++++++++----
 4 files changed, 65 insertions(+), 11 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index f0baaab..b51f8a9 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -33,6 +33,7 @@ ENV LLM_BASE_URL=""
 ENV MODEL=""
 ENV TELEGRAM_ALLOW_FROM=""
 ENV DISCORD_ALLOW_FROM=""
+ENV SLACK_ALLOW_FROM=""
 ENV TZ=UTC
 
 # Web channel — bind to all interfaces inside the container so Docker
@@ -46,6 +47,9 @@ ENV WEBSOCKET_PORT=8765
 #  -e LLM_API_KEY=sk-... \
 #  -e DISCORD_BOT_TOKEN=your-discord-token \
 #  -e DISCORD_ALLOW_FROM=123456789 \
+#  -e SLACK_BOT_TOKEN=xoxb-... \
+#  -e SLACK_APP_TOKEN=xapp-... \
+#  -e SLACK_ALLOW_FROM=U123456789 \
 #  -p 8765:8765 \
 #  -v ./anotherbot-data:/data \
 #   or: docker run --env-file .env
diff --git a/README.md b/README.md
index 95c8776..56f8a68 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,7 @@ A Python-based AI agent that can execute prompts, interact with the filesystem,
 - **Web UI**: Browser-based chat interface served by FastHTML + uvicorn — dark/light theme, collapsible conversation sidebar, full conversation history
 - **Telegram Integration**: Built-in Telegram bot — receive messages, respond, run tools, deliver results
 - **Discord Integration**: Discord bot — same agent loop, per-channel message isolation, owner DM fallback for scheduled tasks
+- **Slack Integration**: Slack bot via Socket Mode — no public webhook required
 - **Scheduled Tasks**: SQLite-backed task scheduler — run prompts on a recurring or one-shot schedule and deliver results to a channel
 - **Tool Calling**: File I/O, shell commands, web fetch, web search (text/images/video/news/books), calculator, Hacker News, todo list
 - **Skills System**: Extendable skills in `app/skills/` (e.g., `puppeteer` for headless browsing)
@@ -57,6 +58,11 @@ ALLOW_FROM = []  # List of allowed Discord user IDs (integers). Empty means allo
 [websocket]
 HOST = "127.0.0.1"   # use 0.0.0.0 to expose on all interfaces (required for Docker)
 PORT = 8765
+
+[slack]
+BOT_TOKEN = ""   # xoxb-... bot token
+APP_TOKEN = ""   # xapp-... app-level token (required for Socket Mode)
+ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty means allow all.
 ```
 
 Message history is stored in `~/.crafterscode/history.db` (SQLite). Each channel maintains its own history with estimated token counts per message.
@@ -105,9 +111,9 @@ Then open `http://localhost:8765/` in a browser.
 - `/help`, `/status`, `/whoami`, `/stop` answered instantly without an LLM call
 - All other slash commands (`/model`, `/load`, `/fork`, `/rename`, `/export`) forwarded to the agent
 
-### Background Agent (Telegram / Discord)
+### Background Agent (Telegram / Discord / Slack)
 
-Configure one or both channels in `~/.crafterscode/config.toml`:
+Configure one or more channels in `~/.crafterscode/config.toml`:
 
 ```toml
 [telegram]
@@ -117,6 +123,11 @@ ALLOW_FROM = [123456789]  # restrict by user ID; empty = allow all
 [discord]
 TOKEN = "your-discord-bot-token"
 ALLOW_FROM = []  # restrict by user ID; empty = allow all
+
+[slack]
+BOT_TOKEN = "xoxb-..."   # bot token from Slack app settings
+APP_TOKEN = "xapp-..."   # app-level token with connections:write scope
+ALLOW_FROM = []          # restrict by Slack user ID; empty = allow all
 ```
 
 ```bash
@@ -198,6 +209,15 @@ docker run -d \
   -e DISCORD_ALLOW_FROM=123456789 \
   -v anotherbot-data:/data \
   anotherbot
+
+# Slack
+docker run -d \
+  -e LLM_API_KEY=sk-... \
+  -e SLACK_BOT_TOKEN=xoxb-... \
+  -e SLACK_APP_TOKEN=xapp-... \
+  -e SLACK_ALLOW_FROM=U123456789 \
+  -v anotherbot-data:/data \
+  anotherbot
 ```
 
 ### Run — all channels at once
@@ -233,11 +253,14 @@ docker run -d \
 | `TELEGRAM_ALLOW_FROM` | — | Comma-separated Telegram user IDs (empty = allow all) |
 | `DISCORD_BOT_TOKEN` | — | Discord bot token from developer portal |
 | `DISCORD_ALLOW_FROM` | — | Comma-separated Discord user IDs (empty = allow all) |
+| `SLACK_BOT_TOKEN` | — | Slack bot token (`xoxb-...`) from app settings |
+| `SLACK_APP_TOKEN` | — | Slack app-level token (`xapp-...`) with `connections:write` scope |
+| `SLACK_ALLOW_FROM` | — | Comma-separated Slack user IDs (empty = allow all) |
 | `LLM_BASE_URL` | no | API base URL (default: `https://openrouter.ai/api/v1`) |
 | `MODEL` | no | Model string (default: `deepseek/deepseek-v3.2`) |
 | `ANOTHERBOT_HOME` | no | Data directory for DB and workspace (default: `/data` in container) |
 
-At least one channel (`WEBSOCKET_HOST`, `TELEGRAM_BOT_TOKEN`, or `DISCORD_BOT_TOKEN`) must be set or the server will exit.
+At least one channel (`WEBSOCKET_HOST`, `TELEGRAM_BOT_TOKEN`, `DISCORD_BOT_TOKEN`, or `SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN`) must be set or the server will exit.
 
 The `/data` volume persists the SQLite database and workspace across restarts. To supply a `config.toml` instead of env vars, mount it at `/data/config.toml` — env vars always take precedence over the file.
 
@@ -245,7 +268,6 @@ The `/data` volume persists the SQLite database and workspace across restarts. T
 
 - **Email Support**: IMAP/SMTP integration for reading and sending emails, attachment handling, and mailbox management
 - **MCP Support**: Integration with Model Context Protocol for external data sources, tools, and state management
-- **Slack Integration**: Slack app with interactive messages, modals, and workspace management
 - **WhatsApp Support**: WhatsApp Business API integration via providers like Twilio or MessageBird
 - **Anthropic OAuth**: Direct integration with Claude API using OAuth 2.0
 - **Codex OAuth**: OpenAI Codex API authentication
diff --git a/app/channels/slack.py b/app/channels/slack.py
index cfb3541..b388465 100644
--- a/app/channels/slack.py
+++ b/app/channels/slack.py
@@ -13,6 +13,19 @@
 MAX_SLACK_LENGTH = 3000
 
 
+_IGNORED_SUBTYPES = {
+    "message_changed",
+    "message_deleted",
+    "channel_join",
+    "channel_leave",
+    "channel_topic",
+    "channel_purpose",
+    "channel_name",
+    "group_join",
+    "group_leave",
+}
+
+
 class SlackChannel(Channel):
     def __init__(
         self,
@@ -27,13 +40,16 @@ def __init__(
         self.mq = mq
         self.stopped = False
         self._last_channel_id: str | None = None
-        self._bot_user_id: str | None = None
         self.app = AsyncApp(token=bot_token)
         mq.register(self, self.send_message)
         self._register_handlers()
 
     def _register_handlers(self) -> None:
         self.app.event("message")(self._handle_message)
+        self.app.error(self._slack_error_handler)
+
+    async def _slack_error_handler(self, error: Exception, body: dict, logger) -> None:
+        logger.error(f"Slack error: {error}", exc_info=error)
 
     @property
     def has_stopped(self) -> bool:
@@ -51,8 +67,7 @@ def default_metadata(self) -> dict:
         return {"channel_id": self._last_channel_id} if self._last_channel_id else {}
 
     async def _handle_message(self, event: dict, say) -> None:
-        # ignore bot messages and message edits/deletes
-        if event.get("bot_id") or event.get("subtype"):
+        if event.get("bot_id") or event.get("subtype") in _IGNORED_SUBTYPES:
             return
 
         user_id = event.get("user", "")
diff --git a/tests/test_slack_channel.py b/tests/test_slack_channel.py
index 6c4a51c..f3fa174 100644
--- a/tests/test_slack_channel.py
+++ b/tests/test_slack_channel.py
@@ -86,16 +86,29 @@ async def test_handle_message_ignores_bot_messages():
 
 
 @pytest.mark.asyncio
-async def test_handle_message_ignores_subtypes():
+async def test_handle_message_ignores_edit_and_delete_subtypes():
     sc, mq = make_slack_channel()
     say = AsyncMock()
 
+    for subtype in ("message_changed", "message_deleted", "channel_join", "channel_leave"):
+        await sc._handle_message(
+            event={"user": "U123", "text": "hi", "channel": "C456", "subtype": subtype},
+            say=say,
+        )
+
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_handle_message_allows_user_subtypes():
+    sc, mq = make_slack_channel()
+
     await sc._handle_message(
-        event={"user": "U123", "text": "edited", "channel": "C456", "subtype": "message_changed"},
-        say=say,
+        event={"user": "U123", "text": "check this out", "channel": "C456", "subtype": "file_share"},
+        say=AsyncMock(),
     )
 
-    assert mq.incoming.empty()
+    assert not mq.incoming.empty()
 
 
 @pytest.mark.asyncio

From ef23be7ea55b1c8a61cd567aeee9c104e446d470 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 5 Jun 2026 01:56:31 +0000
Subject: [PATCH 3/7] Fix review comments: exc_info, empty channel guard,
 tests, cleanup

- Fix exc_info=error -> exc_info=True in _slack_error_handler (logging API)
- Guard against events with empty/missing channel_id before enqueuing
- Raise MAX_SLACK_LENGTH 3000 -> 3800 (plain text= field allows ~40k chars)
- Remove unused MagicMock import from test_slack_channel.py
- Add test for empty-channel guard
- Add Slack env var tests to test_config.py (BOT_TOKEN, APP_TOKEN, ALLOW_FROM)
- Add Slack branch tests to test_bg_server.py (happy path, missing tokens, gather coros)

https://claude.ai/code/session_01Fa64TcstSLyfugG93cjYR2
---
 app/channels/slack.py       |  7 +++-
 tests/test_bg_server.py     | 76 ++++++++++++++++++++++++++++++++++++-
 tests/test_config.py        | 39 +++++++++++++++++++
 tests/test_slack_channel.py | 14 ++++++-
 4 files changed, 132 insertions(+), 4 deletions(-)

diff --git a/app/channels/slack.py b/app/channels/slack.py
index b388465..9fd7003 100644
--- a/app/channels/slack.py
+++ b/app/channels/slack.py
@@ -10,7 +10,7 @@
 
 log = logging.getLogger(__name__)
 
-MAX_SLACK_LENGTH = 3000
+MAX_SLACK_LENGTH = 3800
 
 
 _IGNORED_SUBTYPES = {
@@ -49,7 +49,7 @@ def _register_handlers(self) -> None:
         self.app.error(self._slack_error_handler)
 
     async def _slack_error_handler(self, error: Exception, body: dict, logger) -> None:
-        logger.error(f"Slack error: {error}", exc_info=error)
+        logger.error(f"Slack error: {error}", exc_info=True)
 
     @property
     def has_stopped(self) -> bool:
@@ -81,6 +81,9 @@ async def _handle_message(self, event: dict, say) -> None:
             return
 
         channel_id = event.get("channel", "")
+        if not channel_id:
+            log.warning("Slack: ignoring message with no channel in event")
+            return
         metadata = {"channel_id": channel_id}
 
         if content.startswith("/"):
diff --git a/tests/test_bg_server.py b/tests/test_bg_server.py
index 718b111..4dac62c 100644
--- a/tests/test_bg_server.py
+++ b/tests/test_bg_server.py
@@ -5,7 +5,7 @@
 from app.bg_server import start_server
 
 
-def _make_config(telegram_token=None, discord_token=None):
+def _make_config(telegram_token=None, discord_token=None, slack_bot_token=None, slack_app_token=None):
     """Build a mock config that returns only the configured channels."""
     mock_config = MagicMock()
     mock_config.PROJECT_HOME = MagicMock()
@@ -24,6 +24,14 @@ def _make_config(telegram_token=None, discord_token=None):
             "TOKEN": discord_token,
         }.get(key, default)
 
+    if slack_bot_token:
+        active["slack"] = True
+        mock_config.slack.get.side_effect = lambda key, default=None: {
+            "BOT_TOKEN": slack_bot_token,
+            "APP_TOKEN": slack_app_token,
+            "ALLOW_FROM": [],
+        }.get(key, default)
+
     mock_config.get.side_effect = lambda key: active.get(key)
     return mock_config
 
@@ -152,3 +160,69 @@ async def test_start_server_discord_missing_token_skips_channel():
         await start_server()
 
     mock_gather.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_start_server_slack_only_starts_slack_agent():
+    mock_gather = AsyncMock()
+    mock_config = _make_config(slack_bot_token="xoxb-test", slack_app_token="xapp-test")
+
+    with patch("app.bg_server.config", mock_config), \
+         patch("app.bg_server.os.chdir"), \
+         patch("app.channels.slack.SlackChannel") as MockSC, \
+         patch("app.bg_server.BackgroundAgent") as MockAgent, \
+         patch("app.bg_server.ScheduledTasks"), \
+         patch("app.bg_server.MessageQueue") as MockMQ, \
+         patch("asyncio.gather", mock_gather):
+
+        mock_sc = MockSC.return_value
+        mock_mq = MockMQ.return_value
+
+        await start_server()
+
+    MockSC.assert_called_once_with(mock_mq, bot_token="xoxb-test", app_token="xapp-test", allow_from=[])
+    MockAgent.assert_called_once_with(mq=mock_mq, channel=mock_sc, max_iterations=ANY)
+    assert mock_gather.called
+
+
+@pytest.mark.asyncio
+async def test_start_server_slack_gather_has_correct_coros():
+    mock_gather = AsyncMock()
+    mock_config = _make_config(slack_bot_token="xoxb-test", slack_app_token="xapp-test")
+
+    with patch("app.bg_server.config", mock_config), \
+         patch("app.bg_server.os.chdir"), \
+         patch("app.channels.slack.SlackChannel") as MockSC, \
+         patch("app.bg_server.BackgroundAgent") as MockAgent, \
+         patch("app.bg_server.ScheduledTasks") as MockTasks, \
+         patch("app.bg_server.MessageQueue") as MockMQ, \
+         patch("asyncio.gather", mock_gather):
+
+        mock_sc = MockSC.return_value
+        mock_agent = MockAgent.return_value
+        mock_mq = MockMQ.return_value
+
+        await start_server()
+
+    # tasks.run + slack run_polling + slack process_incoming + slack process_outgoing = 4
+    coros = mock_gather.call_args[0]
+    assert len(coros) == 4
+    mock_sc.run_polling.assert_called_once()
+    mock_agent.process_incoming.assert_called_once()
+    mock_mq.process_outgoing.assert_called_once()
+
+
+@pytest.mark.asyncio
+async def test_start_server_slack_missing_tokens_skips_channel():
+    mock_gather = AsyncMock()
+    mock_config = _make_config()
+    mock_config.get.side_effect = lambda key: {"slack": True}.get(key)
+    mock_config.slack.get.side_effect = lambda key, default=None: None  # both tokens missing
+
+    with patch("app.bg_server.config", mock_config), \
+         patch("app.bg_server.os.chdir"), \
+         patch("asyncio.gather", mock_gather):
+
+        await start_server()
+
+    mock_gather.assert_not_called()
diff --git a/tests/test_config.py b/tests/test_config.py
index 6199877..e89c3a6 100644
--- a/tests/test_config.py
+++ b/tests/test_config.py
@@ -104,3 +104,42 @@ def test_docker_scenario_no_file_all_env_vars(tmp_path):
     assert config.get("telegram")["BOT_TOKEN"] == "bot:token"
     assert config.get("telegram")["ALLOW_FROM"] == [99, 100]
 
+
+# --- Slack env var overlay ---
+
+def test_slack_bot_token_env_sets_value(tmp_path):
+    with patch.dict(os.environ, {"SLACK_BOT_TOKEN": "xoxb-test"}, clear=False):
+        config.load(tmp_path / "missing.toml")
+    assert config.get("slack")["BOT_TOKEN"] == "xoxb-test"
+
+
+def test_slack_app_token_env_sets_value(tmp_path):
+    with patch.dict(os.environ, {"SLACK_APP_TOKEN": "xapp-test"}, clear=False):
+        config.load(tmp_path / "missing.toml")
+    assert config.get("slack")["APP_TOKEN"] == "xapp-test"
+
+
+def test_slack_allow_from_env_parsed_to_string_list(tmp_path):
+    with patch.dict(os.environ, {"SLACK_ALLOW_FROM": "U111,U222,U333"}, clear=False):
+        config.load(tmp_path / "missing.toml")
+    assert config.get("slack")["ALLOW_FROM"] == ["U111", "U222", "U333"]
+
+
+def test_slack_allow_from_env_strips_whitespace(tmp_path):
+    with patch.dict(os.environ, {"SLACK_ALLOW_FROM": "U111, U222"}, clear=False):
+        config.load(tmp_path / "missing.toml")
+    assert config.get("slack")["ALLOW_FROM"] == ["U111", "U222"]
+
+
+def test_slack_docker_scenario_all_env_vars(tmp_path):
+    env = {
+        "SLACK_BOT_TOKEN": "xoxb-abc",
+        "SLACK_APP_TOKEN": "xapp-xyz",
+        "SLACK_ALLOW_FROM": "U123,U456",
+    }
+    with patch.dict(os.environ, env, clear=False):
+        config.load(tmp_path / "missing.toml")
+    assert config.get("slack")["BOT_TOKEN"] == "xoxb-abc"
+    assert config.get("slack")["APP_TOKEN"] == "xapp-xyz"
+    assert config.get("slack")["ALLOW_FROM"] == ["U123", "U456"]
+
diff --git a/tests/test_slack_channel.py b/tests/test_slack_channel.py
index f3fa174..b4992a0 100644
--- a/tests/test_slack_channel.py
+++ b/tests/test_slack_channel.py
@@ -1,5 +1,5 @@
 import pytest
-from unittest.mock import patch, MagicMock, AsyncMock
+from unittest.mock import patch, AsyncMock
 
 from app.channels.channel import ChannelType
 from app.channels.slack import SlackChannel, MAX_SLACK_LENGTH
@@ -111,6 +111,18 @@ async def test_handle_message_allows_user_subtypes():
     assert not mq.incoming.empty()
 
 
+@pytest.mark.asyncio
+async def test_handle_message_ignores_event_with_no_channel():
+    sc, mq = make_slack_channel()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "hello"},  # no "channel" key
+        say=AsyncMock(),
+    )
+
+    assert mq.incoming.empty()
+
+
 @pytest.mark.asyncio
 async def test_handle_message_rejects_unauthorized_user():
     sc, mq = make_slack_channel(allow_from=["U111", "U222"])

From f38340184fbd7375302322e92e27dd63f9c8bbbd Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 5 Jun 2026 15:51:17 +0000
Subject: [PATCH 4/7] Change allow_from empty list to deny-all instead of
 allow-all

Empty ALLOW_FROM now means no one is permitted, consistent with the
principle of least privilege. Previously [] was treated as "no filter"
(allow everyone); now it is treated as an empty allowlist (allow nobody).

Update config comments, README, and all affected tests accordingly.

https://claude.ai/code/session_01Fa64TcstSLyfugG93cjYR2
---
 README.md                      | 16 ++++++++--------
 app/channels/discord.py        |  2 +-
 app/channels/slack.py          |  2 +-
 app/channels/telegram.py       |  2 +-
 app/config.py                  |  6 +++---
 tests/test_discord_channel.py  | 10 +++++++---
 tests/test_slack_channel.py    | 10 +++++++---
 tests/test_telegram_channel.py | 13 ++++++++-----
 8 files changed, 36 insertions(+), 25 deletions(-)

diff --git a/README.md b/README.md
index 56f8a68..719c94f 100644
--- a/README.md
+++ b/README.md
@@ -53,7 +53,7 @@ ALLOW_FROM = []  # List of allowed Telegram user IDs (integers).
 
 [discord]
 TOKEN = ""
-ALLOW_FROM = []  # List of allowed Discord user IDs (integers). Empty means allow all.
+ALLOW_FROM = []  # List of allowed Discord user IDs (integers). Empty = deny all.
 
 [websocket]
 HOST = "127.0.0.1"   # use 0.0.0.0 to expose on all interfaces (required for Docker)
@@ -62,7 +62,7 @@ PORT = 8765
 [slack]
 BOT_TOKEN = ""   # xoxb-... bot token
 APP_TOKEN = ""   # xapp-... app-level token (required for Socket Mode)
-ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty means allow all.
+ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty = deny all.
 ```
 
 Message history is stored in `~/.crafterscode/history.db` (SQLite). Each channel maintains its own history with estimated token counts per message.
@@ -118,16 +118,16 @@ Configure one or more channels in `~/.crafterscode/config.toml`:
 ```toml
 [telegram]
 BOT_TOKEN = "123456:ABC-your-bot-token"
-ALLOW_FROM = [123456789]  # restrict by user ID; empty = allow all
+ALLOW_FROM = [123456789]  # restrict by user ID
 
 [discord]
 TOKEN = "your-discord-bot-token"
-ALLOW_FROM = []  # restrict by user ID; empty = allow all
+ALLOW_FROM = []  # restrict by user ID
 
 [slack]
 BOT_TOKEN = "xoxb-..."   # bot token from Slack app settings
 APP_TOKEN = "xapp-..."   # app-level token with connections:write scope
-ALLOW_FROM = []          # restrict by Slack user ID; empty = allow all
+ALLOW_FROM = []          # restrict by Slack user ID
 ```
 
 ```bash
@@ -250,12 +250,12 @@ docker run -d \
 | `WEBSOCKET_HOST` | — | Bind host for web UI (use `0.0.0.0` in Docker; default: `127.0.0.1`) |
 | `WEBSOCKET_PORT` | — | Port for web UI and WebSocket (default: `8765`) |
 | `TELEGRAM_BOT_TOKEN` | — | Telegram bot token from @BotFather |
-| `TELEGRAM_ALLOW_FROM` | — | Comma-separated Telegram user IDs (empty = allow all) |
+| `TELEGRAM_ALLOW_FROM` | — | Comma-separated Telegram user IDs (empty = deny all) |
 | `DISCORD_BOT_TOKEN` | — | Discord bot token from developer portal |
-| `DISCORD_ALLOW_FROM` | — | Comma-separated Discord user IDs (empty = allow all) |
+| `DISCORD_ALLOW_FROM` | — | Comma-separated Discord user IDs (empty = deny all) |
 | `SLACK_BOT_TOKEN` | — | Slack bot token (`xoxb-...`) from app settings |
 | `SLACK_APP_TOKEN` | — | Slack app-level token (`xapp-...`) with `connections:write` scope |
-| `SLACK_ALLOW_FROM` | — | Comma-separated Slack user IDs (empty = allow all) |
+| `SLACK_ALLOW_FROM` | — | Comma-separated Slack user IDs (empty = deny all) |
 | `LLM_BASE_URL` | no | API base URL (default: `https://openrouter.ai/api/v1`) |
 | `MODEL` | no | Model string (default: `deepseek/deepseek-v3.2`) |
 | `ANOTHERBOT_HOME` | no | Data directory for DB and workspace (default: `/data` in container) |
diff --git a/app/channels/discord.py b/app/channels/discord.py
index 9b97997..ece9523 100644
--- a/app/channels/discord.py
+++ b/app/channels/discord.py
@@ -46,7 +46,7 @@ async def on_message(self, message: discord.Message) -> None:
         if message.author.id == self.user.id:
             return
         user_id = message.author.id
-        if self.allow_from and user_id not in self.allow_from:
+        if user_id not in self.allow_from:
             log.warning(f"Discord: ignoring message from unauthorized user id={user_id}")
             await message.reply("Sorry, you are not authorized to use this bot.")
             return
diff --git a/app/channels/slack.py b/app/channels/slack.py
index 9fd7003..90b9874 100644
--- a/app/channels/slack.py
+++ b/app/channels/slack.py
@@ -71,7 +71,7 @@ async def _handle_message(self, event: dict, say) -> None:
             return
 
         user_id = event.get("user", "")
-        if self.allow_from and user_id not in self.allow_from:
+        if user_id not in self.allow_from:
             log.warning(f"Slack: ignoring message from unauthorized user id={user_id}")
             await say("Sorry, you are not authorized to use this bot.")
             return
diff --git a/app/channels/telegram.py b/app/channels/telegram.py
index 27ae922..b0f31bb 100755
--- a/app/channels/telegram.py
+++ b/app/channels/telegram.py
@@ -93,7 +93,7 @@ async def process_message(
         self, update: Update, context: ContextTypes.DEFAULT_TYPE
     ) -> None:
         user_id = update.effective_user.id if update.effective_user else None
-        if user_id is None or (self.allow_from and user_id not in self.allow_from):
+        if user_id is None or user_id not in self.allow_from:
             log.warning(
                 f"Received message from unauthorized user id={user_id}, ignoring."
             )
diff --git a/app/config.py b/app/config.py
index d021a4f..cac4177 100644
--- a/app/config.py
+++ b/app/config.py
@@ -72,11 +72,11 @@ def get_default_config() -> str:
 
 [telegram]
 BOT_TOKEN = ""
-ALLOW_FROM = []  # List of allowed Telegram user IDs (integers). Must be non-empty.
+ALLOW_FROM = []  # List of allowed Telegram user IDs (integers). Empty = deny all.
 
 [discord]
 TOKEN = ""
-ALLOW_FROM = []  # List of allowed Discord user IDs (integers). Empty means allow all.
+ALLOW_FROM = []  # List of allowed Discord user IDs (integers). Empty = deny all.
 
 [websocket]
 HOST = "127.0.0.1"
@@ -85,5 +85,5 @@ def get_default_config() -> str:
 [slack]
 BOT_TOKEN = ""   # xoxb-... bot token
 APP_TOKEN = ""   # xapp-... app-level token (required for Socket Mode)
-ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty means allow all.
+ALLOW_FROM = []  # List of allowed Slack user IDs (strings). Empty = deny all.
 """
diff --git a/tests/test_discord_channel.py b/tests/test_discord_channel.py
index abf5285..dfab1b3 100644
--- a/tests/test_discord_channel.py
+++ b/tests/test_discord_channel.py
@@ -9,6 +9,8 @@
 
 
 def make_discord_channel(allow_from=None):
+    if allow_from is None:
+        allow_from = [123]  # default authorized user used across these tests
     mq = MessageQueue()
     with patch.object(discord.Client, "__init__", return_value=None):
         dc = DiscordChannel(mq=mq, token="test-token", allow_from=allow_from)
@@ -107,16 +109,18 @@ async def test_on_message_rejects_unauthorized_user():
 
 
 @pytest.mark.asyncio
-async def test_on_message_allows_when_allow_from_empty():
+async def test_on_message_denies_when_allow_from_empty():
     dc, mq = make_discord_channel(allow_from=[])
     message = MagicMock()
-    message.author.id = 456  # any user allowed when allow_from is empty
+    message.author.id = 456
     message.channel.id = 1
     message.content = "hello"
+    message.reply = AsyncMock()
 
     await dc.on_message(message)
 
-    assert not mq.incoming.empty()
+    assert mq.incoming.empty()
+    message.reply.assert_called_once()
 
 
 @pytest.mark.asyncio
diff --git a/tests/test_slack_channel.py b/tests/test_slack_channel.py
index b4992a0..1d23555 100644
--- a/tests/test_slack_channel.py
+++ b/tests/test_slack_channel.py
@@ -8,6 +8,8 @@
 
 
 def make_slack_channel(allow_from=None):
+    if allow_from is None:
+        allow_from = ["U123"]  # default authorized user used across these tests
     mq = MessageQueue()
     with patch("app.channels.slack.AsyncApp"), \
          patch("app.channels.slack.AsyncSocketModeHandler"):
@@ -139,15 +141,17 @@ async def test_handle_message_rejects_unauthorized_user():
 
 
 @pytest.mark.asyncio
-async def test_handle_message_allows_when_allow_from_empty():
+async def test_handle_message_denies_when_allow_from_empty():
     sc, mq = make_slack_channel(allow_from=[])
+    say = AsyncMock()
 
     await sc._handle_message(
         event={"user": "U999", "text": "hello", "channel": "C456"},
-        say=AsyncMock(),
+        say=say,
     )
 
-    assert not mq.incoming.empty()
+    assert mq.incoming.empty()
+    say.assert_called_once()
 
 
 @pytest.mark.asyncio
diff --git a/tests/test_telegram_channel.py b/tests/test_telegram_channel.py
index 9b7ad39..23bed59 100644
--- a/tests/test_telegram_channel.py
+++ b/tests/test_telegram_channel.py
@@ -8,6 +8,8 @@
 
 
 def make_telegram_channel(allow_from=None):
+    if allow_from is None:
+        allow_from = [123]  # default authorized user used across these tests
     mq = MessageQueue()
     with patch("app.channels.telegram.ApplicationBuilder"):
         tc = TelegramChannel(mq=mq, bot_token="test-token", allow_from=allow_from)
@@ -31,8 +33,9 @@ def test_stores_bot_token_and_allow_from():
     assert tc.allow_from == [111, 222]
 
 
-def test_allow_from_defaults_to_empty_list():
-    tc, _ = make_telegram_channel()
+def test_allow_from_none_becomes_empty_list():
+    with patch("app.channels.telegram.ApplicationBuilder"):
+        tc = TelegramChannel(mq=MessageQueue(), bot_token="t", allow_from=None)
     assert tc.allow_from == []
 
 
@@ -80,7 +83,7 @@ def make_update(text="hello", user_id=123, chat_id=456):
 @pytest.mark.asyncio
 async def test_process_message_puts_to_incoming_queue():
     tc, mq = make_telegram_channel()
-    update = make_update(text="do something", user_id=1, chat_id=10)
+    update = make_update(text="do something", user_id=123, chat_id=10)
 
     await tc.process_message(update, AsyncMock())
 
@@ -104,13 +107,13 @@ async def test_process_message_rejects_unauthorized_user():
 
 
 @pytest.mark.asyncio
-async def test_process_message_allows_when_allow_from_empty():
+async def test_process_message_denies_when_allow_from_empty():
     tc, mq = make_telegram_channel(allow_from=[])
     update = make_update(user_id=999, text="hi")
 
     await tc.process_message(update, AsyncMock())
 
-    assert not mq.incoming.empty()
+    assert mq.incoming.empty()
 
 
 @pytest.mark.asyncio

From 96ff34e65cd83b81b2b3cdec949761d2a741f8ed Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 5 Jun 2026 17:54:25 +0000
Subject: [PATCH 5/7] Fix Slack slash command routing, last_channel_id
 tracking, and Telegram auth gap

- Route Slack slash commands through app.command() handler (not just event("message")),
  matching how Slack actually delivers /commands
- Update _last_channel_id before the command branch in _handle_message so it is
  always set even when the message triggers a whoami/stop inline response
- Add allow_from auth check to Telegram command_handler, which previously had no
  authorization guard and allowed any user to invoke slash commands
- Add tests for all three cases

https://claude.ai/code/session_01Fa64TcstSLyfugG93cjYR2
---
 app/channels/slack.py          | 39 +++++++++++++-
 app/channels/telegram.py       |  5 ++
 tests/test_slack_channel.py    | 96 ++++++++++++++++++++++++++++++++++
 tests/test_telegram_channel.py | 16 +++++-
 4 files changed, 153 insertions(+), 3 deletions(-)

diff --git a/app/channels/slack.py b/app/channels/slack.py
index 90b9874..5d35e40 100644
--- a/app/channels/slack.py
+++ b/app/channels/slack.py
@@ -1,5 +1,6 @@
 import asyncio
 import logging
+import re
 
 from slack_bolt.async_app import AsyncApp
 from slack_bolt.adapter.socket_mode.async_handler import AsyncSocketModeHandler
@@ -46,8 +47,44 @@ def __init__(
 
     def _register_handlers(self) -> None:
         self.app.event("message")(self._handle_message)
+        self.app.command(re.compile(r".*"))(self._handle_slash_command)
         self.app.error(self._slack_error_handler)
 
+    async def _handle_slash_command(self, ack, command: dict, say) -> None:
+        await ack()
+        user_id = command.get("user_id", "")
+        channel_id = command.get("channel_id", "")
+        if user_id not in self.allow_from:
+            log.warning(f"Slack: ignoring slash command from unauthorized user id={user_id}")
+            await say("Sorry, you are not authorized to use this bot.")
+            return
+        if channel_id:
+            self._last_channel_id = channel_id
+        cmd_name = (command.get("command") or "").lstrip("/").lower()
+        text = (command.get("text") or "").strip()
+        full_content = f"/{cmd_name} {text}".strip()
+        metadata = {"channel_id": channel_id}
+        if cmd_name == "whoami":
+            await self.send_message(OutgoingMessage(
+                content=f"Your user ID is {user_id}.",
+                channel=ChannelType.SLACK,
+                metadata=metadata,
+            ))
+            return
+        if cmd_name == "stop":
+            self.stopped = True
+            await self.send_message(OutgoingMessage(
+                content="Stopped.",
+                channel=ChannelType.SLACK,
+                metadata=metadata,
+            ))
+            return
+        await self.mq.incoming.put(IncomingMessage(
+            content=full_content,
+            channel=ChannelType.SLACK,
+            metadata=metadata,
+        ))
+
     async def _slack_error_handler(self, error: Exception, body: dict, logger) -> None:
         logger.error(f"Slack error: {error}", exc_info=True)
 
@@ -84,6 +121,7 @@ async def _handle_message(self, event: dict, say) -> None:
         if not channel_id:
             log.warning("Slack: ignoring message with no channel in event")
             return
+        self._last_channel_id = channel_id
         metadata = {"channel_id": channel_id}
 
         if content.startswith("/"):
@@ -104,7 +142,6 @@ async def _handle_message(self, event: dict, say) -> None:
                 ))
                 return
 
-        self._last_channel_id = channel_id
         await self.mq.incoming.put(
             IncomingMessage(
                 content=content,
diff --git a/app/channels/telegram.py b/app/channels/telegram.py
index b0f31bb..4fa36de 100755
--- a/app/channels/telegram.py
+++ b/app/channels/telegram.py
@@ -56,6 +56,11 @@ async def error_handler(
             )
 
     async def command_handler(self, update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+        user_id = update.effective_user.id if update.effective_user else None
+        if user_id is None or user_id not in self.allow_from:
+            log.warning(f"Telegram: ignoring command from unauthorized user id={user_id}")
+            await update.message.reply_text("Sorry, you are not authorized to use this bot.")
+            return
         if update.message and update.message.text:
             content = update.message.text.strip()
             if content.startswith("/"):
diff --git a/tests/test_slack_channel.py b/tests/test_slack_channel.py
index 1d23555..34f13d6 100644
--- a/tests/test_slack_channel.py
+++ b/tests/test_slack_channel.py
@@ -290,3 +290,99 @@ async def test_send_message_logs_error_when_no_channel_id(caplog):
 
     assert sc.app.client.chat_postMessage.call_count == 0
     assert "channel_id" in caplog.text
+
+
+# --- _handle_slash_command ---
+
+def make_command(cmd="/status", text="", user_id="U123", channel_id="C456"):
+    return {"command": cmd, "text": text, "user_id": user_id, "channel_id": channel_id}
+
+
+@pytest.mark.asyncio
+async def test_slash_command_enqueued():
+    sc, mq = make_slack_channel()
+    ack = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/status"), AsyncMock())
+
+    ack.assert_called_once()
+    assert not mq.incoming.empty()
+    msg = await mq.incoming.get()
+    assert msg.content == "/status"
+    assert msg.metadata == {"channel_id": "C456"}
+
+
+@pytest.mark.asyncio
+async def test_slash_command_with_args_enqueued():
+    sc, mq = make_slack_channel()
+    ack = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/model", text="gpt-4"), AsyncMock())
+
+    ack.assert_called_once()
+    msg = await mq.incoming.get()
+    assert msg.content == "/model gpt-4"
+
+
+@pytest.mark.asyncio
+async def test_slash_command_whoami():
+    sc, mq = make_slack_channel()
+    sc.send_message = AsyncMock()
+    ack = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/whoami"), AsyncMock())
+
+    sc.send_message.assert_called_once()
+    assert "U123" in sc.send_message.call_args[0][0].content
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_slash_command_stop():
+    sc, mq = make_slack_channel()
+    sc.send_message = AsyncMock()
+    ack = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/stop"), AsyncMock())
+
+    assert sc.has_stopped is True
+    assert mq.incoming.empty()
+
+
+@pytest.mark.asyncio
+async def test_slash_command_rejects_unauthorized_user():
+    sc, mq = make_slack_channel(allow_from=["U123"])
+    ack = AsyncMock()
+    say = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/status", user_id="U999"), say)
+
+    ack.assert_called_once()
+    assert mq.incoming.empty()
+    say.assert_called_once()
+    assert "not authorized" in say.call_args[0][0]
+
+
+@pytest.mark.asyncio
+async def test_slash_command_updates_last_channel_id():
+    sc, mq = make_slack_channel()
+    ack = AsyncMock()
+
+    await sc._handle_slash_command(ack, make_command("/status", channel_id="C999"), AsyncMock())
+
+    assert sc._last_channel_id == "C999"
+
+
+# --- _last_channel_id updated before command branch in _handle_message ---
+
+@pytest.mark.asyncio
+async def test_handle_message_updates_last_channel_id_for_commands():
+    sc, mq = make_slack_channel()
+    sc.send_message = AsyncMock()
+
+    await sc._handle_message(
+        event={"user": "U123", "text": "/whoami", "channel": "C777"},
+        say=AsyncMock(),
+    )
+
+    assert sc._last_channel_id == "C777"
diff --git a/tests/test_telegram_channel.py b/tests/test_telegram_channel.py
index 23bed59..66d8b17 100644
--- a/tests/test_telegram_channel.py
+++ b/tests/test_telegram_channel.py
@@ -186,11 +186,23 @@ async def test_command_handler_whoami_replies_with_user_info():
     tc, _ = make_telegram_channel()
     tc.send_message = AsyncMock()
 
-    await tc.command_handler(make_update(text="/whoami", user_id=42), MagicMock())
+    await tc.command_handler(make_update(text="/whoami", user_id=123), MagicMock())
 
     tc.send_message.assert_called_once()
     text = tc.send_message.call_args[0][0].content
-    assert "42" in text
+    assert "123" in text
+
+
+@pytest.mark.asyncio
+async def test_command_handler_rejects_unauthorized_user():
+    tc, mq = make_telegram_channel(allow_from=[123])
+    update = make_update(text="/status", user_id=999)
+
+    await tc.command_handler(update, MagicMock())
+
+    assert mq.incoming.empty()
+    update.message.reply_text.assert_called_once()
+    assert "not authorized" in update.message.reply_text.call_args[0][0]
 
 
 @pytest.mark.asyncio

From 07b2fc2020079107564f01a8eb16e10fd74b13e3 Mon Sep 17 00:00:00 2001
From: Copilot <198982749+Copilot@users.noreply.github.com>
Date: Thu, 18 Jun 2026 05:13:53 -0500
Subject: [PATCH 6/7] Resolving conflicts in old pull request (#15)

---
 .gitignore                          |   1 +
 CLAUDE.md                           |  18 +-
 README.md                           |  79 ++-
 app/channels/commands.py            |  73 ++-
 app/channels/slack.py               |   6 +-
 app/channels/static/web_channel.css |  79 +++
 app/channels/static/web_channel.js  | 113 +++-
 app/channels/web_channel.py         | 172 +++++-
 app/cli/cli_agent.py                |  17 +-
 app/core/agent.py                   | 107 +++-
 app/core/background_agent.py        |  24 +-
 app/core/helper_agent.py            |   2 +-
 app/core/mcp_manager.py             | 148 +++++
 app/core/sys_instructions.md        |   6 +-
 app/core/tool_calls.py              |  22 +-
 app/infra/message_history.py        |   3 +-
 app/infra/setup.py                  |   2 +-
 app/infra/tracer.py                 |  27 +
 app/main.py                         |  63 ++-
 app/tools/helper_agent.py           |  35 ++
 pyproject.toml                      |   1 +
 tests/test_agent.py                 | 186 ++++++-
 tests/test_background_agent.py      |  31 ++
 tests/test_commands.py              |  71 ++-
 tests/test_helper_agent_tool.py     |  23 +
 tests/test_main.py                  |  86 ++-
 tests/test_tool_calls.py            |  66 ++-
 tests/test_tracer.py                |  44 ++
 tests/test_web_channel.py           | 112 ++++
 uv.lock                             | 823 ++++++++++++++++++++++++++++
 30 files changed, 2347 insertions(+), 93 deletions(-)
 create mode 100644 app/core/mcp_manager.py
 create mode 100644 app/infra/tracer.py
 create mode 100755 app/tools/helper_agent.py
 create mode 100755 tests/test_helper_agent_tool.py
 create mode 100644 tests/test_tracer.py

diff --git a/.gitignore b/.gitignore
index 3909ff7..cae5323 100644
--- a/.gitignore
+++ b/.gitignore
@@ -132,6 +132,7 @@ celerybeat.pid
 # Environments
 .env
 .venv
+.venv_win
 env/
 venv/
 ENV/
diff --git a/CLAUDE.md b/CLAUDE.md
index 0c2c954..192d8c5 100755
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -55,6 +55,8 @@ Environment variables (all override config file values):
 - `WEBSOCKET_PORT` — port for web UI + WebSocket (default: `8765`)
 - `ANOTHERBOT_HOME` — overrides the data directory (default: `~/.crafterscode`)
 
+MCP servers are configured separately in `~/.crafterscode/mcp_servers.json` (same dir, same format as Claude Desktop's `mcpServers` key). No env-var equivalent — in Docker, mount the file at `$ANOTHERBOT_HOME/mcp_servers.json`.
+
 For Docker, no config file is needed — pass everything as env vars. See `Dockerfile` and the Docker section in README.
 
 ## Architecture
@@ -72,16 +74,24 @@ The shared loop lives in `Agent._loop()` (`app/core/agent.py`). Subclasses overr
 | `_on_no_choices` | raise | exponential backoff | raise |
 | `_should_stop` | — | `channel.has_stopped` | — |
 
-Tool calls within a single LLM turn are dispatched in parallel via `asyncio.gather`. After each turn, the full message chain (assistant tool-call message + tool results + final response) is saved to `self.messages` with tool results truncated to `TOOL_RESULT_HISTORY_LIMIT` chars to keep context lean. `MessageHistory` (SQLite) stores only user + final assistant text for cross-session persistence.
+Tool calls within a single LLM turn are dispatched in parallel via `asyncio.gather`. After each turn, the full message chain (assistant tool-call message + tool results + final response) is saved to `self.messages` at full length. `MessageHistory` (SQLite) stores only user + final assistant text for cross-session persistence.
 
 ### Tool System
 
-Each tool is a class extending `Tool` (`app/core/tool.py`), an ABC requiring a static `spec()` (OpenAI function-call schema) and a static `call()` method. Tools are registered in `app/core/tool_calls.py` in `tool_registry` — a dict mapping tool name → `Tool` class. `run_tool()` dispatches by name and restores `os.getcwd()` after each call. Results are truncated to `MAX_TOOL_RESULT_LENGTH` (16 000 chars).
+Each tool is a class extending `Tool` (`app/core/tool.py`), an ABC requiring a static `spec()` (OpenAI function-call schema) and a static `call()` method. Tools are registered in `app/core/tool_calls.py` in `tool_registry` — a dict mapping tool name → `Tool` class. `run_tool()` is asynchronous and dispatches by name, awaiting the tool's `call` if it is a coroutine function, and restores `os.getcwd()` after execution. Results are truncated to `MAX_TOOL_RESULT_LENGTH` (16 000 chars).
 
-Current tools: `read_file`, `write_file`, `bash`, `web_fetch`, `get_skills_dir`, `todo_add/list/update/clear`, `calculator`, `hackernews`, `websearch_text/images/videos/news/books`, `list/add/update/remove_scheduled_task`, `get_scheduled_task_output`, `get_city_state`, `get_datetime`.
+Current built-in tools: `read_file`, `write_file`, `bash`, `web_fetch`, `get_skills_dir`, `todo_add/list/update/clear`, `calculator`, `hackernews`, `websearch_text/images/videos/news/books`, `list/add/update/remove_scheduled_task`, `get_scheduled_task_output`, `get_city_state`, `get_datetime`, `helper_agent`.
 
 `_HELPER_AGENT_TOOLS` in `tool_calls.py` is an explicit allowlist of tools available to `HelperAgent` (used internally by scheduled tasks). Scheduled task mutation tools (`add/update/remove_scheduled_task`) are excluded to prevent recursion.
 
+`get_all_tool_specs()` merges built-in specs with any MCP tool specs at call time (not module load). `run_tool_async()` is the async dispatcher used by `handle_tool_call` — it routes to `MCPManager.call_tool()` for MCP tools or falls through to the synchronous `run_tool()` for built-ins.
+
+### MCP Servers
+
+`MCPManager` (`app/core/mcp_manager.py`) owns persistent FastMCP client connections and their tool catalogs. It is a module-level singleton (`mcp_manager`). `initialize_mcp()` in `main.py` reads `mcp_servers.json`, then calls `mcp_manager.initialize()` which connects all servers concurrently via `asyncio.gather`. Each server's tools are discovered via `list_tools()` and registered under the namespace `servername__toolname` (`_SEP = "__"`). `rpartition` is used when routing calls so tool names may contain underscores freely; only the server name must not contain `__`.
+
+The singleton is shut down via `mcp_manager.shutdown()` in a `try/finally` block in `main()`. `HelperAgent` does not receive MCP tools — it uses the static `helper_tool_specs` allowlist to prevent recursion.
+
 ### System Context
 
 On startup, `load_system_context()` (`app/infra/startup.py`) loads `app/core/sys_instructions.md` and prepends it as the system message to `self.messages`.
@@ -94,7 +104,7 @@ On startup, `load_system_context()` (`app/infra/startup.py`) loads `app/core/sys
 
 **Channel types** are defined in `ChannelType` enum (`app/channels/channel.py`): `CLI`, `TELEGRAM`, `DISCORD`, `WEB`. Each channel implements the `Channel` ABC and owns a `MessageQueue` instance. `bg_server.py` wires up enabled channels — each gets its own `MessageQueue`, `BackgroundAgent`, and set of coroutines (`run_polling`, `process_incoming`, `process_outgoing`) gathered into the event loop.
 
-**WebChannel** (`app/channels/web_channel.py`) uses `python-fasthtml` + uvicorn to serve both a browser chat UI (`GET /`) and a JSON WebSocket endpoint (`WS /ws`) on the same port. Multiple concurrent browser tabs are supported — each connection gets a UUID tracked in `_connections`. A per-connection `asyncio.Lock` in `_send_locks` serializes writes to each WebSocket. The channel also exposes `GET /api/conversations`, `GET /api/messages` (scoped to web channel only), and `GET /api/status` REST endpoints. Only `/whoami` is handled inline (it needs the per-connection client ID); all other slash commands — including `/help`, `/status`, `/stop` — are forwarded to `BackgroundAgent`'s `CommandRegistry` via the message queue with `is_command=True` in metadata so `send_message()` emits `{"type":"system"}` responses, enabling the sidebar to refresh after conversation-mutating commands.
+**WebChannel** (`app/channels/web_channel.py`) uses `python-fasthtml` + uvicorn to serve both a browser chat UI (`GET /`) and a JSON WebSocket endpoint (`WS /ws`) on the same port. Multiple concurrent browser tabs are supported — each connection gets a UUID tracked in `_connections`. A per-connection `asyncio.Lock` in `_send_locks` serializes writes to each WebSocket. The channel also exposes `GET /api/conversations`, `GET /api/messages` (scoped to web channel only), `GET /api/status`, and `POST /api/upload` REST endpoints. `POST /api/upload` accepts multipart `files` (one or more), writes each under `$ANOTHERBOT_HOME/uploads` with a UUID prefix, and returns the stored basenames; the browser (paperclip button next to the input) sends those basenames back in the WebSocket `message` frame's `files` field. `_resolve_upload_paths()` joins each basename to the upload dir (basename-only, so client paths can't traverse out) and the resolved absolute paths reach the agent via `metadata["files"]`, which `Agent._build_user_message()` encodes as image/file parts. Only `/whoami` is handled inline (it needs the per-connection client ID); all other slash commands — including `/help`, `/status`, `/stop` — are forwarded to `BackgroundAgent`'s `CommandRegistry` via the message queue with `is_command=True` in metadata so `send_message()` emits `{"type":"system"}` responses, enabling the sidebar to refresh after conversation-mutating commands.
 
 **Slash commands** are handled entirely by `BackgroundAgent`. Channel handlers (`command_handler` in Telegram, `on_message` in Discord) intercept only `/whoami` (resolved inline using the platform user object) and enqueue everything else as a plain `IncomingMessage`. `BackgroundAgent.process_incoming()` detects the leading `/` and dispatches via its own `CommandRegistry`. That registry owns the full command set: `/model`, `/status`, `/stop`, `/help`, `/list`, `/new`, `/load`, `/fork`, `/rename`, `/export`.
 
diff --git a/README.md b/README.md
index 719c94f..91a5ec2 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,7 @@ A Python-based AI agent that can execute prompts, interact with the filesystem,
 - **Discord Integration**: Discord bot — same agent loop, per-channel message isolation, owner DM fallback for scheduled tasks
 - **Slack Integration**: Slack bot via Socket Mode — no public webhook required
 - **Scheduled Tasks**: SQLite-backed task scheduler — run prompts on a recurring or one-shot schedule and deliver results to a channel
+- **MCP Servers**: Connect any [Model Context Protocol](https://modelcontextprotocol.io) server via `mcp_servers.json` — tools are auto-discovered and available alongside built-ins
 - **Tool Calling**: File I/O, shell commands, web fetch, web search (text/images/video/news/books), calculator, Hacker News, todo list
 - **Skills System**: Extendable skills in `app/skills/` (e.g., `puppeteer` for headless browsing)
 - **Persistent History**: Per-channel SQLite message history at `~/.crafterscode/app.db` (shared with scheduled tasks)
@@ -151,6 +152,83 @@ remove the HN task
 
 Tasks persist in `~/.crafterscode/app.db` (shared with message history) and survive restarts.
 
+## MCP Servers
+
+External [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers extend the agent with additional tools. Configured servers are initialized at startup; their tools appear alongside the built-in ones in the agent's tool list.
+
+### Setup
+
+Create `~/.crafterscode/mcp_servers.json` (same directory as `config.toml`). The format matches Claude Desktop's `mcpServers` config, so existing Claude Desktop configs can be copied directly:
+
+```json
+{
+  "mcpServers": {
+    "memory": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-memory"]
+    },
+    "time": {
+      "command": "uvx",
+      "args": ["mcp-server-time"]
+    },
+    "weather": {
+      "url": "https://weather-mcp.example.com/sse"
+    },
+    "custom": {
+      "command": "python",
+      "args": ["./my_server.py"],
+      "env": {"MY_API_KEY": "secret"}
+    }
+  }
+}
+```
+
+Each server entry supports one of two transport types:
+
+| Field | Required | Description |
+|---|---|---|
+| `command` | one of | Executable to spawn (stdio transport) |
+| `args` | no | Argument list for the command |
+| `env` | no | Extra environment variables for the subprocess |
+| `url` | one of | SSE/HTTP endpoint URL (remote transport) |
+| `disabled` | no | Set to `true` to skip this server at startup |
+
+To enable only a subset of servers, add `"disabled": true` to those you want to skip:
+
+```json
+{
+  "mcpServers": {
+    "memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] },
+    "time":   { "command": "uvx", "args": ["mcp-server-time"], "disabled": true }
+  }
+}
+```
+
+Disabled servers appear in `/mcp` output with status `disabled` so you can see what is configured without connecting it.
+
+### Tool namespacing
+
+MCP tool names are prefixed with their server name using `__` as a separator: `servername__toolname`. This prevents collisions between built-in tools and between different servers.
+
+> **Note:** Server names must not contain `__` — it is reserved as the tool namespace separator.
+
+### Startup behaviour
+
+- All servers connect concurrently at startup.
+- Failed connections are logged and skipped — the agent starts normally with whichever servers connected successfully.
+- All connections are gracefully shut down when the process exits.
+
+### Docker
+
+Mount `mcp_servers.json` into the container's data directory:
+
+```bash
+docker run ... \
+  -v /path/to/mcp_servers.json:/data/mcp_servers.json \
+  -v anotherbot-data:/data \
+  anotherbot
+```
+
 ## Docker
 
 ### Build
@@ -267,7 +345,6 @@ The `/data` volume persists the SQLite database and workspace across restarts. T
 ## Roadmap
 
 - **Email Support**: IMAP/SMTP integration for reading and sending emails, attachment handling, and mailbox management
-- **MCP Support**: Integration with Model Context Protocol for external data sources, tools, and state management
 - **WhatsApp Support**: WhatsApp Business API integration via providers like Twilio or MessageBird
 - **Anthropic OAuth**: Direct integration with Claude API using OAuth 2.0
 - **Codex OAuth**: OpenAI Codex API authentication
diff --git a/app/channels/commands.py b/app/channels/commands.py
index 17e428c..f469d89 100644
--- a/app/channels/commands.py
+++ b/app/channels/commands.py
@@ -69,6 +69,20 @@ async def model_cmd(args: str = "") -> str:
     return f"Model set to: {args.strip()}"
 
 
+async def trace_cmd(args: str = "") -> str:
+    arg = args.strip().lower()
+    tracedir = runtime.get("tracedir")
+    if arg == "on":
+        runtime.set("trace", True)
+        return f"Tracing on. Writing to {tracedir}"
+    elif arg == "off":
+        runtime.set("trace", False)
+        return "Tracing off."
+    else:
+        state = runtime.get("trace", False)
+        return f"Tracing is {'on' if state else 'off'}. Dir: {tracedir}"
+
+
 def make_status_cmd(channel_str: str = "") -> CommandHandler:
     async def _status(args: str = "") -> str:
         uptime = datetime.now() - _STARTUP_TIME
@@ -81,11 +95,15 @@ async def _status(args: str = "") -> str:
         else:
             conv_id = runtime.get("conversation_id", "—")
             conv_name = runtime.get("conversation_name", "—")
+        tracing = runtime.get("trace", False)
+        last_trace = runtime.get("last_trace")
+        trace_line = f"on ({last_trace})" if (tracing and last_trace) else ("on" if tracing else "off")
         return (
             f"Bot status:\n"
             f"  Model:        {model}\n"
             f"  Uptime:       {hours}h {minutes}m {seconds}s\n"
-            f"  Conversation: [{conv_id}] {conv_name}"
+            f"  Conversation: [{conv_id}] {conv_name}\n"
+            f"  Tracing:      {trace_line}"
         )
     return _status
 
@@ -200,3 +218,56 @@ async def _export(args: str = "") -> str:
             return str(e)
         return f"Exported to {path}"
     return _export
+
+
+def mcp_cmd() -> CommandHandler:
+    async def _mcp(args: str = "") -> str:
+        from ..core.mcp_manager import mcp_manager
+
+        parts = args.strip().split(maxsplit=1)
+        subcmd = parts[0].lower() if parts and parts[0] else ""
+        subargs = parts[1].strip() if len(parts) > 1 else ""
+
+        if subcmd == "tools":
+            if subargs:
+                specs = mcp_manager.get_tools_for_server(subargs)
+                if not specs:
+                    configured = [s["name"] for s in mcp_manager.get_server_status()]
+                    if subargs not in configured:
+                        return f"Server '{subargs}' not found. Configured: {', '.join(configured) or 'none'}"
+                    return f"Server '{subargs}' has no tools."
+                lines = [f"Tools for '{subargs}' ({len(specs)}):"]
+                for spec in specs:
+                    fn = spec["function"]
+                    bare = fn["name"].partition("__")[2]
+                    desc = fn.get("description", "")
+                    lines.append(f"  {bare}" + (f" — {desc}" if desc else ""))
+                return "\n".join(lines)
+            else:
+                specs = mcp_manager.get_tool_specs()
+                if not specs:
+                    return "No MCP tools available."
+                lines = [f"MCP tools ({len(specs)}):"]
+                for spec in specs:
+                    fn = spec["function"]
+                    desc = fn.get("description", "")
+                    lines.append(f"  {fn['name']}" + (f" — {desc}" if desc else ""))
+                return "\n".join(lines)
+        else:
+            statuses = mcp_manager.get_server_status()
+            if not statuses:
+                return "No MCP servers configured.\nCreate ~/.crafterscode/mcp_servers.json to add servers."
+            lines = [f"MCP servers ({len(statuses)}):"]
+            for s in statuses:
+                if s["disabled"]:
+                    status = "disabled"
+                elif s["connected"]:
+                    status = "connected"
+                else:
+                    status = "disconnected"
+                lines.append(
+                    f"  {s['name']} — {status}, {s['transport']} ({s['target']}), {s['tool_count']} tool(s)"
+                )
+            return "\n".join(lines)
+
+    return _mcp
diff --git a/app/channels/slack.py b/app/channels/slack.py
index 5d35e40..0f5a7a4 100644
--- a/app/channels/slack.py
+++ b/app/channels/slack.py
@@ -1,4 +1,3 @@
-import asyncio
 import logging
 import re
 
@@ -163,15 +162,14 @@ async def process_message(self, message) -> None:
         pass  # handled by slack bolt event handlers
 
     def error_handler(self, update, context) -> None:
-        log.error(f"Slack error: {context}")
+        pass  # Slack-side errors are handled by _slack_error_handler registered via self.app.error()
 
     def start(self) -> None:
         log.info("Starting Slack channel...")
 
     async def run_polling(self) -> None:
         handler = AsyncSocketModeHandler(self.app, self.app_token)
-        await handler.start_async()
         try:
-            await asyncio.Event().wait()
+            await handler.start_async()
         finally:
             await handler.close_async()
diff --git a/app/channels/static/web_channel.css b/app/channels/static/web_channel.css
index 942dfbb..94b9069 100644
--- a/app/channels/static/web_channel.css
+++ b/app/channels/static/web_channel.css
@@ -318,3 +318,82 @@ body {
 #send-btn:hover   { background: var(--accent-h); }
 #send-btn:active  { transform: scale(.97); }
 #send-btn:disabled { background: var(--border); cursor: not-allowed; }
+
+/* Hide the file input without display:none — keeps it in the layout/event
+   tree so its `change` event fires reliably (Edge) when opened via the label. */
+.visually-hidden {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+}
+
+/* ---- attach button (a <label for="file-input">) ---- */
+#attach-btn {
+    background: var(--surface2);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    color: var(--text-muted);
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    box-sizing: border-box;
+    height: 42px;
+    width: 42px;
+    padding: 0;
+    margin: 0;
+    line-height: 0;          /* kill inline baseline gap (Edge alignment) */
+    flex-shrink: 0;
+    user-select: none;
+    -webkit-user-select: none;
+    transition: border-color .15s, color .15s, background .15s;
+}
+#attach-btn:hover { border-color: var(--accent); color: var(--accent); }
+#attach-btn:active { transform: scale(.97); }
+#attach-btn svg { display: block; width: 20px; height: 20px; }
+
+/* ---- attachment chips ---- */
+#attachments {
+    display: none;
+    flex-wrap: wrap;
+    gap: 8px;
+    padding: 10px 20px 0;
+    background: var(--surface);
+    flex-shrink: 0;
+}
+#attachments.has-files { display: flex; }
+
+.attach-chip {
+    display: inline-flex;
+    align-items: center;
+    gap: 8px;
+    max-width: 240px;
+    background: var(--surface2);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 5px 8px 5px 10px;
+    font-size: 0.8rem;
+}
+.attach-name {
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    color: var(--text);
+}
+.attach-remove {
+    background: none;
+    border: none;
+    color: var(--text-muted);
+    cursor: pointer;
+    font-size: 1rem;
+    line-height: 1;
+    padding: 0 2px;
+    transition: color .12s;
+}
+.attach-remove:hover { color: #ef4444; }
diff --git a/app/channels/static/web_channel.js b/app/channels/static/web_channel.js
index 3fe1bc4..0981bf8 100644
--- a/app/channels/static/web_channel.js
+++ b/app/channels/static/web_channel.js
@@ -18,6 +18,11 @@
     const toggleBtn   = document.getElementById('sidebar-toggle');
     const convListEl  = document.getElementById('conv-list');
     const newConvBtn  = document.getElementById('new-conv-btn');
+    const fileInput   = document.getElementById('file-input');
+    const attachEl    = document.getElementById('attachments');
+
+    // Files staged for the next send (cleared after a successful upload).
+    let selectedFiles = [];
 
     // ---- theme ----
     const savedTheme = localStorage.getItem('ab-theme') || 'dark';
@@ -141,7 +146,7 @@
         ws.onopen = () => {
             reconnectDelay = 1000;
             setStatus('connected', 'Connected');
-            sendBtn.disabled = false;
+            refreshSendState();
             clearMessages();       // always reset DOM before reloading — prevents duplicates on reconnect
             loadConversations(true);
         };
@@ -213,14 +218,105 @@
     }
     function scrollBottom() { scrollEl.scrollTop = scrollEl.scrollHeight; }
 
+    // ---- attachments ----
+    function renderAttachments() {
+        attachEl.innerHTML = '';
+        attachEl.classList.toggle('has-files', selectedFiles.length > 0);
+        selectedFiles.forEach((file, idx) => {
+            const chip = document.createElement('div');
+            chip.className = 'attach-chip';
+            const label = document.createElement('span');
+            label.className = 'attach-name';
+            label.textContent = file.name;
+            label.title = `${file.name} (${fmtSize(file.size)})`;
+            const remove = document.createElement('button');
+            remove.className = 'attach-remove';
+            remove.type = 'button';
+            remove.textContent = '×';
+            remove.title = 'Remove attachment';
+            remove.addEventListener('click', () => {
+                selectedFiles.splice(idx, 1);
+                renderAttachments();
+                refreshSendState();
+            });
+            chip.appendChild(label);
+            chip.appendChild(remove);
+            attachEl.appendChild(chip);
+        });
+    }
+
+    function fmtSize(bytes) {
+        if (bytes < 1024) return bytes + ' B';
+        if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(0) + ' KB';
+        return (bytes / 1024 / 1024).toFixed(1) + ' MB';
+    }
+
+    function refreshSendState() {
+        const connected = ws && ws.readyState === WebSocket.OPEN;
+        const hasInput = inputEl.value.trim().length > 0 || selectedFiles.length > 0;
+        sendBtn.disabled = !connected || !hasInput;
+    }
+
+    // The attach control is a <label for="file-input">, so clicking it opens
+    // the picker natively — no JS click needed (and avoids a double-open).
+    // Copy the FileList into a real array before clearing .value: Edge can
+    // invalidate the live FileList once .value is reset mid-handler.
+    fileInput.addEventListener('change', () => {
+        const picked = Array.from(fileInput.files || []);
+        for (const file of picked) selectedFiles.push(file);
+        fileInput.value = '';   // allow re-selecting the same file later
+        renderAttachments();
+        refreshSendState();
+    });
+
+    async function uploadFiles(files) {
+        const form = new FormData();
+        files.forEach(f => form.append('files', f, f.name));
+        const res = await fetch('/api/upload', { method: 'POST', body: form });
+        if (!res.ok) {
+            let detail = '';
+            try { detail = (await res.json()).error || ''; } catch (e) { /* ignore */ }
+            throw new Error(detail || `Upload failed (${res.status})`);
+        }
+        const { files: saved } = await res.json();
+        return saved;   // [{path, name}, ...]
+    }
+
     // ---- send ----
-    function send() {
+    async function send() {
         const text = inputEl.value.trim();
-        if (!text || !ws || ws.readyState !== WebSocket.OPEN) return;
-        appendMessage(text, 'user');
-        ws.send(JSON.stringify({ type: 'message', content: text }));
+        const files = selectedFiles.slice();
+        if (sendBtn.disabled) return;
+
+        let uploaded = [];
+        if (files.length) {
+            sendBtn.disabled = true;
+            try {
+                uploaded = await uploadFiles(files);
+            } catch (e) {
+                appendMessage('Attachment upload failed: ' + e.message, 'system');
+                refreshSendState();
+                return;
+            }
+        }
+
+        const payload = { type: 'message', content: text };
+        if (uploaded.length) payload.files = uploaded.map(f => f.path);
+        try {
+            ws.send(JSON.stringify(payload));
+        } catch (err) {
+            appendMessage('Send failed: disconnected (please retry).', 'system');
+            refreshSendState();
+            return;
+        }
+
+        appendMessage(renderUserContent(text, files), 'user');
+        selectedFiles = [];
+        renderAttachments();
         inputEl.value = '';
         inputEl.style.height = '42px';
+        refreshSendState();
+
         if (text === '/new') {
             clearMessages();
         } else if (/^\/load\s+\d+/.test(text)) {
@@ -232,6 +328,12 @@
         }
     }
 
+    function renderUserContent(text, files) {
+        if (!files.length) return text;
+        const tags = files.map(f => `📎 ${f.name}`).join('  ');
+        return text ? `${text}\n\n${tags}` : tags;
+    }
+
     sendBtn.addEventListener('click', send);
     inputEl.addEventListener('keydown', (e) => {
         if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); send(); }
@@ -239,6 +341,7 @@
     inputEl.addEventListener('input', () => {
         inputEl.style.height = 'auto';
         inputEl.style.height = Math.min(inputEl.scrollHeight, 160) + 'px';
+        refreshSendState();
     });
 
     // sidebar pre-populate (messages already loaded via ws.onopen → loadConversations(true))
diff --git a/app/channels/web_channel.py b/app/channels/web_channel.py
index bee8d8c..95b89c5 100644
--- a/app/channels/web_channel.py
+++ b/app/channels/web_channel.py
@@ -21,7 +21,7 @@
 import uvicorn
 from pathlib import Path
 from fasthtml.common import (
-    Button, Div, Head, Html, Link, Meta, Script, Span,
+    Button, Div, Head, Html, Input, Label, Link, Meta, NotStr, Script, Span,
     Textarea, Title, Body, H1, P, fast_app,
 )
 from starlette.routing import WebSocketRoute
@@ -38,6 +38,20 @@
 # FastHTML page builder                                                        #
 # --------------------------------------------------------------------------- #
 
+# Bump when web_channel.css / web_channel.js change, so browsers (Edge caches
+# static assets aggressively) fetch the new copy instead of a stale one.
+_ASSET_VERSION = "3"
+
+# Paperclip icon for the attach button (inline so it inherits theme colors).
+_PAPERCLIP_SVG = (
+    '<svg viewBox="0 0 24 24" width="20" height="20" fill="none" '
+    'stroke="currentColor" stroke-width="2" stroke-linecap="round" '
+    'stroke-linejoin="round" aria-hidden="true">'
+    '<path d="M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 '
+    '5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48"/></svg>'
+)
+
+
 def _build_page() -> Html:
     return Html(
         Head(
@@ -47,7 +61,7 @@ def _build_page() -> Html:
             Link(rel="preconnect", href="https://fonts.googleapis.com"),
             Link(rel="stylesheet",
                  href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap"),
-            Link(rel="stylesheet", href="/static/web_channel.css"),
+            Link(rel="stylesheet", href=f"/static/web_channel.css?v={_ASSET_VERSION}"),
         ),
         Body(
             Div(
@@ -100,8 +114,36 @@ def _build_page() -> Html:
                             Div(Div(Span(), Span(), Span(), cls="dots"), cls="thinking-bubble"),
                             id="thinking",
                         ),
+                        # Selected-attachment preview chips (populated by JS)
+                        Div(id="attachments"),
                         # Input area
                         Div(
+                            # Hidden native file picker. A <label for> (not a JS
+                            # click) opens it — native label activation works
+                            # consistently across browsers (Edge included),
+                            # whereas calling input.click() on a display:none
+                            # input is unreliable in Edge. Hide it with an inline
+                            # visually-hidden style (not display:none, and not an
+                            # external CSS class): display:none suppresses the
+                            # `change` event in Edge, and an inline style can't be
+                            # defeated by a stale cached stylesheet.
+                            Input(
+                                type="file",
+                                id="file-input",
+                                multiple=True,
+                                cls="visually-hidden",
+                                style=(
+                                    "position:absolute;width:1px;height:1px;"
+                                    "padding:0;margin:-1px;overflow:hidden;"
+                                    "clip:rect(0,0,0,0);white-space:nowrap;border:0"
+                                ),
+                            ),
+                            Label(
+                                NotStr(_PAPERCLIP_SVG),
+                                id="attach-btn",
+                                title="Attach files",
+                                **{"for": "file-input"},
+                            ),
                             Textarea(
                                 id="msg-input",
                                 placeholder="Message anotherbot…  (Enter to send, Shift+Enter for newline)",
@@ -117,7 +159,7 @@ def _build_page() -> Html:
                 ),
                 id="app",
             ),
-            Script(src="/static/web_channel.js"),
+            Script(src=f"/static/web_channel.js?v={_ASSET_VERSION}"),
         ),
         lang="en",
     )
@@ -148,8 +190,14 @@ def __init__(
         self._connections: dict[str, WebSocket] = {}
         self._send_locks: dict[str, asyncio.Lock] = {}
         self._conn_lock = asyncio.Lock()
+        from .. import config as _cfg
+        self._upload_dir = _cfg.PROJECT_HOME / "uploads"
         mq.register(self, self.send_message)
 
+    # Cap on a single multipart upload request (combined across files). The
+    # agent enforces its own per-message limit when building the LLM payload.
+    _MAX_UPLOAD_BYTES = 5 * 1024 * 1024  # 5 MB
+
     # -- Channel ABC --------------------------------------------------------
 
     @property
@@ -221,6 +269,58 @@ def status_api(req):
             model = _rt.get("model", _cfg.get("model", "AI"))
             return JSONResponse({"model": model})
 
+        @rt("/api/upload", methods=["POST"])
+        async def upload_api(req):
+            """Accept one or more multipart files and store them on disk.
+
+            Returns the server-side basenames the browser then references in
+            its WebSocket ``message`` frame via the ``files`` field.  Files are
+            written under ``$ANOTHERBOT_HOME/uploads`` with a UUID prefix so
+            concurrent clients never collide.
+            """
+            from starlette.responses import JSONResponse, Response
+            form = await req.form()
+            uploads = [f for f in form.getlist("files") if getattr(f, "filename", None)]
+            if not uploads:
+                return Response("No files provided", status_code=400)
+
+            self._upload_dir.mkdir(parents=True, exist_ok=True)
+            saved: list[dict] = []
+            total = 0
+            try:
+                for uf in uploads:
+                    name = Path(uf.filename).name
+                    stored = f"{uuid.uuid4().hex}_{name}"
+                    out_path = self._upload_dir / stored
+                    too_large = False
+                    with out_path.open("wb") as out:
+                        while True:
+                            chunk = await uf.read(64 * 1024)
+                            if not chunk:
+                                break
+                            total += len(chunk)
+                            if total > self._MAX_UPLOAD_BYTES:
+                                too_large = True
+                                break
+                            out.write(chunk)
+                    if too_large:
+                        out_path.unlink(missing_ok=True)
+                        for s in saved:
+                            (self._upload_dir / s["path"]).unlink(missing_ok=True)
+                        limit_mb = max(1, self._MAX_UPLOAD_BYTES // (1024 * 1024))
+                        return JSONResponse(
+                            {"error": f"Upload exceeds {limit_mb} MB limit"},
+                            status_code=413,
+                        )
+                    saved.append({"path": stored, "name": name})
+            finally:
+                for uf in uploads:
+                    close = getattr(uf, "close", None)
+                    if close:
+                        await close()
+
+            return JSONResponse({"files": saved})
+
         # Starlette WebSocket route (low-level, for multi-client management)
         async def _ws_endpoint(ws: WebSocket) -> None:
             await ws.accept()
@@ -237,15 +337,14 @@ async def _ws_endpoint(ws: WebSocket) -> None:
                     if len(raw) > 65_536:
                         await ws.close(code=1009, reason="Message too large")
                         return
-                    content = self._extract_content(raw)
-                    if not content:
+                    content, files = self._extract_message(raw)
+                    if not content and not files:
                         continue
 
-                    if content.startswith("/"):
+                    is_command = bool(content and content.startswith("/"))
+                    if is_command:
                         cmd = content[1:].split(maxsplit=1)
-                        if not cmd:
-                            continue
-                        name = cmd[0].lower()
+                        name = cmd[0].lower() if cmd else ""
                         # /whoami is handled inline — it needs the per-connection client_id.
                         # All other commands (/help, /status, /stop, /new, /load, …) are
                         # forwarded to BackgroundAgent's CommandRegistry for consistency
@@ -257,14 +356,18 @@ async def _ws_endpoint(ws: WebSocket) -> None:
                             )
                             continue
 
+                    metadata = {
+                        "websocket_id": client_id,
+                        "is_command": is_command,
+                    }
+                    if files:
+                        metadata["files"] = files
+
                     await self.mq.incoming.put(
                         IncomingMessage(
-                            content=content,
+                            content=content or "",
                             channel=ChannelType.WEB,
-                            metadata={
-                                "websocket_id": client_id,
-                                "is_command": content.startswith("/"),
-                            },
+                            metadata=metadata,
                         )
                     )
             except WebSocketDisconnect:
@@ -333,6 +436,47 @@ def _extract_content(raw: str) -> str | None:
             return str(data.get("content") or "").strip() or None
         return raw
 
+    def _extract_message(self, raw: str) -> tuple[str | None, list[str]]:
+        """Parse a raw WebSocket frame into (text, attachment_paths).
+
+        ``files`` is a list of basenames the browser received from
+        ``/api/upload``; each is resolved against the upload dir and dropped
+        if it escapes that dir or no longer exists.
+        """
+        stripped = raw.strip()
+        if not stripped:
+            return None, []
+
+        try:
+            data = json.loads(stripped)
+        except (json.JSONDecodeError, TypeError):
+            return stripped, []
+
+        if isinstance(data, dict) and data.get("type") == "message":
+            content = str(data.get("content") or "").strip() or None
+            files = self._resolve_upload_paths(data.get("files"))
+            return content, files
+
+        return stripped, []
+
+    def _resolve_upload_paths(self, names: object) -> list[str]:
+        """Map client-supplied upload basenames to validated absolute paths.
+
+        Only the basename is honoured (joined to the upload dir), so a client
+        can never reference files outside ``self._upload_dir``.
+        """
+        if not isinstance(names, list):
+            return []
+        upload_dir = self._upload_dir.resolve()
+        resolved: list[str] = []
+        for name in names:
+            if not isinstance(name, str) or not name:
+                continue
+            candidate = (upload_dir / Path(name).name).resolve()
+            if candidate.parent == upload_dir and candidate.is_file():
+                resolved.append(str(candidate))
+        return resolved
+
     async def _safe_send_json(self, client_id: str, payload: dict) -> None:
         async with self._conn_lock:
             ws = self._connections.get(client_id)
diff --git a/app/cli/cli_agent.py b/app/cli/cli_agent.py
index ba229a7..307b513 100755
--- a/app/cli/cli_agent.py
+++ b/app/cli/cli_agent.py
@@ -2,7 +2,7 @@
 
 import asyncio
 
-from ..core.tool_calls import all_tool_specs
+from ..core.tool_calls import get_all_tool_specs
 from .cli import ask_permission
 from ..core.agent import Agent, MAX_CONTEXT_MESSAGES, get_default_sys_prompt
 from ..core import runtime
@@ -53,7 +53,10 @@ async def _on_response(self, content: str | None) -> None:
 
     async def agent_loop(self, message: str, metadata: dict = None) -> str:
         self._trim_messages()
-        self.history.add_message("user", message, self.conversation_id)
+        attachments = self._as_list((metadata or {}).get("files"))
+        user_msg = self._build_user_message(message, metadata)
+        placeholder_content = self._build_placeholder_content(message, attachments)
+        self.history.add_message("user", placeholder_content, self.conversation_id)
 
         conv = self._store.get(self.conversation_id)
         system_context = get_default_sys_prompt({
@@ -62,11 +65,15 @@ async def agent_loop(self, message: str, metadata: dict = None) -> str:
             "conversation_name": conv["name"] if conv else "New Conversation",
         })
         system = [{"role": "system", "content": system_context}] if system_context else []
-        session_messages = system + self.messages[:] + [{"role": "user", "content": message}]
+        session_messages = system + self.messages[:] + [user_msg]
 
-        final_content = await self._loop(session_messages, all_tool_specs)
+        final_content = await self._loop(session_messages, get_all_tool_specs())
 
-        self.messages.append({"role": "user", "content": message})
+        if runtime.get("trace"):
+            from ..infra.tracer import write_trace
+            write_trace(session_messages, runtime.get("tracedir"), runtime.get("model", "unknown"))
+
+        self.messages.append({"role": "user", "content": placeholder_content})
         self.messages.append({"role": "assistant", "content": final_content})
         self.history.add_message("assistant", final_content, self.conversation_id)
         self._store.touch(self.conversation_id)
diff --git a/app/core/agent.py b/app/core/agent.py
index a8b0244..fc66266 100755
--- a/app/core/agent.py
+++ b/app/core/agent.py
@@ -1,5 +1,7 @@
 import asyncio
+import base64
 import json
+import mimetypes
 import os
 import platform
 import re
@@ -19,9 +21,6 @@ def _slugify(name: str) -> str:
     return re.sub(r"[^a-z0-9-]", "", name.strip().lower().replace(" ", "-"))[:40]
 
 
-TOOL_RESULT_HISTORY_LIMIT = 100
-
-
 def get_default_sys_prompt(context: dict | None = None) -> str:
     ctx = context or {}
     channel = ctx.get("channel", "cli")
@@ -75,12 +74,93 @@ def _serialize_assistant_msg(msg) -> dict:
         d = {"role": msg.role, "content": msg.content}
         if msg.tool_calls:
             d["tool_calls"] = [tc.model_dump() for tc in msg.tool_calls]
-            raw = msg.model_dump()
-            reasoning = raw.get("reasoning_content") or raw.get("reasoning")
-            if reasoning:
-                d["reasoning_content"] = reasoning
+        raw = msg.model_dump()
+        reasoning = raw.get("reasoning_content") or raw.get("reasoning")
+        if reasoning:
+            d["reasoning_content"] = reasoning
         return d
 
+
+    @staticmethod
+    def _as_list(value) -> list:
+        if value is None:
+            return []
+        if isinstance(value, (str, os.PathLike)):
+            return [value]
+        if isinstance(value, (list, tuple)):
+            for item in value:
+                if not isinstance(item, (str, os.PathLike)):
+                    raise TypeError(
+                        f"metadata['files'] entries must be paths, got {type(item).__name__}"
+                    )
+            return list(value)
+        raise TypeError(f"metadata['files'] must be a path or list of paths, got {type(value).__name__}")
+
+    _MAX_COMBINED_ATTACHMENT_BYTES = 5 * 1024 * 1024  # 5 MB combined across all attachments
+
+    @classmethod
+    def _attachment_part(cls, attachment: str) -> dict:
+        path = Path(attachment).expanduser()
+        if not path.is_file():
+            raise FileNotFoundError(f"Attachment not found: {path}")
+
+        mime_type = mimetypes.guess_type(path.name)[0] or "application/octet-stream"
+        try:
+            raw = path.read_bytes()
+        except PermissionError as e:
+            raise PermissionError(f"Cannot read attachment: {path}") from e
+
+        data_url = f"data:{mime_type};base64,{base64.b64encode(raw).decode('ascii')}"
+
+        if mime_type.startswith("image/"):
+            return {
+                "type": "image_url",
+                "image_url": {"url": data_url},
+            }
+
+        return {
+            "type": "file",
+            "file": {
+                "filename": path.name,
+                "file_data": data_url,
+            },
+        }
+
+    @classmethod
+    def _build_user_message(cls, message: str, metadata: dict | None = None) -> dict:
+        metadata = metadata or {}
+        attachments = cls._as_list(metadata.get("files"))
+        if not attachments:
+            return {"role": "user", "content": message}
+
+        # Validate every path and accumulate size before encoding anything,
+        # so a bad path always raises the same clear error regardless of order.
+        total_size = 0
+        for a in attachments:
+            p = Path(a).expanduser()
+            if not p.is_file():
+                raise FileNotFoundError(f"Attachment not found: {p}")
+            try:
+                total_size += p.stat().st_size
+            except PermissionError as e:
+                raise PermissionError(f"Cannot stat attachment: {p}") from e
+        if total_size > cls._MAX_COMBINED_ATTACHMENT_BYTES:
+            raise ValueError(
+                f"Total attachment size {total_size / 1024 / 1024:.1f} MB exceeds "
+                f"{cls._MAX_COMBINED_ATTACHMENT_BYTES / 1024 / 1024:.0f} MB combined limit"
+            )
+
+        content = [{"type": "text", "text": message}]
+        content.extend(cls._attachment_part(str(a)) for a in attachments)
+        return {"role": "user", "content": content}
+
+    @staticmethod
+    def _build_placeholder_content(message: str, attachments: list) -> str:
+        if not attachments:
+            return message
+        placeholders = " ".join(f"[Attachment: {a}]" for a in attachments)
+        return f"{message} {placeholders}"
+
     # --- hooks ---
 
     async def _on_thinking(self, content: str | None) -> None:
@@ -127,14 +207,14 @@ async def _auto_name(self, store, conv_id: int, messages: list[dict], name_runti
     # --- shared tool dispatch ---
 
     async def handle_tool_call(self, tool_call) -> str:
-        from .tool_calls import run_tool  # lazy — tool_calls imports scheduled_tasks which imports Agent
+        from .tool_calls import run_tool_async  # lazy — tool_calls imports scheduled_tasks which imports Agent
         tool_name = tool_call.function.name
         try:
-            tool_args = json.loads(tool_call.function.arguments)
+            tool_args = json.loads((tool_call.function.arguments or "").strip() or "{}")
             if not await self._check_permission(tool_name, tool_args):
                 return "User denied permission to run this tool. Ask for permission to run the tool again if you want to try running it."
             await self._on_tool_start(tool_name, tool_args)
-            return run_tool(tool_name=tool_name, tool_args=tool_args)
+            return await run_tool_async(tool_name=tool_name, tool_args=tool_args)
         except Exception as e:
             error_msg = f"Error running tool {tool_name}: {str(e)}"
             log.error(error_msg)
@@ -175,10 +255,11 @@ async def _loop(self, messages: list, tool_specs: list) -> str:
                     messages.append({"role": "tool", "tool_call_id": tc.id, "name": tc.function.name, "content": result})
                     log.info(f"{result[:250]}...")
             else:
+                messages.append(self._serialize_assistant_msg(assistant_message))
                 await self._on_response(assistant_message.content)
-                if finish_reason == "stop":
-                    messages.append(self._serialize_assistant_msg(assistant_message))
-                    break
+                if finish_reason not in ("stop", "length") and finish_reason is not None:
+                    log.warning(f"Unexpected finish_reason={finish_reason!r}, treating as terminal")
+                break
 
             if self._should_stop():
                 break
diff --git a/app/core/background_agent.py b/app/core/background_agent.py
index 0efa8d9..a75a967 100755
--- a/app/core/background_agent.py
+++ b/app/core/background_agent.py
@@ -2,7 +2,7 @@
 
 import asyncio
 
-from .tool_calls import all_tool_specs
+from .tool_calls import get_all_tool_specs
 from ..infra.app_logging import log
 from ..channels.channel import Channel
 from ..channels.message import OutgoingMessage
@@ -45,13 +45,15 @@ def __init__(self, mq: MessageQueue = None, channel: Channel = None, max_iterati
         # Lazy import to avoid circular: commands imports runtime which is fine,
         # but conversation commands need self reference so we build registry here.
         from ..channels.commands import (
-            CommandRegistry, BotCommand, help_cmd, make_status_cmd, model_cmd,
+            CommandRegistry, BotCommand, help_cmd, make_status_cmd, model_cmd, trace_cmd,
             list_conversations_cmd, new_conversation_cmd, load_conversation_cmd,
             fork_conversation_cmd, rename_conversation_cmd, export_conversation_cmd,
+            mcp_cmd,
         )
         self.registry = CommandRegistry()
         ch = self._channel_str
         self.registry.register(BotCommand("model",  "Get or set model. Usage: /model [name]", model_cmd))
+        self.registry.register(BotCommand("trace",  "Toggle LLM tracing. Usage: /trace [on|off]", trace_cmd))
         self.registry.register(BotCommand("status", "Show bot status.", make_status_cmd(ch)))
         self.registry.register(BotCommand("stop",   "Pause the bot.", self._stop_cmd))
         self.registry.register(BotCommand("list",   "List conversations.", list_conversations_cmd(self._store, ch)))
@@ -60,6 +62,7 @@ def __init__(self, mq: MessageQueue = None, channel: Channel = None, max_iterati
         self.registry.register(BotCommand("fork",   "Fork a conversation. Usage: /fork [id]", fork_conversation_cmd(self)))
         self.registry.register(BotCommand("rename", "Rename a conversation. Usage: /rename <id> <name>", rename_conversation_cmd(self._store, ch)))
         self.registry.register(BotCommand("export", "Export a conversation to JSON. Usage: /export [id]", export_conversation_cmd(self._store, ch)))
+        self.registry.register(BotCommand("mcp",  "Show MCP server status. Usage: /mcp [tools [<server>]]", mcp_cmd()))
         self.registry.register(BotCommand("help", "Show available commands.", help_cmd(self.registry)))
 
     async def _stop_cmd(self, args: str = "") -> str:
@@ -123,7 +126,10 @@ async def agent_loop(self, message: str, metadata: dict = None) -> str:
         self._trim_messages()
         self._empty_retries = 0
         self._reply_metadata = metadata or {}
-        self.history.add_message("user", message, self.conversation_id)
+        attachments = self._as_list((metadata or {}).get("files"))
+        user_msg = self._build_user_message(message, metadata)
+        placeholder_content = self._build_placeholder_content(message, attachments)
+        self.history.add_message("user", placeholder_content, self.conversation_id)
 
         conv = self._store.get(self.conversation_id)
         system_context = get_default_sys_prompt({
@@ -132,13 +138,19 @@ async def agent_loop(self, message: str, metadata: dict = None) -> str:
             "conversation_name": conv["name"] if conv else "New Conversation",
         })
         system = [{"role": "system", "content": system_context}] if system_context else []
-        session_messages = system + self.messages[:] + [{"role": "user", "content": message}]
+        session_messages = system + self.messages[:] + [user_msg]
 
-        final_content = await self._loop(session_messages, all_tool_specs)
+        final_content = await self._loop(session_messages, get_all_tool_specs())
+
+        if runtime.get("trace"):
+            from ..infra.tracer import write_trace
+            path = write_trace(session_messages, runtime.get("tracedir"), runtime.get("model", "unknown"))
+            if path:
+                runtime.set("last_trace", path.name)
 
         self.channel.clear_stopped()
 
-        self.messages.append({"role": "user", "content": message})
+        self.messages.append({"role": "user", "content": placeholder_content})
         self.messages.append({"role": "assistant", "content": final_content})
         self.history.add_message("assistant", final_content, self.conversation_id)
         self._store.touch(self.conversation_id)
diff --git a/app/core/helper_agent.py b/app/core/helper_agent.py
index f70e100..46e8132 100644
--- a/app/core/helper_agent.py
+++ b/app/core/helper_agent.py
@@ -17,5 +17,5 @@ async def run(self, prompt: str) -> str:
 
     async def agent_loop(self, message: str, metadata: dict = None) -> str:
         from .tool_calls import helper_tool_specs  # lazy — avoids circular import via scheduled_tasks
-        self.messages.append({"role": "user", "content": message})
+        self.messages.append(self._build_user_message(message, metadata))
         return await self._loop(self.messages, helper_tool_specs)
diff --git a/app/core/mcp_manager.py b/app/core/mcp_manager.py
new file mode 100644
index 0000000..2bfaeb9
--- /dev/null
+++ b/app/core/mcp_manager.py
@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+import asyncio
+import json
+
+from fastmcp import Client
+from fastmcp.client import StdioTransport
+
+from ..infra.app_logging import log
+from ..infra.helpers import trunc_str_with_ellipsis
+from .tool_calls import MAX_TOOL_RESULT_LENGTH
+
+
+class MCPManager:
+    """Owns persistent FastMCP client connections and their tool catalogs."""
+
+    _SEP = "__"
+
+    def __init__(self) -> None:
+        self._clients: dict[str, Client] = {}
+        self._specs: dict[str, dict] = {}
+        self._server_configs: dict[str, dict] = {}
+
+    async def initialize(self, mcp_servers: dict[str, dict]) -> None:
+        self._server_configs = dict(mcp_servers)
+        await asyncio.gather(*(
+            self._connect_server(n, c)
+            for n, c in mcp_servers.items()
+            if not c.get("disabled")
+        ))
+
+    async def _connect_server(self, name: str, cfg: dict) -> None:
+        if self._SEP in name:
+            log.error(f"MCP server '{name}': invalid name — must not contain '{self._SEP}'.")
+            return
+        try:
+            client = self._build_client(cfg)
+        except Exception as e:
+            log.error(f"MCP server '{name}': invalid config — {e}")
+            return
+        try:
+            await client.__aenter__()
+        except Exception as e:
+            log.error(f"MCP server '{name}': failed to connect — {e}")
+            return
+        try:
+            tools = await client.list_tools()
+            for tool in tools:
+                namespaced = f"{name}{self._SEP}{tool.name}"
+                self._specs[namespaced] = self._to_openai_spec(namespaced, tool)
+            self._clients[name] = client
+            log.info(f"MCP server '{name}': connected, {len(tools)} tool(s) discovered")
+        except Exception as e:
+            log.error(f"MCP server '{name}': failed to initialize — {e}")
+            try:
+                await client.__aexit__(None, None, None)
+            except Exception:
+                pass
+
+    def _build_client(self, cfg: dict) -> Client:
+        if "url" in cfg:
+            return Client(cfg["url"])
+        command = cfg["command"]
+        args = cfg.get("args", [])
+        env = cfg.get("env")
+        cwd = cfg.get("cwd")
+        return Client(StdioTransport(command=command, args=args, env=env, cwd=cwd))
+
+    def _to_openai_spec(self, namespaced_name: str, tool) -> dict:
+        return {
+            "type": "function",
+            "function": {
+                "name": namespaced_name,
+                "description": tool.description or "",
+                "parameters": tool.inputSchema or {"type": "object", "properties": {}},
+            },
+        }
+
+    def get_tool_specs(self) -> list[dict]:
+        return list(self._specs.values())
+
+    def get_server_status(self) -> list[dict]:
+        result = []
+        for name, cfg in self._server_configs.items():
+            prefix = f"{name}{self._SEP}"
+            tool_count = sum(1 for k in self._specs if k.startswith(prefix))
+            transport = "url" if "url" in cfg else "stdio"
+            target = cfg.get("url") or cfg.get("command", "?")
+            result.append({
+                "name": name,
+                "connected": name in self._clients,
+                "disabled": bool(cfg.get("disabled")),
+                "transport": transport,
+                "target": target,
+                "tool_count": tool_count,
+            })
+        return result
+
+    def get_tools_for_server(self, server_name: str) -> list[dict]:
+        prefix = f"{server_name}{self._SEP}"
+        return [spec for k, spec in self._specs.items() if k.startswith(prefix)]
+
+    def is_mcp_tool(self, tool_name: str) -> bool:
+        return tool_name in self._specs
+
+    async def call_tool(self, tool_name: str, tool_args: dict) -> str:
+        server_name, sep, bare_name = tool_name.partition(self._SEP)
+        if not sep:
+            return f"Error: MCP tool '{tool_name}' is not namespaced with '{self._SEP}'."
+        client = self._clients.get(server_name)
+        if client is None:
+            return f"Error: MCP server '{server_name}' is not connected."
+        try:
+            result = await client.call_tool(bare_name, tool_args)
+            return self._result_to_str(result)
+        except Exception as e:
+            log.error(f"MCP tool call failed [{tool_name}]: {e}")
+            return f"Error calling MCP tool {tool_name}: {e}"
+
+    def _result_to_str(self, result) -> str:
+        try:
+            content = getattr(result, "content", None)
+            if content:
+                texts = [getattr(part, "text", None) for part in content]
+                texts = [t for t in texts if t is not None]
+                if texts:
+                    return trunc_str_with_ellipsis(MAX_TOOL_RESULT_LENGTH, "\n".join(map(str, texts)))
+
+            data = getattr(result, "data", None)
+            if data is not None:
+                return trunc_str_with_ellipsis(MAX_TOOL_RESULT_LENGTH, json.dumps(data))
+        except Exception:
+            pass
+        return trunc_str_with_ellipsis(MAX_TOOL_RESULT_LENGTH, str(result))
+
+    async def shutdown(self) -> None:
+        for name, client in self._clients.items():
+            try:
+                await client.__aexit__(None, None, None)
+                log.info(f"MCP server '{name}': disconnected")
+            except Exception as e:
+                log.warning(f"MCP server '{name}': error during shutdown — {e}")
+        self._clients.clear()
+        self._specs.clear()
+        self._server_configs.clear()
+
+
+mcp_manager = MCPManager()
diff --git a/app/core/sys_instructions.md b/app/core/sys_instructions.md
index 8a82955..a8ce328 100644
--- a/app/core/sys_instructions.md
+++ b/app/core/sys_instructions.md
@@ -50,6 +50,8 @@ Value careful execution, verified results, clear communication, and practical er
 
 The following tools are available. Use them fully and never fake or skip a call.
 
-File and shell: bash, read_file, write_file. Web: web_fetch, websearch_text, websearch_images, websearch_videos, websearch_news, websearch_books, hackernews. Utilities: calculator. Todo: todo_add, todo_list, todo_update, todo_clear.
+File and shell: bash, read_file, write_file. Web: web_fetch, websearch_text, websearch_images, websearch_videos, websearch_news, websearch_books, hackernews. Utilities: calculator. Todo: todo_add, todo_list, todo_update, todo_clear. Helper Agent: helper_agent.
 
-Scheduled tasks run in the background via the background agent. Use add_scheduled_task(name, prompt, interval_minutes, repeat, next_run, delivery_channel) to create one, update_scheduled_task to modify or enable/disable, remove_scheduled_task to delete, list_scheduled_tasks to inspect, and get_scheduled_task_output(name, num_entries) to read recent results. For a repeating task: add_scheduled_task(name="morning-news", prompt="Fetch top 5 HN stories and summarize", interval_minutes=60, repeat=true, delivery_channel="telegram"). For a one-shot task: add_scheduled_task(name="reminder", prompt="Remind user to take a break", repeat=false, next_run="2026-05-04T15:00:00").
\ No newline at end of file
+Scheduled tasks run in the background via the background agent. Use add_scheduled_task(name, prompt, interval_minutes, repeat, next_run, delivery_channel) to create one, update_scheduled_task to modify or enable/disable, remove_scheduled_task to delete, list_scheduled_tasks to inspect, and get_scheduled_task_output(name, num_entries) to read recent results. For a repeating task: add_scheduled_task(name="morning-news", prompt="Fetch top 5 HN stories and summarize", interval_minutes=60, repeat=true, delivery_channel="telegram"). For a one-shot task: add_scheduled_task(name="reminder", prompt="Remind user to take a break", repeat=false, next_run="2026-05-04T15:00:00").
+
+Helper Agent: helper_agent(prompt, system_prompt) runs a helper agent session to perform a task or research. The helper has a subset of tools (e.g. read_file, write_file, bash, web_fetch, calculator, hackernews, websearch_text, get_city_state, get_datetime) but no scheduled task mutation capabilities. Use it to delegate sub-tasks, run calculations, or research in a clean environment without cluttering your main conversation context.
diff --git a/app/core/tool_calls.py b/app/core/tool_calls.py
index 9a508d6..14027fc 100755
--- a/app/core/tool_calls.py
+++ b/app/core/tool_calls.py
@@ -1,3 +1,4 @@
+import asyncio
 import os
 
 from ..infra.app_logging import log
@@ -22,6 +23,7 @@
 
 from ..tools.get_city_state import GetCityState
 from ..tools.get_datetime import GetDateTime
+from ..tools.helper_agent import HelperAgentTool
 
 import json
 
@@ -53,7 +55,8 @@
     "get_scheduled_task_output": GetScheduledTaskOutput,
 
     "get_city_state": GetCityState,
-    "get_datetime": GetDateTime
+    "get_datetime": GetDateTime,
+    "helper_agent": HelperAgentTool
 }
 
 all_tool_specs = [tool.spec() for tool in tool_registry.values()]
@@ -65,12 +68,27 @@
 
 MAX_TOOL_RESULT_LENGTH = 16000
 
-def run_tool(tool_name: str, tool_args: dict) -> str:
+
+def get_all_tool_specs() -> list[dict]:
+    from .mcp_manager import mcp_manager
+    return all_tool_specs + mcp_manager.get_tool_specs()
+
+
+async def run_tool_async(tool_name: str, tool_args: dict) -> str:
+    from .mcp_manager import mcp_manager
+    if mcp_manager.is_mcp_tool(tool_name):
+        return await mcp_manager.call_tool(tool_name, tool_args)
+    return await run_tool(tool_name=tool_name, tool_args=tool_args)
+
+
+async def run_tool(tool_name: str, tool_args: dict) -> str:
     original_cwd = os.getcwd()
     
     try:
         func = tool_registry[tool_name].call
         result = func(**tool_args)
+        if asyncio.iscoroutine(result):
+            result = await result
     except Exception as e:
         log.error(f"Error running tool {tool_name}: {str(e)}")
         result = f"Error running tool {tool_name}: {str(e)}"
diff --git a/app/infra/message_history.py b/app/infra/message_history.py
index cfbc930..9ab15ca 100755
--- a/app/infra/message_history.py
+++ b/app/infra/message_history.py
@@ -68,5 +68,4 @@ def get_history(self, limit: int = 100) -> list[dict]:
                                     ORDER BY id DESC LIMIT ?""", (self.channel, limit)).fetchall()
             return [{"role": row[0], "content": row[1]} for row in reversed(rows)]
 
-    def prune_old_messages(self, older_than_days: int) -> None:
-        pass
+
diff --git a/app/infra/setup.py b/app/infra/setup.py
index 3a29fec..338a342 100755
--- a/app/infra/setup.py
+++ b/app/infra/setup.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from ..config import get_default_config, APP_NAME, APP_DB
+from ..config import get_default_config, APP_NAME
 from .app_logging import log
 
 def ensure_home_dir() -> None:
diff --git a/app/infra/tracer.py b/app/infra/tracer.py
new file mode 100644
index 0000000..87475ff
--- /dev/null
+++ b/app/infra/tracer.py
@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+import json
+import logging
+from datetime import datetime
+from pathlib import Path
+
+log = logging.getLogger(__name__)
+
+
+def write_trace(messages: list, tracedir: Path, model: str) -> Path | None:
+    try:
+        tracedir.mkdir(parents=True, exist_ok=True)
+        ts = datetime.now().strftime("%m%d%Y_%H%M%S")
+        path = tracedir / f"trace_{ts}.json"
+        data = {
+            "timestamp": datetime.now().isoformat(),
+            "model": model,
+            "messages": messages,
+        }
+        with open(path, "w", encoding="utf-8") as f:
+            json.dump(data, f, indent=2, default=str)
+        log.info(f"Trace written to {path}")
+        return path
+    except Exception as e:
+        log.warning(f"Failed to write trace: {e}")
+        return None
diff --git a/app/main.py b/app/main.py
index b565190..54da01c 100755
--- a/app/main.py
+++ b/app/main.py
@@ -4,6 +4,7 @@
 import asyncio
 import logging
 import os
+from pathlib import Path
 
 from . import config
 from .infra.app_logging import setup_logging, log
@@ -16,6 +17,38 @@
 from dotenv import load_dotenv
 load_dotenv()
 
+async def initialize_mcp() -> None:
+    import json
+    from pathlib import Path
+    mcp_config_path = Path(config.PROJECT_HOME) / "mcp_servers.json"
+    if not mcp_config_path.exists():
+        return
+    try:
+        with open(mcp_config_path, encoding="utf-8") as f:
+            data = json.load(f)
+    except Exception as e:
+        log.error(f"Failed to load mcp_servers.json: {e}")
+        return
+
+    if not isinstance(data, dict):
+        log.error("mcp_servers.json must contain a JSON object at the top level.")
+        return
+
+    mcp_servers = data.get("mcpServers")
+    if not mcp_servers:
+        return
+    if not isinstance(mcp_servers, dict):
+        log.error("mcp_servers.json: 'mcpServers' must be a JSON object mapping server names to configs.")
+        return
+
+    from .core.mcp_manager import mcp_manager
+    log.info(f"Initializing {len(mcp_servers)} MCP server(s)...")
+    try:
+        await mcp_manager.initialize(mcp_servers)
+    except Exception as e:
+        log.error(f"Failed to initialize MCP servers: {e}")
+
+
 async def load_config() -> None:
     try:
         config.load()
@@ -28,6 +61,10 @@ async def load_config() -> None:
 
 def parse_args():
     parser = argparse.ArgumentParser(prog="app")
+    parser.add_argument("--trace", action="store_true", default=False,
+                        help="Enable LLM call tracing")
+    parser.add_argument("--tracedir", default=str(config.PROJECT_HOME / "trace"), metavar="DIR",
+                        help="Trace output directory (default: ~/.crafterscode/trace)")
     subparsers = parser.add_subparsers(dest="command", required=True)
 
     cli_parser = subparsers.add_parser("cli", help="Run interactive CLI")
@@ -74,19 +111,22 @@ async def run_cli(args):
         return
 
     from .channels.commands import (
-        CommandRegistry, BotCommand, make_status_cmd, help_cmd, model_cmd,
+        CommandRegistry, BotCommand, make_status_cmd, help_cmd, model_cmd, trace_cmd,
         list_conversations_cmd, new_conversation_cmd, load_conversation_cmd,
         fork_conversation_cmd, rename_conversation_cmd, export_conversation_cmd,
+        mcp_cmd,
     )
     cli_registry = CommandRegistry()
     cli_registry.register(BotCommand("status",               "Show bot status.",                        make_status_cmd()))
     cli_registry.register(BotCommand("model",                "Get or set model. Usage: /model [name]",  model_cmd))
+    cli_registry.register(BotCommand("trace",               "Toggle LLM tracing. Usage: /trace [on|off]", trace_cmd))
     cli_registry.register(BotCommand("list",   "List conversations.",                      list_conversations_cmd(agent._store, agent._channel_str)))
     cli_registry.register(BotCommand("new",    "Start a new conversation.",                new_conversation_cmd(agent)))
     cli_registry.register(BotCommand("load",   "Load a conversation. Usage: /load <id>",   load_conversation_cmd(agent)))
     cli_registry.register(BotCommand("fork",   "Fork a conversation. Usage: /fork [id]",   fork_conversation_cmd(agent)))
     cli_registry.register(BotCommand("rename", "Rename a conversation. Usage: /rename <id> <name>", rename_conversation_cmd(agent._store, agent._channel_str)))
     cli_registry.register(BotCommand("export", "Export a conversation to JSON. Usage: /export [id]", export_conversation_cmd(agent._store, agent._channel_str)))
+    cli_registry.register(BotCommand("mcp",  "Show MCP server status. Usage: /mcp [tools [<server>]]", mcp_cmd()))
     cli_registry.register(BotCommand("help",                 "Show available commands.",                 help_cmd(cli_registry)))
 
     try:
@@ -113,7 +153,7 @@ async def run_background_agent(args):
 async def main():
     
     ensure_home_dir()
-    
+
     await load_config()
     setup_logging(level=logging.INFO)
 
@@ -121,13 +161,20 @@ async def main():
 
     runtime.set("model",  config.get("model", "deepseek/deepseek-v4-flash"))
     runtime.set("max_iterations", args.max_iterations)
+    runtime.set("trace", args.trace)
+    runtime.set("tracedir", Path(args.tracedir))
 
-    if args.command == "cli":
-        await run_cli(args)
-    elif args.command == "background":
-        await run_background_agent(args)
-    else:
-        raise ValueError(f"Unknown command: {args.command}")
+    from .core.mcp_manager import mcp_manager
+    try:
+        await initialize_mcp()
+        if args.command == "cli":
+            await run_cli(args)
+        elif args.command == "background":
+            await run_background_agent(args)
+        else:
+            raise ValueError(f"Unknown command: {args.command}")
+    finally:
+        await mcp_manager.shutdown()
     
     
 if __name__ == "__main__":
diff --git a/app/tools/helper_agent.py b/app/tools/helper_agent.py
new file mode 100755
index 0000000..5315d31
--- /dev/null
+++ b/app/tools/helper_agent.py
@@ -0,0 +1,35 @@
+from ..core.tool import Tool
+from ..infra.app_logging import log
+
+class HelperAgentTool(Tool):
+
+    @staticmethod
+    def spec():
+        return {
+            "type": "function",
+            "function": {
+                "name": "helper_agent",
+                "description": "Run a helper agent to perform a task or research. Use this to delegate sub-tasks.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "prompt": {
+                            "type": "string",
+                            "description": "The prompt or task instructions for the helper agent."
+                        },
+                        "system_prompt": {
+                            "type": "string",
+                            "description": "Optional system instructions to define the role, guidelines, or constraints for the helper agent."
+                        }
+                    },
+                    "required": ["prompt"]
+                }
+            }
+        }
+
+    @staticmethod
+    async def call(prompt: str, system_prompt: str = None) -> str:
+        log.info(f"helper_agent tool called with prompt: {prompt}")
+        from ..core.helper_agent import HelperAgent
+        agent = HelperAgent(system_prompt=system_prompt)
+        return await agent.run(prompt)
diff --git a/pyproject.toml b/pyproject.toml
index e5803a7..ec97fbf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -13,6 +13,7 @@ dependencies = [
     "python-fasthtml>=0.14.2",
     "uvicorn[standard]>=0.48.0",
     "slack-bolt>=1.18.0",
+    "fastmcp>=2.0",
 ]
 
 [dependency-groups]
diff --git a/tests/test_agent.py b/tests/test_agent.py
index 4cd818f..df5b652 100644
--- a/tests/test_agent.py
+++ b/tests/test_agent.py
@@ -70,7 +70,7 @@ async def test_agent_loop_sends_system_context_to_llm():
     agent, mock_client = make_agent()
     with patch("app.cli.cli_agent.get_default_sys_prompt", return_value="system prompt"):
         await agent.agent_loop("hello")
-    call_messages = mock_client.chat.completions.create.call_args[1]["messages"]
+    call_messages = mock_client.chat.completions.create.call_args_list[0][1]["messages"]
     assert call_messages[0]["role"] == "system"
     assert call_messages[0]["content"] == "system prompt"
 
@@ -190,7 +190,7 @@ async def test_agent_loop_runs_tool_when_auto_approve():
 
 
 @pytest.mark.asyncio
-async def test_agent_loop_continues_when_finish_reason_not_stop():
+async def test_agent_loop_breaks_on_length_finish_reason():
     with patch("app.core.agent.Client") as MockClient:
         mock_client = MagicMock()
         MockClient.return_value.get_client.return_value = mock_client
@@ -210,23 +210,33 @@ async def test_agent_loop_continues_when_finish_reason_not_stop():
     response_partial = MagicMock()
     response_partial.choices = [choice_partial]
 
-    msg_final = MagicMock()
-    msg_final.tool_calls = None
-    msg_final.content = "final"
-    msg_final.model_dump.return_value = {"role": "assistant", "content": "final"}
-    choice_final = MagicMock()
-    choice_final.message = msg_final
-    choice_final.finish_reason = "stop"
-    response_final = MagicMock()
-    response_final.choices = [choice_final]
+    mock_client.chat.completions.create = AsyncMock(return_value=response_partial)
 
-    mock_client.chat.completions.create = AsyncMock(
-        side_effect=[response_partial, response_final]
-    )
+    result = await agent.agent_loop("continue")
+
+    assert mock_client.chat.completions.create.call_count == 1
+    assert result == "partial"
 
-    await agent.agent_loop("continue")
 
-    assert mock_client.chat.completions.create.call_count == 2
+@pytest.mark.asyncio
+async def test_agent_loop_calls_write_trace_when_enabled(tmp_path):
+    agent, _ = make_agent()
+    fake_path = tmp_path / "trace_01012026_120000.json"
+    with patch("app.core.runtime._store", {"trace": True, "tracedir": tmp_path, "model": "m"}):
+        with patch("app.infra.tracer.write_trace", return_value=fake_path) as mock_write:
+            await agent.agent_loop("hello")
+    mock_write.assert_called_once()
+    args = mock_write.call_args[0]
+    assert args[1] == tmp_path  # tracedir
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_does_not_call_write_trace_when_disabled(tmp_path):
+    agent, _ = make_agent()
+    with patch("app.core.runtime._store", {"trace": False, "tracedir": tmp_path, "model": "m"}):
+        with patch("app.infra.tracer.write_trace") as mock_write:
+            await agent.agent_loop("hello")
+    mock_write.assert_not_called()
 
 
 @pytest.mark.asyncio
@@ -268,3 +278,147 @@ async def test_agent_loop_gathers_multiple_tool_calls_in_parallel():
 
     mock_gather.assert_called_once()
     assert len(mock_gather.call_args[0]) == 2
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_sends_image_file_to_llm(tmp_path):
+    agent, mock_client = make_agent()
+    image_path = tmp_path / "screenshot.png"
+    image_path.write_bytes(b"fake image data")
+
+    await agent.agent_loop("What is in this image?", metadata={"files": [str(image_path)]})
+
+    call_messages = mock_client.chat.completions.create.call_args_list[0][1]["messages"]
+    user_message = call_messages[1]
+    assert user_message["role"] == "user"
+    assert user_message["content"][0] == {"type": "text", "text": "What is in this image?"}
+    assert user_message["content"][1]["type"] == "image_url"
+    assert user_message["content"][1]["image_url"]["url"].startswith("data:image/png;base64,")
+    stored_user_msg = agent.messages[-2]
+    assert stored_user_msg["role"] == "user"
+    assert stored_user_msg["content"] == f"What is in this image? [Attachment: {image_path}]"
+    agent.history.add_message.assert_any_call(
+        "user", f"What is in this image? [Attachment: {image_path}]", agent.conversation_id
+    )
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_accepts_single_metadata_file_path(tmp_path):
+    agent, mock_client = make_agent()
+    image_path = tmp_path / "screenshot.jpg"
+    image_path.write_bytes(b"fake image data")
+
+    await agent.agent_loop("Describe this", metadata={"files": str(image_path)})
+
+    user_message = mock_client.chat.completions.create.call_args_list[0][1]["messages"][1]
+    assert user_message["content"][1]["image_url"]["url"].startswith("data:image/jpeg;base64,")
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_sends_multiple_image_files_to_llm(tmp_path):
+    agent, mock_client = make_agent()
+    png_path = tmp_path / "first.png"
+    jpg_path = tmp_path / "second.jpg"
+    png_path.write_bytes(b"first fake image data")
+    jpg_path.write_bytes(b"second fake image data")
+
+    await agent.agent_loop(
+        "Compare these images",
+        metadata={"files": [str(png_path), str(jpg_path)]},
+    )
+
+    user_message = mock_client.chat.completions.create.call_args_list[0][1]["messages"][1]
+    assert user_message["content"][0] == {"type": "text", "text": "Compare these images"}
+    assert len(user_message["content"]) == 3
+    assert user_message["content"][1]["image_url"]["url"].startswith("data:image/png;base64,")
+    assert user_message["content"][2]["image_url"]["url"].startswith("data:image/jpeg;base64,")
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_sends_metadata_files_to_llm(tmp_path):
+    agent, mock_client = make_agent()
+    file_path = tmp_path / "notes.txt"
+    file_path.write_text("plain text attachment", encoding="utf-8")
+
+    await agent.agent_loop("Summarize this file", metadata={"files": [str(file_path)]})
+
+    user_message = mock_client.chat.completions.create.call_args_list[0][1]["messages"][1]
+    assert user_message["content"][0] == {"type": "text", "text": "Summarize this file"}
+    assert user_message["content"][1]["type"] == "file"
+    assert user_message["content"][1]["file"]["filename"] == "notes.txt"
+    assert user_message["content"][1]["file"]["file_data"].startswith("data:text/plain;base64,")
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_sends_image_files_as_images(tmp_path):
+    agent, mock_client = make_agent()
+    image_path = tmp_path / "diagram.png"
+    file_path = tmp_path / "report.pdf"
+    image_path.write_bytes(b"fake image data")
+    file_path.write_bytes(b"%PDF-1.4 fake pdf data")
+
+    await agent.agent_loop(
+        "Use these attachments",
+        metadata={"files": [str(image_path), str(file_path)]},
+    )
+
+    user_message = mock_client.chat.completions.create.call_args_list[0][1]["messages"][1]
+    assert user_message["content"][1]["type"] == "image_url"
+    assert user_message["content"][1]["image_url"]["url"].startswith("data:image/png;base64,")
+    assert user_message["content"][2]["type"] == "file"
+    assert user_message["content"][2]["file"]["file_data"].startswith("data:application/pdf;base64,")
+
+
+def test_as_list_rejects_non_path_entries():
+    with pytest.raises(TypeError):
+        Agent._as_list([123])
+    with pytest.raises(TypeError):
+        Agent._as_list(123)
+    assert Agent._as_list(["a", "b"]) == ["a", "b"]
+    assert Agent._as_list("a") == ["a"]
+    assert Agent._as_list(None) == []
+
+
+def test_as_list_does_not_silently_drop_empty_string():
+    # Only None means "no attachments"; an empty string path must surface
+    # as a loud failure downstream rather than being dropped.
+    assert Agent._as_list("") == [""]
+
+
+def test_build_user_message_rejects_combined_oversized(tmp_path, monkeypatch):
+    f1 = tmp_path / "a.txt"
+    f2 = tmp_path / "b.txt"
+    f1.write_bytes(b"x" * 60)
+    f2.write_bytes(b"x" * 60)
+    monkeypatch.setattr(Agent, "_MAX_COMBINED_ATTACHMENT_BYTES", 100)
+    with pytest.raises(ValueError, match="combined limit"):
+        Agent._build_user_message("hi", {"files": [str(f1), str(f2)]})
+
+
+def test_build_user_message_does_not_skip_size_check_for_missing_file(tmp_path, monkeypatch):
+    ok = tmp_path / "ok.txt"
+    ok.write_bytes(b"x" * 60)
+    missing = tmp_path / "missing.txt"
+    monkeypatch.setattr(Agent, "_MAX_COMBINED_ATTACHMENT_BYTES", 100)
+    # A missing path must raise FileNotFoundError, not be silently skipped
+    # from the size accounting and fail later with a different error.
+    with pytest.raises(FileNotFoundError):
+        Agent._build_user_message("hi", {"files": [str(ok), str(missing)]})
+
+
+def test_build_placeholder_content():
+    assert Agent._build_placeholder_content("hello", []) == "hello"
+    assert Agent._build_placeholder_content("look", ["/tmp/a.png"]) == "look [Attachment: /tmp/a.png]"
+    assert Agent._build_placeholder_content("check", ["/a.pdf", "/b.png"]) == "check [Attachment: /a.pdf] [Attachment: /b.png]"
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_does_not_persist_history_when_attachment_invalid(tmp_path):
+    agent, mock_client = make_agent()
+    missing = tmp_path / "missing.png"
+
+    with pytest.raises(FileNotFoundError):
+        await agent.agent_loop("look at this", metadata={"files": [str(missing)]})
+
+    agent.history.add_message.assert_not_called()
+    assert agent.messages == []
diff --git a/tests/test_background_agent.py b/tests/test_background_agent.py
index 608e2cd..a089a0e 100644
--- a/tests/test_background_agent.py
+++ b/tests/test_background_agent.py
@@ -307,6 +307,37 @@ async def test_process_incoming_sends_error_to_user_on_agent_loop_failure():
     assert error_msg.metadata == {"chat_id": 99}
 
 
+@pytest.mark.asyncio
+async def test_agent_loop_calls_write_trace_when_enabled(tmp_path):
+    agent, _, _ = make_agent()
+    fake_path = tmp_path / "trace_01012026_120000.json"
+    with patch("app.core.runtime._store", {"trace": True, "tracedir": tmp_path, "model": "m"}):
+        with patch("app.infra.tracer.write_trace", return_value=fake_path) as mock_write:
+            await agent.agent_loop("hello")
+    mock_write.assert_called_once()
+    assert mock_write.call_args[0][1] == tmp_path  # tracedir
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_does_not_call_write_trace_when_disabled(tmp_path):
+    agent, _, _ = make_agent()
+    with patch("app.core.runtime._store", {"trace": False, "tracedir": tmp_path, "model": "m"}):
+        with patch("app.infra.tracer.write_trace") as mock_write:
+            await agent.agent_loop("hello")
+    mock_write.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_agent_loop_sets_last_trace_on_success(tmp_path):
+    agent, _, _ = make_agent()
+    fake_path = tmp_path / "trace_01012026_120000.json"
+    mock_store = {"trace": True, "tracedir": tmp_path, "model": "m"}
+    with patch("app.core.runtime._store", mock_store):
+        with patch("app.infra.tracer.write_trace", return_value=fake_path):
+            await agent.agent_loop("hello")
+    assert mock_store.get("last_trace") == fake_path.name
+
+
 @pytest.mark.asyncio
 async def test_agent_loop_gathers_multiple_tool_calls_in_parallel():
     agent, mock_client, mq = make_agent()
diff --git a/tests/test_commands.py b/tests/test_commands.py
index 02eddef..93b37d6 100644
--- a/tests/test_commands.py
+++ b/tests/test_commands.py
@@ -1,7 +1,8 @@
 import pytest
+from pathlib import Path
 from unittest.mock import AsyncMock, patch
 
-from app.channels.commands import BotCommand, CommandRegistry, status_cmd, help_cmd, model_cmd
+from app.channels.commands import BotCommand, CommandRegistry, status_cmd, help_cmd, model_cmd, trace_cmd
 
 
 def make_registry(*extra: BotCommand) -> CommandRegistry:
@@ -135,3 +136,71 @@ async def test_model_cmd_sets_model():
         result = await model_cmd("new-model")
     assert "new-model" in result
     assert mock_store["model"] == "new-model"
+
+
+# --- trace_cmd ---
+
+@pytest.mark.asyncio
+async def test_trace_cmd_shows_off_when_no_args():
+    with patch("app.core.runtime._store", {"trace": False, "tracedir": Path("/tmp/traces")}):
+        result = await trace_cmd("")
+    assert "off" in result
+
+
+@pytest.mark.asyncio
+async def test_trace_cmd_shows_on_when_no_args():
+    with patch("app.core.runtime._store", {"trace": True, "tracedir": Path("/tmp/traces")}):
+        result = await trace_cmd("")
+    assert "on" in result
+
+
+@pytest.mark.asyncio
+async def test_trace_cmd_on_enables_tracing():
+    mock_store = {"trace": False, "tracedir": Path("/tmp/traces")}
+    with patch("app.core.runtime._store", mock_store):
+        result = await trace_cmd("on")
+    assert mock_store["trace"] is True
+    assert "on" in result.lower()
+
+
+@pytest.mark.asyncio
+async def test_trace_cmd_off_disables_tracing():
+    mock_store = {"trace": True, "tracedir": Path("/tmp/traces")}
+    with patch("app.core.runtime._store", mock_store):
+        result = await trace_cmd("off")
+    assert mock_store["trace"] is False
+    assert "off" in result.lower()
+
+
+@pytest.mark.asyncio
+async def test_trace_cmd_includes_tracedir_in_response():
+    with patch("app.core.runtime._store", {"trace": False, "tracedir": Path("/my/traces")}):
+        result = await trace_cmd("on")
+    assert "/my/traces" in result
+
+
+# --- status_cmd tracing line ---
+
+@pytest.mark.asyncio
+async def test_status_includes_tracing_off():
+    with patch("app.core.runtime._store", {"trace": False, "model": "m"}):
+        result = await status_cmd()
+    assert "Tracing" in result
+    assert "off" in result
+
+
+@pytest.mark.asyncio
+async def test_status_shows_tracing_on_with_filename():
+    mock_store = {"trace": True, "last_trace": "trace_06142026_103045.json", "model": "m"}
+    with patch("app.core.runtime._store", mock_store):
+        result = await status_cmd()
+    assert "on" in result
+    assert "trace_06142026_103045.json" in result
+
+
+@pytest.mark.asyncio
+async def test_status_shows_tracing_on_without_filename():
+    with patch("app.core.runtime._store", {"trace": True, "model": "m"}):
+        result = await status_cmd()
+    assert "Tracing" in result
+    assert "on" in result
diff --git a/tests/test_helper_agent_tool.py b/tests/test_helper_agent_tool.py
new file mode 100755
index 0000000..e49467c
--- /dev/null
+++ b/tests/test_helper_agent_tool.py
@@ -0,0 +1,23 @@
+import pytest
+from unittest.mock import patch, AsyncMock
+from app.tools.helper_agent import HelperAgentTool
+
+
+def test_helper_agent_tool_spec():
+    spec = HelperAgentTool.spec()
+    assert spec["type"] == "function"
+    assert spec["function"]["name"] == "helper_agent"
+    assert "prompt" in spec["function"]["parameters"]["required"]
+
+
+@pytest.mark.asyncio
+async def test_helper_agent_tool_call():
+    mock_helper = AsyncMock()
+    mock_helper.run = AsyncMock(return_value="delegated result")
+
+    with patch("app.core.helper_agent.HelperAgent", return_value=mock_helper) as MockHelperAgent:
+        result = await HelperAgentTool.call(prompt="do something", system_prompt="be helpful")
+        
+        MockHelperAgent.assert_called_once_with(system_prompt="be helpful")
+        mock_helper.run.assert_called_once_with("do something")
+        assert result == "delegated result"
diff --git a/tests/test_main.py b/tests/test_main.py
index e8d6cc7..ceecb03 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -1,9 +1,10 @@
+import json
 import logging
 import pytest
 from unittest.mock import patch, MagicMock, AsyncMock
 
 from app.cli.cli import input_loop
-from app.main import main
+from app.main import main, initialize_mcp
 
 
 # ---------------------------------------------------------------------------
@@ -220,4 +221,85 @@ async def fake_input_loop():
     assert agent_mock.agent_loop.call_count == 3
     agent_mock.agent_loop.assert_any_call("first")
     agent_mock.agent_loop.assert_any_call("second")
-    agent_mock.agent_loop.assert_any_call("third")
\ No newline at end of file
+    agent_mock.agent_loop.assert_any_call("third")
+
+
+# ---------------------------------------------------------------------------
+# --trace / --tracedir
+# ---------------------------------------------------------------------------
+
+@pytest.mark.asyncio
+async def test_main_trace_defaults_to_false():
+    mock_store = {}
+    agent_mock = MagicMock()
+    agent_mock.agent_loop = AsyncMock()
+    with patch("sys.argv", ["prog", "cli", "-p", "hi", "--no-repl"]), \
+         patch("app.main.CliAgent", return_value=agent_mock), \
+         patch("app.core.runtime._store", mock_store):
+        await main()
+    assert mock_store.get("trace") is False
+
+
+@pytest.mark.asyncio
+async def test_main_trace_flag_sets_runtime_true(tmp_path):
+    mock_store = {}
+    agent_mock = MagicMock()
+    agent_mock.agent_loop = AsyncMock()
+    with patch("sys.argv", ["prog", "--trace", "--tracedir", str(tmp_path), "cli", "-p", "hi", "--no-repl"]), \
+         patch("app.main.CliAgent", return_value=agent_mock), \
+         patch("app.core.runtime._store", mock_store):
+        await main()
+    assert mock_store.get("trace") is True
+    assert mock_store.get("tracedir") == tmp_path
+
+
+@pytest.mark.asyncio
+async def test_main_tracedir_defaults_to_project_home_trace():
+    mock_store = {}
+    agent_mock = MagicMock()
+    agent_mock.agent_loop = AsyncMock()
+    with patch("sys.argv", ["prog", "cli", "-p", "hi", "--no-repl"]), \
+         patch("app.main.CliAgent", return_value=agent_mock), \
+         patch("app.core.runtime._store", mock_store):
+        await main()
+    assert "trace" in str(mock_store.get("tracedir"))
+
+
+# ---------------------------------------------------------------------------
+# initialize_mcp
+# ---------------------------------------------------------------------------
+
+@pytest.mark.asyncio
+async def test_initialize_mcp_no_op_when_file_missing(tmp_path):
+    mock_mgr = MagicMock()
+    mock_mgr.initialize = AsyncMock()
+    with patch("app.main.config") as mock_cfg, \
+         patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        mock_cfg.PROJECT_HOME = str(tmp_path)
+        await initialize_mcp()
+    mock_mgr.initialize.assert_not_called()
+
+
+@pytest.mark.asyncio
+async def test_initialize_mcp_calls_initialize_with_server_dict(tmp_path):
+    servers = {"mem": {"command": "npx", "args": ["-y", "@mcp/mem"]}}
+    (tmp_path / "mcp_servers.json").write_text(json.dumps({"mcpServers": servers}))
+    mock_mgr = MagicMock()
+    mock_mgr.initialize = AsyncMock()
+    with patch("app.main.config") as mock_cfg, \
+         patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        mock_cfg.PROJECT_HOME = str(tmp_path)
+        await initialize_mcp()
+    mock_mgr.initialize.assert_called_once_with(servers)
+
+
+@pytest.mark.asyncio
+async def test_initialize_mcp_handles_malformed_json(tmp_path):
+    (tmp_path / "mcp_servers.json").write_text("not json{{")
+    mock_mgr = MagicMock()
+    mock_mgr.initialize = AsyncMock()
+    with patch("app.main.config") as mock_cfg, \
+         patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        mock_cfg.PROJECT_HOME = str(tmp_path)
+        await initialize_mcp()  # must not raise
+    mock_mgr.initialize.assert_not_called()
\ No newline at end of file
diff --git a/tests/test_tool_calls.py b/tests/test_tool_calls.py
index 559bcc9..3f08038 100644
--- a/tests/test_tool_calls.py
+++ b/tests/test_tool_calls.py
@@ -1,5 +1,8 @@
 
-from app.core.tool_calls import run_tool, tool_registry
+import pytest
+from unittest.mock import patch, MagicMock, AsyncMock
+
+from app.core.tool_calls import run_tool, tool_registry, all_tool_specs, get_all_tool_specs, run_tool_async
 
 
 def test_tool_registry_contains_expected_tools():
@@ -8,16 +11,69 @@ def test_tool_registry_contains_expected_tools():
     assert "bash" in tool_registry
     assert "web_fetch" in tool_registry
     assert "get_skills_dir" in tool_registry
+    assert "helper_agent" in tool_registry
 
 
-def test_run_tool_calls_correct_function(tmp_path):
+@pytest.mark.asyncio
+async def test_run_tool_calls_correct_function(tmp_path):
     file_path = str(tmp_path / "test.txt")
     with open(file_path, "w", encoding="utf-8") as f:
         f.write("content")
-    result = run_tool("read_file", {"file_path": file_path})
+    result = await run_tool("read_file", {"file_path": file_path})
     assert result == "content"
 
 
-def test_run_tool_unknown_tool_returns_error():
-    result = run_tool("nonexistent_tool", {})
+@pytest.mark.asyncio
+async def test_run_tool_unknown_tool_returns_error():
+    result = await run_tool("nonexistent_tool", {})
     assert "Error" in result
+
+
+# ---------------------------------------------------------------------------
+# get_all_tool_specs
+# ---------------------------------------------------------------------------
+
+def test_get_all_tool_specs_includes_local_tools():
+    mock_mgr = MagicMock()
+    mock_mgr.get_tool_specs.return_value = []
+    with patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        specs = get_all_tool_specs()
+    assert specs == all_tool_specs
+
+
+def test_get_all_tool_specs_merges_mcp_tools():
+    mcp_spec = {"type": "function", "function": {"name": "srv__tool", "description": "", "parameters": {}}}
+    mock_mgr = MagicMock()
+    mock_mgr.get_tool_specs.return_value = [mcp_spec]
+    with patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        specs = get_all_tool_specs()
+    assert mcp_spec in specs
+    assert len(specs) == len(all_tool_specs) + 1
+
+
+# ---------------------------------------------------------------------------
+# run_tool_async
+# ---------------------------------------------------------------------------
+
+@pytest.mark.asyncio
+async def test_run_tool_async_routes_to_mcp():
+    mock_mgr = MagicMock()
+    mock_mgr.is_mcp_tool.return_value = True
+    mock_mgr.call_tool = AsyncMock(return_value="mcp result")
+    with patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        result = await run_tool_async("srv__tool", {"key": "val"})
+    mock_mgr.call_tool.assert_called_once_with("srv__tool", {"key": "val"})
+    assert result == "mcp result"
+
+
+@pytest.mark.asyncio
+async def test_run_tool_async_falls_through_for_local_tool(tmp_path):
+    file_path = str(tmp_path / "f.txt")
+    with open(file_path, "w", encoding="utf-8") as f:
+        f.write("hello")
+    mock_mgr = MagicMock()
+    mock_mgr.is_mcp_tool.return_value = False
+    with patch("app.core.mcp_manager.mcp_manager", mock_mgr):
+        result = await run_tool_async("read_file", {"file_path": file_path})
+    mock_mgr.call_tool.assert_not_called()
+    assert result == "hello"
diff --git a/tests/test_tracer.py b/tests/test_tracer.py
new file mode 100644
index 0000000..42fd64f
--- /dev/null
+++ b/tests/test_tracer.py
@@ -0,0 +1,44 @@
+import json
+import pytest
+from pathlib import Path
+from unittest.mock import patch
+
+from app.infra.tracer import write_trace
+
+
+def test_write_trace_creates_file(tmp_path):
+    messages = [{"role": "user", "content": "hello"}, {"role": "assistant", "content": "hi"}]
+    path = write_trace(messages, tmp_path, "test-model")
+    assert path is not None
+    assert path.exists()
+
+
+def test_write_trace_file_content(tmp_path):
+    messages = [{"role": "user", "content": "hello"}]
+    path = write_trace(messages, tmp_path, "test-model")
+    data = json.loads(path.read_text())
+    assert data["model"] == "test-model"
+    assert data["messages"] == messages
+    assert "timestamp" in data
+
+
+def test_write_trace_filename_format(tmp_path):
+    path = write_trace([{"role": "user", "content": "hi"}], tmp_path, "m")
+    assert path.name.startswith("trace_")
+    assert path.suffix == ".json"
+
+
+def test_write_trace_creates_missing_directory(tmp_path):
+    tracedir = tmp_path / "nested" / "traces"
+    path = write_trace([{"role": "user", "content": "hi"}], tracedir, "m")
+    assert tracedir.exists()
+    assert path is not None
+    assert path.exists()
+
+
+def test_write_trace_returns_none_on_error(tmp_path):
+    # Create a file where the tracedir would need to be created as a directory
+    blocker = tmp_path / "blocker"
+    blocker.write_text("I am a file")
+    result = write_trace([], blocker / "subdir", "m")
+    assert result is None
diff --git a/tests/test_web_channel.py b/tests/test_web_channel.py
index 3cee7bb..4c131b9 100644
--- a/tests/test_web_channel.py
+++ b/tests/test_web_channel.py
@@ -93,6 +93,118 @@ def test_extract_json_empty_content_returns_none():
     assert WebChannel._extract_content(raw) is None
 
 
+# --- _extract_message: text + attachments ---
+
+def test_extract_message_plain_text_no_files():
+    ch, _ = make_web_channel()
+    content, files = ch._extract_message("hello")
+    assert content == "hello"
+    assert files == []
+
+
+def test_extract_message_ignores_non_list_files():
+    ch, _ = make_web_channel()
+    raw = json.dumps({"type": "message", "content": "hi", "files": "nope"})
+    content, files = ch._extract_message(raw)
+    assert content == "hi"
+    assert files == []
+
+
+# --- _resolve_upload_paths: traversal protection ---
+
+def test_resolve_upload_paths_rejects_traversal(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path
+    (tmp_path / "ok.txt").write_text("x")
+    # basename-only join means traversal segments are stripped → file not found
+    assert ch._resolve_upload_paths(["../secret", "/etc/passwd"]) == []
+
+
+def test_resolve_upload_paths_accepts_known_file(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path
+    (tmp_path / "good.txt").write_text("x")
+    resolved = ch._resolve_upload_paths(["good.txt"])
+    assert resolved == [str((tmp_path / "good.txt").resolve())]
+
+
+def test_resolve_upload_paths_skips_missing(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path
+    assert ch._resolve_upload_paths(["ghost.txt"]) == []
+
+
+def test_resolve_upload_paths_ignores_non_strings(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path
+    assert ch._resolve_upload_paths([1, None, ""]) == []
+
+
+# --- /api/upload endpoint ---
+
+def test_upload_saves_files_and_returns_names(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path / "uploads"
+    ch.start()
+
+    from starlette.testclient import TestClient
+    client = TestClient(ch._fasthtml_app, raise_server_exceptions=True)
+    resp = client.post(
+        "/api/upload",
+        files=[
+            ("files", ("a.txt", b"hello", "text/plain")),
+            ("files", ("b.png", b"\x89PNG", "image/png")),
+        ],
+    )
+    assert resp.status_code == 200
+    saved = resp.json()["files"]
+    assert [s["name"] for s in saved] == ["a.txt", "b.png"]
+    # files were actually written and resolvable
+    resolved = ch._resolve_upload_paths([s["path"] for s in saved])
+    assert len(resolved) == 2
+
+
+def test_upload_rejects_empty_request(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path / "uploads"
+    ch.start()
+
+    from starlette.testclient import TestClient
+    client = TestClient(ch._fasthtml_app, raise_server_exceptions=True)
+    resp = client.post("/api/upload")
+    assert resp.status_code == 400
+
+
+def test_upload_rejects_oversized(tmp_path):
+    ch, _ = make_web_channel()
+    ch._upload_dir = tmp_path / "uploads"
+    ch._MAX_UPLOAD_BYTES = 10
+    ch.start()
+
+    from starlette.testclient import TestClient
+    client = TestClient(ch._fasthtml_app, raise_server_exceptions=True)
+    resp = client.post(
+        "/api/upload",
+        files=[("files", ("big.bin", b"x" * 50, "application/octet-stream"))],
+    )
+    assert resp.status_code == 413
+
+
+# --- _build_page: attachment UI ---
+
+def test_build_page_has_attach_controls():
+    html = str(_build_page())
+    for tok in ('id="attach-btn"', 'id="file-input"', 'id="attachments"', "<svg"):
+        assert tok in html, f"Missing {tok}"
+
+
+def test_start_registers_upload_route():
+    ch, _ = make_web_channel()
+    ch.start()
+    paths = [getattr(r, "path", None) for r in ch._fasthtml_app.router.routes]
+    assert "/api/upload" in paths
+
+
 # --- _build_page: static file references ---
 
 def test_build_page_references_static_css():
diff --git a/uv.lock b/uv.lock
index 6045ac8..3e046c5 100644
--- a/uv.lock
+++ b/uv.lock
@@ -7,6 +7,18 @@ resolution-markers = [
     "python_full_version < '3.13'",
 ]
 
+[[package]]
+name = "aiofile"
+version = "3.11.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "caio" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/48/41/2fea7e193e061ce54eacc3b7bc0e6a99e4fcff43c78cf0a76dd781ed8334/aiofile-3.11.1.tar.gz", hash = "sha256:1f91912c6643d2a4e49ca4ae3514f0bf3867ce948a36d99a6411b8f4755f4cf9", size = 19342, upload-time = "2026-05-16T08:18:33.538Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/67/cd/0d76dfc5de72bde52f55f53e925c7d152d9c7906634ec1e0cbc7e8d4ad93/aiofile-3.11.1-py3-none-any.whl", hash = "sha256:ce77d14ac07f77bc2b757834a5c129321f3f705c474593deed5ab209079a52c9", size = 20446, upload-time = "2026-05-16T08:18:32.051Z" },
+]
+
 [[package]]
 name = "aiohappyeyeballs"
 version = "2.6.1"
@@ -274,6 +286,28 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f6/22/91616fe707a5c5510de2cac9b046a30defe7007ba8a0c04f9c08f27df312/audioop_lts-0.2.2-cp314-cp314t-win_arm64.whl", hash = "sha256:b492c3b040153e68b9fdaff5913305aaaba5bb433d8a7f73d5cf6a64ed3cc1dd", size = 25206, upload-time = "2025-08-05T16:43:16.444Z" },
 ]
 
+[[package]]
+name = "authlib"
+version = "1.7.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cryptography" },
+    { name = "joserfc" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/98/7d93f30d029643c0275dbc0bd6d5a6f670661ee6c9a94d93af7ab4887600/authlib-1.7.2.tar.gz", hash = "sha256:2cea25fefcd4e7173bdf1372c0afc265c8034b23a8cd5dcb6a9164b826c64231", size = 176511, upload-time = "2026-05-06T08:10:23.116Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/95/adcb68e20c34162e9135f370d6e31737719c2b6f94bc953fe7ed1f10fe21/authlib-1.7.2-py2.py3-none-any.whl", hash = "sha256:3e1faedc9d87e7d56a164eca3ccb6ace0d61b94abe83e92242f8dc8bba9b4a9f", size = 259548, upload-time = "2026-05-06T08:10:21.436Z" },
+]
+
+[[package]]
+name = "beartype"
+version = "0.22.9"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/94/1009e248bbfbab11397abca7193bea6626806be9a327d399810d523a07cb/beartype-0.22.9.tar.gz", hash = "sha256:8f82b54aa723a2848a56008d18875f91c1db02c32ef6a62319a002e3e25a975f", size = 1608866, upload-time = "2025-12-13T06:50:30.72Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/cc/18245721fa7747065ab478316c7fea7c74777d07f37ae60db2e84f8172e8/beartype-0.22.9-py3-none-any.whl", hash = "sha256:d16c9bbc61ea14637596c5f6fbff2ee99cbe3573e46a716401734ef50c3060c2", size = 1333658, upload-time = "2025-12-13T06:50:28.266Z" },
+]
+
 [[package]]
 name = "beautifulsoup4"
 version = "4.14.3"
@@ -287,6 +321,36 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" },
 ]
 
+[[package]]
+name = "cachetools"
+version = "7.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f4/8b/0d3945a13955303b81272f759a0331e54c5c793da455e6f5706b89d2639c/cachetools-7.1.4.tar.gz", hash = "sha256:437f55a4e0c1b01a4f3077cc470e6991d47430970e36fbcb77e2be0df4fc1cd6", size = 40085, upload-time = "2026-05-21T22:40:43.376Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8c/7b/1fc1c09cc0756cf25861a3be10565915953876da48bb228fb9a672b20a42/cachetools-7.1.4-py3-none-any.whl", hash = "sha256:323dc4127934744db5b54eb4924482d7edafbf9554e820d1531c2e08c0e4ef54", size = 16761, upload-time = "2026-05-21T22:40:41.845Z" },
+]
+
+[[package]]
+name = "caio"
+version = "0.9.25"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/92/88/b8527e1b00c1811db339a1df8bd1ae49d146fcea9d6a5c40e3a80aaeb38d/caio-0.9.25.tar.gz", hash = "sha256:16498e7f81d1d0f5a4c0ad3f2540e65fe25691376e0a5bd367f558067113ed10", size = 26781, upload-time = "2025-12-26T15:21:36.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d3/25/79c98ebe12df31548ba4eaf44db11b7cad6b3e7b4203718335620939083c/caio-0.9.25-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:fb7ff95af4c31ad3f03179149aab61097a71fd85e05f89b4786de0359dffd044", size = 36983, upload-time = "2025-12-26T15:21:36.075Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/2b/21288691f16d479945968a0a4f2856818c1c5be56881d51d4dac9b255d26/caio-0.9.25-cp312-cp312-manylinux2010_x86_64.manylinux2014_x86_64.manylinux_2_12_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:97084e4e30dfa598449d874c4d8e0c8d5ea17d2f752ef5e48e150ff9d240cd64", size = 82012, upload-time = "2025-12-26T15:22:20.983Z" },
+    { url = "https://files.pythonhosted.org/packages/03/c4/8a1b580875303500a9c12b9e0af58cb82e47f5bcf888c2457742a138273c/caio-0.9.25-cp312-cp312-manylinux_2_34_aarch64.whl", hash = "sha256:4fa69eba47e0f041b9d4f336e2ad40740681c43e686b18b191b6c5f4c5544bfb", size = 81502, upload-time = "2026-03-04T22:08:22.381Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/1c/0fe770b8ffc8362c48134d1592d653a81a3d8748d764bec33864db36319d/caio-0.9.25-cp312-cp312-manylinux_2_34_x86_64.whl", hash = "sha256:6bebf6f079f1341d19f7386db9b8b1f07e8cc15ae13bfdaff573371ba0575d69", size = 80200, upload-time = "2026-03-04T22:08:23.382Z" },
+    { url = "https://files.pythonhosted.org/packages/31/57/5e6ff127e6f62c9f15d989560435c642144aa4210882f9494204bc892305/caio-0.9.25-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:d6c2a3411af97762a2b03840c3cec2f7f728921ff8adda53d7ea2315a8563451", size = 36979, upload-time = "2025-12-26T15:21:35.484Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/9f/f21af50e72117eb528c422d4276cbac11fb941b1b812b182e0a9c70d19c5/caio-0.9.25-cp313-cp313-manylinux2010_x86_64.manylinux2014_x86_64.manylinux_2_12_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:0998210a4d5cd5cb565b32ccfe4e53d67303f868a76f212e002a8554692870e6", size = 81900, upload-time = "2025-12-26T15:22:21.919Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/12/c39ae2a4037cb10ad5eb3578eb4d5f8c1a2575c62bba675f3406b7ef0824/caio-0.9.25-cp313-cp313-manylinux_2_34_aarch64.whl", hash = "sha256:1a177d4777141b96f175fe2c37a3d96dec7911ed9ad5f02bac38aaa1c936611f", size = 81523, upload-time = "2026-03-04T22:08:25.187Z" },
+    { url = "https://files.pythonhosted.org/packages/22/59/f8f2e950eb4f1a5a3883e198dca514b9d475415cb6cd7b78b9213a0dd45a/caio-0.9.25-cp313-cp313-manylinux_2_34_x86_64.whl", hash = "sha256:9ed3cfb28c0e99fec5e208c934e5c157d0866aa9c32aa4dc5e9b6034af6286b7", size = 80243, upload-time = "2026-03-04T22:08:26.449Z" },
+    { url = "https://files.pythonhosted.org/packages/69/ca/a08fdc7efdcc24e6a6131a93c85be1f204d41c58f474c42b0670af8c016b/caio-0.9.25-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fab6078b9348e883c80a5e14b382e6ad6aabbc4429ca034e76e730cf464269db", size = 36978, upload-time = "2025-12-26T15:21:41.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/6c/d4d24f65e690213c097174d26eda6831f45f4734d9d036d81790a27e7b78/caio-0.9.25-cp314-cp314-manylinux2010_x86_64.manylinux2014_x86_64.manylinux_2_12_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:44a6b58e52d488c75cfaa5ecaa404b2b41cc965e6c417e03251e868ecd5b6d77", size = 81832, upload-time = "2025-12-26T15:22:22.757Z" },
+    { url = "https://files.pythonhosted.org/packages/87/a4/e534cf7d2d0e8d880e25dd61e8d921ffcfe15bd696734589826f5a2df727/caio-0.9.25-cp314-cp314-manylinux_2_34_aarch64.whl", hash = "sha256:628a630eb7fb22381dd8e3c8ab7f59e854b9c806639811fc3f4310c6bd711d79", size = 81565, upload-time = "2026-03-04T22:08:27.483Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/ed/bf81aeac1d290017e5e5ac3e880fd56ee15e50a6d0353986799d1bc5cfd5/caio-0.9.25-cp314-cp314-manylinux_2_34_x86_64.whl", hash = "sha256:0ba16aa605ccb174665357fc729cf500679c2d94d5f1458a6f0d5ca48f2060a7", size = 80071, upload-time = "2026-03-04T22:08:28.751Z" },
+    { url = "https://files.pythonhosted.org/packages/86/93/1f76c8d1bafe3b0614e06b2195784a3765bbf7b0a067661af9e2dd47fc33/caio-0.9.25-py3-none-any.whl", hash = "sha256:06c0bb02d6b929119b1cfbe1ca403c768b2013a369e2db46bfa2a5761cf82e40", size = 19087, upload-time = "2025-12-26T15:22:00.221Z" },
+]
+
 [[package]]
 name = "certifi"
 version = "2026.2.25"
@@ -296,6 +360,63 @@ 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" },
 ]
 
+[[package]]
+name = "cffi"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pycparser", marker = "implementation_name != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" },
+    { url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" },
+    { url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" },
+    { url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" },
+    { url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" },
+    { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" },
+    { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" },
+    { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" },
+    { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" },
+    { url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" },
+    { url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" },
+    { url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" },
+    { url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" },
+    { url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" },
+]
+
 [[package]]
 name = "charset-normalizer"
 version = "3.4.5"
@@ -372,6 +493,7 @@ source = { virtual = "." }
 dependencies = [
     { name = "ddgs" },
     { name = "discord-py" },
+    { name = "fastmcp" },
     { name = "geocoder" },
     { name = "openai" },
     { name = "python-dotenv" },
@@ -394,6 +516,7 @@ dev = [
 requires-dist = [
     { name = "ddgs", specifier = ">=9.14.1" },
     { name = "discord-py", specifier = ">=2.7.1" },
+    { name = "fastmcp", specifier = ">=2.0" },
     { name = "geocoder", specifier = ">=1.38.1" },
     { name = "openai", specifier = ">=2.15.0" },
     { name = "python-dotenv", specifier = ">=0.9.9" },
@@ -421,6 +544,74 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
 ]
 
+[[package]]
+name = "cryptography"
+version = "48.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9f/a9/db8f313fdcd85d767d4973515e1db101f9c71f95fced83233de224673757/cryptography-48.0.0.tar.gz", hash = "sha256:5c3932f4436d1cccb036cb0eaef46e6e2db91035166f1ad6505c3c9d5a635920", size = 832984, upload-time = "2026-05-04T22:59:38.133Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/3d/01f6dd9190170a5a241e0e98c2d04be3664a9e6f5b9b872cde63aff1c3dd/cryptography-48.0.0-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:0c558d2cdffd8f4bbb30fc7134c74d2ca9a476f830bb053074498fbc86f41ed6", size = 8001587, upload-time = "2026-05-04T22:57:36.803Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/6e/e90527eef33f309beb811cf7c982c3aeffcce8e3edb178baa4ca3ae4a6fa/cryptography-48.0.0-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f5333311663ea94f75dd408665686aaf426563556bb5283554a3539177e03b8c", size = 4690433, upload-time = "2026-05-04T22:57:40.373Z" },
+    { url = "https://files.pythonhosted.org/packages/90/04/673510ed51ddff56575f306cf1617d80411ee76831ccd3097599140efdfe/cryptography-48.0.0-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7995ef305d7165c3f11ae07f2517e5a4f1d5c18da1376a0a9ed496336b69e5f3", size = 4710620, upload-time = "2026-05-04T22:57:42.935Z" },
+    { url = "https://files.pythonhosted.org/packages/14/d5/e9c4ef932c8d800490c34d8bd589d64a31d5890e27ec9e9ad532be893294/cryptography-48.0.0-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:40ba1f85eaa6959837b1d51c9767e230e14612eea4ef110ee8854ada22da1bf5", size = 4696283, upload-time = "2026-05-04T22:57:45.294Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/29/174b9dfb60b12d59ecfc6cfa04bc88c21b42a54f01b8aae09bb6e51e4c7f/cryptography-48.0.0-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:369a6348999f94bbd53435c894377b20ab95f25a9065c283570e70150d8abc3c", size = 5296573, upload-time = "2026-05-04T22:57:47.933Z" },
+    { url = "https://files.pythonhosted.org/packages/95/38/0d29a6fd7d0d1373f0c0c88a04ba20e359b257753ac497564cd660fc1d55/cryptography-48.0.0-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:a0e692c683f4df67815a2d258b324e66f4738bd7a96a218c826dce4f4bd05d8f", size = 4743677, upload-time = "2026-05-04T22:57:50.067Z" },
+    { url = "https://files.pythonhosted.org/packages/30/be/eef653013d5c63b6a490529e0316f9ac14a37602965d4903efed1399f32b/cryptography-48.0.0-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:18349bbc56f4743c8b12dc32e2bccb2cf83ee8b69a3bba74ef8ae857e26b3d25", size = 4330808, upload-time = "2026-05-04T22:57:52.301Z" },
+    { url = "https://files.pythonhosted.org/packages/84/9e/500463e87abb7a0a0f9f256ec21123ecde0a7b5541a15e840ea54551fd81/cryptography-48.0.0-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e8eac43dfca5c4cccc6dad9a80504436fca53bb9bc3100a2386d730fbe6b602", size = 4695941, upload-time = "2026-05-04T22:57:54.603Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/dc/7303087450c2ec9e7fbb750e17c2abfbc658f23cbd0e54009509b7cc4091/cryptography-48.0.0-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:9ccdac7d40688ecb5a3b4a604b8a88c8002e3442d6c60aead1db2a89a041560c", size = 5252579, upload-time = "2026-05-04T22:57:57.207Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/c0/7101d3b7215edcdc90c45da544961fd8ed2d6448f77577460fa75a8443f7/cryptography-48.0.0-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:bd72e68b06bb1e96913f97dd4901119bc17f39d4586a5adf2d3e47bc2b9d58b5", size = 4743326, upload-time = "2026-05-04T22:57:59.535Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/d8/5b833bad13016f562ab9d063d68199a4bd121d18458e439515601d3357ec/cryptography-48.0.0-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:59baa2cb386c4f0b9905bd6eb4c2a79a69a128408fd31d32ca4d7102d4156321", size = 4826672, upload-time = "2026-05-04T22:58:01.996Z" },
+    { url = "https://files.pythonhosted.org/packages/98/e1/7074eb8bf3c135558c73fc2bcf0f5633f912e6fb87e868a55c454080ef09/cryptography-48.0.0-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:9249e3cd978541d665967ac2cb2787fd6a62bddf1e75b3e347a594d7dacf4f74", size = 4972574, upload-time = "2026-05-04T22:58:03.968Z" },
+    { url = "https://files.pythonhosted.org/packages/04/70/e5a1b41d325f797f39427aa44ef8baf0be500065ab6d8e10369d850d4a4f/cryptography-48.0.0-cp311-abi3-win32.whl", hash = "sha256:9c459db21422be75e2809370b829a87eb37f74cd785fc4aa9ea1e5f43b47cda4", size = 3294868, upload-time = "2026-05-04T22:58:06.467Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/ac/8ac51b4a5fc5932eb7ee5c517ba7dc8cd834f0048962b6b352f00f41ebf9/cryptography-48.0.0-cp311-abi3-win_amd64.whl", hash = "sha256:5b012212e08b8dd5edc78ef54da83dd9892fd9105323b3993eff6bea65dc21d7", size = 3817107, upload-time = "2026-05-04T22:58:08.845Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/84/70e3feea9feea87fd7cbe77efb2712ae1e3e6edf10749dc6e95f4e60e455/cryptography-48.0.0-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:3cb07a3ed6431663cd321ea8a000a1314c74211f823e4177fefa2255e057d1ec", size = 7986556, upload-time = "2026-05-04T22:58:11.172Z" },
+    { url = "https://files.pythonhosted.org/packages/89/6e/18e07a618bb5442ba10cf4df16e99c071365528aa570dfcb8c02e25a303b/cryptography-48.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:8c7378637d7d88016fa6791c159f698b3d3eed28ebf844ac36b9dc04a14dae18", size = 4684776, upload-time = "2026-05-04T22:58:13.712Z" },
+    { url = "https://files.pythonhosted.org/packages/be/6a/4ea3b4c6c6759794d5ee2103c304a5076dc4b19ae1f9fe47dba439e159e9/cryptography-48.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:cc90c0b39b2e3c65ef52c804b72e3c58f8a04ab2a1871272798e5f9572c17d20", size = 4698121, upload-time = "2026-05-04T22:58:16.448Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/59/6ff6ad6cae03bb887da2a5860b2c9805f8dac969ef01ce563336c49bd1d1/cryptography-48.0.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:76341972e1eff8b4bea859f09c0d3e64b96ce931b084f9b9b7db8ef364c30eff", size = 4690042, upload-time = "2026-05-04T22:58:18.544Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/b4/fc334ed8cfd705aca282fe4d8f5ae64a8e0f74932e9feecb344610cf6e4d/cryptography-48.0.0-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:55b7718303bf06a5753dcdccf2f3945cf18ad7bffde41b61226e4db31ab89a9c", size = 5282526, upload-time = "2026-05-04T22:58:20.75Z" },
+    { url = "https://files.pythonhosted.org/packages/11/08/9f8c5386cc4cd90d8255c7cdd0f5baf459a08502a09de30dc51f553d38dc/cryptography-48.0.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:a64697c641c7b1b2178e573cbc31c7c6684cd56883a478d75143dbb7118036db", size = 4733116, upload-time = "2026-05-04T22:58:23.627Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/77/99307d7574045699f8805aa500fa0fb83422d115b5400a064ddd306d7750/cryptography-48.0.0-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:561215ea3879cb1cbbf272867e2efda62476f240fb58c64de6b393ae19246741", size = 4316030, upload-time = "2026-05-04T22:58:25.581Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/36/a608b98337af3cb2aff4818e406649d30572b7031918b04c87d979495348/cryptography-48.0.0-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:ad64688338ed4bc1a6618076ba75fd7194a5f1797ac60b47afe926285adb3166", size = 4689640, upload-time = "2026-05-04T22:58:27.747Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/a6/825010a291b4438aecc1f568bc428189fc1175515223632477c07dc0a6df/cryptography-48.0.0-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:906cbf0670286c6e0044156bc7d4af9cbb0ef6db9f73e52c3ec56ba6bdde5336", size = 5237657, upload-time = "2026-05-04T22:58:29.848Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/09/4e76a09b4caa29aad535ddc806f5d4c5d01885bd978bd984fbc6ca032cae/cryptography-48.0.0-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:ea8990436d914540a40ab24b6a77c0969695ed52f4a4874c5137ccf7045a7057", size = 4732362, upload-time = "2026-05-04T22:58:32.009Z" },
+    { url = "https://files.pythonhosted.org/packages/18/78/444fa04a77d0cb95f417dda20d450e13c56ba8e5220fc892a1658f44f882/cryptography-48.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:c18684a7f0cc9a3cb60328f496b8e3372def7c5d2df39ac267878b05565aaaae", size = 4819580, upload-time = "2026-05-04T22:58:34.254Z" },
+    { url = "https://files.pythonhosted.org/packages/38/85/ea67067c70a1fd4be2c63d35eeed82658023021affccc7b17705f8527dd2/cryptography-48.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:9be5aafa5736574f8f15f262adc81b2a9869e2cfe9014d52a44633905b40d52c", size = 4963283, upload-time = "2026-05-04T22:58:36.376Z" },
+    { url = "https://files.pythonhosted.org/packages/75/54/cc6d0f3deac3e81c7f847e8a189a12b6cdd65059b43dad25d4316abd849a/cryptography-48.0.0-cp314-cp314t-win32.whl", hash = "sha256:c17dfe85494deaeddc5ce251aebd1d60bbe6afc8b62071bb0b469431a000124f", size = 3270954, upload-time = "2026-05-04T22:58:38.791Z" },
+    { url = "https://files.pythonhosted.org/packages/49/67/cc947e288c0758a4e5473d1dcb743037ab7785541265a969240b8885441a/cryptography-48.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27241b1dc9962e056062a8eef1991d02c3a24569c95975bd2322a8a52c6e5e12", size = 3797313, upload-time = "2026-05-04T22:58:40.746Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/63/61d4a4e1c6b6bab6ce1e213cd36a24c415d90e76d78c5eb8577c5541d2e8/cryptography-48.0.0-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:58d00498e8933e4a194f3076aee1b4a97dfec1a6da444535755822fe5d8b0b86", size = 7983482, upload-time = "2026-05-04T22:58:43.769Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/ac/f5b5995b87770c693e2596559ffafe195b4033a57f14a82268a2842953f3/cryptography-48.0.0-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:614d0949f4790582d2cc25553abd09dd723025f0c0e7c67376a1d77196743d6e", size = 4683266, upload-time = "2026-05-04T22:58:46.064Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/c6/8b14f67e18338fbc4adb76f66c001f5c3610b3e2d1837f268f47a347dbbb/cryptography-48.0.0-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7ce4bfae76319a532a2dc68f82cc32f5676ee792a983187dac07183690e5c66f", size = 4696228, upload-time = "2026-05-04T22:58:48.22Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/73/f808fbae9514bd91b47875b003f13e284c8c6bdfd904b7944e803937eec1/cryptography-48.0.0-cp39-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:2eb992bbd4661238c5a397594c83f5b4dc2bc5b848c365c8f991b6780efcc5c7", size = 4689097, upload-time = "2026-05-04T22:58:50.9Z" },
+    { url = "https://files.pythonhosted.org/packages/93/01/d86632d7d28db8ae83221995752eeb6639ffb374c2d22955648cf8d52797/cryptography-48.0.0-cp39-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:22a5cb272895dce158b2cacdfdc3debd299019659f42947dbdac6f32d68fe832", size = 5283582, upload-time = "2026-05-04T22:58:53.017Z" },
+    { url = "https://files.pythonhosted.org/packages/02/e1/50edc7a50334807cc4791fc4a0ce7468b4a1416d9138eab358bfc9a3d70b/cryptography-48.0.0-cp39-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:2b4d59804e8408e2fea7d1fbaf218e5ec984325221db76e6a241a9abd6cdd95c", size = 4730479, upload-time = "2026-05-04T22:58:55.611Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/af/99a582b1b1641ff5911ac559beb45097cf79efd4ead4657f578ef1af2d47/cryptography-48.0.0-cp39-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:984a20b0f62a26f48a3396c72e4bc34c66e356d356bf370053066b3b6d54634a", size = 4326481, upload-time = "2026-05-04T22:58:57.607Z" },
+    { url = "https://files.pythonhosted.org/packages/90/ee/89aa26a06ef0a7d7611788ffd571a7c50e368cc6a4d5eef8b4884e866edb/cryptography-48.0.0-cp39-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:5a5ed8fde7a1d09376ca0b40e68cd59c69fe23b1f9768bd5824f54681626032a", size = 4688713, upload-time = "2026-05-04T22:59:00.077Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ba/bcb1b0bb7a33d4c7c0c4d4c7874b4a62ae4f56113a5f4baefa362dfb1f0f/cryptography-48.0.0-cp39-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:8cd666227ef7af430aa5914a9910e0ddd703e75f039cef0825cd0da71b6b711a", size = 5238165, upload-time = "2026-05-04T22:59:02.317Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/70/ca4003b1ce5ca3dc3186ada51908c8a9b9ff7d5cab83cc0d43ee14ec144f/cryptography-48.0.0-cp39-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:9071196d81abc88b3516ac8cdfad32e2b66dd4a5393a8e68a961e9161ddc6239", size = 4729947, upload-time = "2026-05-04T22:59:05.255Z" },
+    { url = "https://files.pythonhosted.org/packages/44/a0/4ec7cf774207905aef1a8d11c3750d5a1db805eb380ee4e16df317870128/cryptography-48.0.0-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:1e2d54c8be6152856a36f0882ab231e70f8ec7f14e93cf87db8a2ed056bf160c", size = 4822059, upload-time = "2026-05-04T22:59:07.802Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/75/a2e55f99c16fcac7b5d6c1eb19ad8e00799854d6be5ca845f9259eae1681/cryptography-48.0.0-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a5da777e32ffed6f85a7b2b3f7c5cbc88c146bfcd0a1d7baf5fcc6c52ee35dd4", size = 4960575, upload-time = "2026-05-04T22:59:09.851Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/23/6e6f32143ab5d8b36ca848a502c4bcd477ae75b9e1677e3530d669062578/cryptography-48.0.0-cp39-abi3-win32.whl", hash = "sha256:77a2ccbbe917f6710e05ba9adaa25fb5075620bf3ea6fb751997875aff4ae4bd", size = 3279117, upload-time = "2026-05-04T22:59:12.019Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/9a/0fea98a70cf1749d41d738836f6349d97945f7c89433a259a6c2642eefeb/cryptography-48.0.0-cp39-abi3-win_amd64.whl", hash = "sha256:16cd65b9330583e4619939b3a3843eec1e6e789744bb01e7c7e2e62e33c239c8", size = 3792100, upload-time = "2026-05-04T22:59:14.884Z" },
+]
+
+[[package]]
+name = "cyclopts"
+version = "4.16.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "docstring-parser" },
+    { name = "rich" },
+    { name = "rich-rst" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/34/07/bf61d13de86d96a4c46aff00c9ca0eced44bcc8c3e16280605c1253e5720/cyclopts-4.16.1.tar.gz", hash = "sha256:8aa47bf92a5fb33abca5af05e576eecdb0d2f79893ad29238046df78370fc4a8", size = 181196, upload-time = "2026-05-25T15:29:08.518Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/00/8d/7f362c2fb8ef4decd2160bc24d4292c6ca658cc6d9a161b89ca5122bbdbf/cyclopts-4.16.1-py3-none-any.whl", hash = "sha256:617795392c4113a2c2cc7af716f20244900e87f23daa05442d1268d81472a592", size = 219020, upload-time = "2026-05-25T15:29:09.646Z" },
+]
+
 [[package]]
 name = "ddgs"
 version = "9.14.1"
@@ -466,6 +657,49 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/12/b3/231ffd4ab1fc9d679809f356cebee130ac7daa00d6d6f3206dd4fd137e9e/distro-1.9.0-py3-none-any.whl", hash = "sha256:7bffd925d65168f85027d8da9af6bddab658135b840670a223589bc0c8ef02b2", size = 20277, upload-time = "2023-12-24T09:54:30.421Z" },
 ]
 
+[[package]]
+name = "dnspython"
+version = "2.8.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/8b/57666417c0f90f08bcafa776861060426765fdb422eb10212086fb811d26/dnspython-2.8.0.tar.gz", hash = "sha256:181d3c6996452cb1189c4046c61599b84a5a86e099562ffde77d26984ff26d0f", size = 368251, upload-time = "2025-09-07T18:58:00.022Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ba/5a/18ad964b0086c6e62e2e7500f7edc89e3faa45033c71c1893d34eed2b2de/dnspython-2.8.0-py3-none-any.whl", hash = "sha256:01d9bbc4a2d76bf0db7c1f729812ded6d912bd318d3b1cf81d30c0f845dbf3af", size = 331094, upload-time = "2025-09-07T18:57:58.071Z" },
+]
+
+[[package]]
+name = "docstring-parser"
+version = "0.18.0"
+source = { registry = "https://pypi.org/simple" }
+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/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]]
+name = "email-validator"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "dnspython" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/22/900cb125c76b7aaa450ce02fd727f452243f2e91a61af068b40adba60ea9/email_validator-2.3.0.tar.gz", hash = "sha256:9fc05c37f2f6cf439ff414f8fc46d917929974a82244c20eb10231ba60c54426", size = 51238, upload-time = "2025-08-26T13:09:06.831Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/15/545e2b6cf2e3be84bc1ed85613edd75b8aea69807a71c26f4ca6a9258e82/email_validator-2.3.0-py3-none-any.whl", hash = "sha256:80f13f623413e6b197ae73bb10bf4eb0908faf509ad8362c5edeb0be7fd450b4", size = 35604, upload-time = "2025-08-26T13:09:05.858Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
 [[package]]
 name = "fastcore"
 version = "1.13.2"
@@ -488,6 +722,69 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fe/a7/af33584fa6d17b911cfaba460efd3409cb5dd47083c181a4fdfec4bef840/fastlite-0.2.4-py3-none-any.whl", hash = "sha256:869d96791b06535845b42f7ddef6e12f8e14f6b120f96b9701a4f16867189c63", size = 17638, upload-time = "2026-01-12T06:52:49.225Z" },
 ]
 
+[[package]]
+name = "fastmcp"
+version = "3.4.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "fastmcp-slim", extra = ["client", "server"] },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/4b/61/8352e9c15dc8f4ae35379e83bde0f00638c48c223cad2cc774c85bffe143/fastmcp-3.4.1.tar.gz", hash = "sha256:d8db60bfba3d20c5e327acb7992de6aaf45a5c368c887db709ade6d098646474", size = 28755462, upload-time = "2026-06-05T15:42:56.09Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bc/e6/402b4bc3debb80a333d03fa901c0fa17e2d92d5ddbaf769afc81a306489a/fastmcp-3.4.1-py3-none-any.whl", hash = "sha256:bbd7bb531c09837f857f7c5667b150ffd17c01bbab4d80eb9fdb188dc98b98b7", size = 8017, upload-time = "2026-06-05T15:42:52.786Z" },
+]
+
+[[package]]
+name = "fastmcp-slim"
+version = "3.4.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "platformdirs" },
+    { name = "pydantic", extra = ["email"] },
+    { name = "pydantic-settings" },
+    { name = "python-dotenv" },
+    { name = "rich" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fd/13/781b42f6aace53a6d5a8e6c3a91553e25f6677b9e30a0f0668e2367577f9/fastmcp_slim-3.4.1.tar.gz", hash = "sha256:659e2c0c77cc040d6e8383d860e02cd8f19321c7c8cf7d4c51d987a3cb02e727", size = 576047, upload-time = "2026-06-05T15:42:27.401Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/8f/1c7f8ae7f6960302ef93693a64c1037756ee5ebae29f1adb31a6cc79712c/fastmcp_slim-3.4.1-py3-none-any.whl", hash = "sha256:f6fa047d67b808d49b98b1017430c2620a2708211fb7b3a2c12d9f4298b6cc47", size = 748961, upload-time = "2026-06-05T15:42:28.769Z" },
+]
+
+[package.optional-dependencies]
+client = [
+    { name = "authlib" },
+    { name = "exceptiongroup" },
+    { name = "httpx" },
+    { name = "mcp" },
+    { name = "opentelemetry-api" },
+    { name = "py-key-value-aio", extra = ["filetree", "keyring", "memory"] },
+    { name = "starlette" },
+]
+server = [
+    { name = "authlib" },
+    { name = "cyclopts" },
+    { name = "exceptiongroup" },
+    { name = "griffelib" },
+    { name = "httpx" },
+    { name = "joserfc" },
+    { name = "jsonref" },
+    { name = "jsonschema-path" },
+    { name = "mcp" },
+    { name = "openapi-pydantic" },
+    { name = "opentelemetry-api" },
+    { name = "packaging" },
+    { name = "py-key-value-aio", extra = ["filetree", "keyring", "memory"] },
+    { name = "pyperclip" },
+    { name = "python-multipart" },
+    { name = "pyyaml" },
+    { name = "starlette" },
+    { name = "uncalled-for" },
+    { name = "uvicorn" },
+    { name = "watchfiles" },
+    { name = "websockets" },
+]
+
 [[package]]
 name = "frozenlist"
 version = "1.8.0"
@@ -602,6 +899,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/4f/6b/13166c909ad2f2d76b929a4227c952630ebaf0d729f6317eb09cbceccbab/geocoder-1.38.1-py2.py3-none-any.whl", hash = "sha256:a733e1dfbce3f4e1a526cac03aadcedb8ed1239cf55bd7f3a23c60075121a834", size = 98590, upload-time = "2018-04-04T12:34:51.222Z" },
 ]
 
+[[package]]
+name = "griffelib"
+version = "2.0.2"
+source = { registry = "https://pypi.org/simple" }
+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/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]]
 name = "h11"
 version = "0.16.0"
@@ -675,6 +981,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "httpx-sse"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.11"
@@ -702,6 +1017,48 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/04/96/92447566d16df59b2a776c0fb82dbc4d9e07cd95062562af01e408583fc4/itsdangerous-2.2.0-py3-none-any.whl", hash = "sha256:c6242fc49e35958c8b15141343aa660db5fc54d4f13a1db01a3f5891b98700ef", size = 16234, upload-time = "2024-04-16T21:28:14.499Z" },
 ]
 
+[[package]]
+name = "jaraco-classes"
+version = "3.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "more-itertools" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/c0/ed4a27bc5571b99e3cff68f8a9fa5b56ff7df1c2251cc715a652ddd26402/jaraco.classes-3.4.0.tar.gz", hash = "sha256:47a024b51d0239c0dd8c8540c6c7f484be3b8fcf0b2d85c13825780d3b3f3acd", size = 11780, upload-time = "2024-03-31T07:27:36.643Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7f/66/b15ce62552d84bbfcec9a4873ab79d993a1dd4edb922cbfccae192bd5b5f/jaraco.classes-3.4.0-py3-none-any.whl", hash = "sha256:f662826b6bed8cace05e7ff873ce0f9283b5c924470fe664fff1c2f00f581790", size = 6777, upload-time = "2024-03-31T07:27:34.792Z" },
+]
+
+[[package]]
+name = "jaraco-context"
+version = "6.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/af/50/4763cd07e722bb6285316d390a164bc7e479db9d90daa769f22578f698b4/jaraco_context-6.1.2.tar.gz", hash = "sha256:f1a6c9d391e661cc5b8d39861ff077a7dc24dc23833ccee564b234b81c82dfe3", size = 16801, upload-time = "2026-03-20T22:13:33.922Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f2/58/bc8954bda5fcda97bd7c19be11b85f91973d67a706ed4a3aec33e7de22db/jaraco_context-6.1.2-py3-none-any.whl", hash = "sha256:bf8150b79a2d5d91ae48629d8b427a8f7ba0e1097dd6202a9059f29a36379535", size = 7871, upload-time = "2026-03-20T22:13:32.808Z" },
+]
+
+[[package]]
+name = "jaraco-functools"
+version = "4.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "more-itertools" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/cf/ea4ef2920830dea3f5ab2ea4da6fb67724e6dca80ee2553788c3607243d0/jaraco_functools-4.5.0.tar.gz", hash = "sha256:3bb5665ea4a020cf78a7040e89154c77edadb3ca74f366479669c5999aa70b03", size = 20272, upload-time = "2026-05-15T21:34:10.025Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/96/9a/982e48afcffcd727a9144506720ffd4224b6b7e355c98641866f38b7c043/jaraco_functools-4.5.0-py3-none-any.whl", hash = "sha256:79ce39246eddbde4b3a03b77ea5f0f7878dc669b166a66cf3fa8e266aa3fa2f4", size = 10594, upload-time = "2026-05-15T21:34:08.595Z" },
+]
+
+[[package]]
+name = "jeepney"
+version = "0.9.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7b/6f/357efd7602486741aa73ffc0617fb310a29b588ed0fd69c2399acbb85b0c/jeepney-0.9.0.tar.gz", hash = "sha256:cf0e9e845622b81e4a28df94c40345400256ec608d0e55bb8a3feaa9163f5732", size = 106758, upload-time = "2025-02-27T18:51:01.684Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" },
+]
+
 [[package]]
 name = "jiter"
 version = "0.13.0"
@@ -770,6 +1127,86 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/67/8a/a342b2f0251f3dac4ca17618265d93bf244a2a4d089126e81e4c1056ac50/jiter-0.13.0-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7bb00b6d26db67a05fe3e12c76edc75f32077fb51deed13822dc648fa373bc19", size = 343768, upload-time = "2026-02-02T12:37:55.055Z" },
 ]
 
+[[package]]
+name = "joserfc"
+version = "1.7.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cryptography" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d3/c3/2f590052b55cbdd0ace470ee7ee1f685f6882051be93a9374891005623e2/joserfc-1.7.0.tar.gz", hash = "sha256:4aced6ab0c47846f0a531402aec2419a874b91e918df9c4c9da8a82fb559d6c4", size = 232967, upload-time = "2026-06-02T09:59:34.506Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5b/83/b6b62a66a06ce872d9429a5eb5ee20b2002fd9c331b953c94381c1f7c9f9/joserfc-1.7.0-py3-none-any.whl", hash = "sha256:17e5d7a5a35e65442b05efc435a3d5d46696ffa2c8a2ed0eea6f63fc268e3224", size = 70387, upload-time = "2026-06-02T09:59:33.264Z" },
+]
+
+[[package]]
+name = "jsonref"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" },
+]
+
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
+[[package]]
+name = "jsonschema-path"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "pathable" },
+    { name = "pyyaml" },
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/39/79/cd02a4df6d9270efdc7d3feefe6edd730b0820c39eeaa107a2faee8322d5/jsonschema_path-0.5.0.tar.gz", hash = "sha256:493b156ba895c97602655b620a8456caa2ce08c1aa389f5a7addec065e6e855c", size = 19597, upload-time = "2026-05-19T20:45:00.971Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/2c/9e69d73c4297508be9e3b64a970ea3971b3eb8db64ffc5802d40bd25981f/jsonschema_path-0.5.0-py3-none-any.whl", hash = "sha256:2790a070bc7abb08ea3dbe4d340ece4efadf639223001f020c7503229ba068e2", size = 24077, upload-time = "2026-05-19T20:44:59.225Z" },
+]
+
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
+[[package]]
+name = "keyring"
+version = "25.7.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jaraco-classes" },
+    { name = "jaraco-context" },
+    { name = "jaraco-functools" },
+    { name = "jeepney", marker = "sys_platform == 'linux'" },
+    { name = "pywin32-ctypes", marker = "sys_platform == 'win32'" },
+    { name = "secretstorage", marker = "sys_platform == 'linux'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/674af6ef2f97d56f0ab5153bf0bfa28ccb6c3ed4d1babf4305449668807b/keyring-25.7.0.tar.gz", hash = "sha256:fe01bd85eb3f8fb3dd0405defdeac9a5b4f6f0439edbb3149577f244a2e8245b", size = 63516, upload-time = "2025-11-16T16:26:09.482Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/db/e655086b7f3a705df045bf0933bdd9c2f79bb3c97bfef1384598bb79a217/keyring-25.7.0-py3-none-any.whl", hash = "sha256:be4a0b195f149690c166e850609a477c532ddbfbaed96a404d4e43f8d5e2689f", size = 39160, upload-time = "2025-11-16T16:26:08.402Z" },
+]
+
 [[package]]
 name = "lxml"
 version = "6.1.0"
@@ -850,6 +1287,61 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2b/a0/9b916c68c0e57752c07f8f64b30138d9d4059dbeb27b90274dedbea128ff/lxml-6.1.0-cp314-cp314t-win_arm64.whl", hash = "sha256:26dd9f57ee3bd41e7d35b4c98a2ffd89ed11591649f421f0ec19f67d50ec67ac", size = 3817120, upload-time = "2026-04-18T04:32:15.803Z" },
 ]
 
+[[package]]
+name = "markdown-it-py"
+version = "4.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz", hash = "sha256:04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49", size = 82454, upload-time = "2026-05-07T12:08:28.36Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/81/4da04ced5a082363ecfa159c010d200ecbd959ae410c10c0264a38cac0f5/markdown_it_py-4.2.0-py3-none-any.whl", hash = "sha256:9f7ebbcd14fe59494226453aed97c1070d83f8d24b6fc3a3bcf9a38092641c4a", size = 91687, upload-time = "2026-05-07T12:08:27.182Z" },
+]
+
+[[package]]
+name = "mcp"
+version = "1.27.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "httpx" },
+    { name = "httpx-sse" },
+    { name = "jsonschema" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "pyjwt", extra = ["crypto"] },
+    { name = "python-multipart" },
+    { name = "pywin32", marker = "sys_platform == 'win32'" },
+    { name = "sse-starlette" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+    { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/27/3c/347cf965d313f5d41764e7d46bea6ffe7d9ef13b983cc429b0340962a082/mcp-1.27.2.tar.gz", hash = "sha256:8e02db104096d1c25b28e64bde29a5c32b31bc241710213e12fd4d84985bdfef", size = 621116, upload-time = "2026-05-29T17:16:04.039Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c9/11/252c6f971dc4f16af1d98a1c469d8ba523aab00d1bb76b4d3bc1ff32eacc/mcp-1.27.2-py3-none-any.whl", hash = "sha256:d6ff5160c6ca65d93013626efb3fc249de683c30b2d8570755ceddd490344de5", size = 220498, upload-time = "2026-05-29T17:16:02.442Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "more-itertools"
+version = "11.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/de/1d/f4da6f02cdffe04d6362210b807146a26044c88d839208aec273bb0d9184/more_itertools-11.1.0.tar.gz", hash = "sha256:48e8f4d9e7e5878571ecf6f2b4e57634f93cd474cc8cfbd2376f2d11b396e30d", size = 145772, upload-time = "2026-05-22T14:14:29.909Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e8/3d/1087453384dbde46a8c7f9356eead2c58be8a7bf156bca40243377c85715/more_itertools-11.1.0-py3-none-any.whl", hash = "sha256:4b65538ae22f6fed0ce4874efd317463a7489796a0939fa66824dd542125a192", size = 72226, upload-time = "2026-05-22T14:14:28.824Z" },
+]
+
 [[package]]
 name = "multidict"
 version = "6.7.1"
@@ -977,6 +1469,30 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/9e/5bfa2270f902d5b92ab7d41ce0475b8630572e71e349b2a4996d14bdda93/openai-2.30.0-py3-none-any.whl", hash = "sha256:9a5ae616888eb2748ec5e0c5b955a51592e0b201a11f4262db920f2a78c5231d", size = 1146656, upload-time = "2026-03-25T22:08:58.2Z" },
 ]
 
+[[package]]
+name = "openapi-pydantic"
+version = "0.5.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/02/2e/58d83848dd1a79cb92ed8e63f6ba901ca282c5f09d04af9423ec26c56fd7/openapi_pydantic-0.5.1.tar.gz", hash = "sha256:ff6835af6bde7a459fb93eb93bb92b8749b754fc6e51b2f1590a19dc3005ee0d", size = 60892, upload-time = "2025-01-08T19:29:27.083Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" },
+]
+
+[[package]]
+name = "opentelemetry-api"
+version = "1.42.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b4/1c/125e1c936c0873796771b7f04f6c93b9f1bf5d424cea90fda94a99f61da8/opentelemetry_api-1.42.1.tar.gz", hash = "sha256:56c63bea9f77b62856be8c47600474acad853b2924b99b1687c4cb6297166716", size = 72296, upload-time = "2026-05-21T16:32:49.335Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a3/ca/9520cc1f3dfbbd03ac5903bbf55833e257bc64b1cf30fa8b0d6df374d821/opentelemetry_api-1.42.1-py3-none-any.whl", hash = "sha256:51a69edacadbc03a8950ace1c4c21099cacc538820ac2c9e36277e78cebba714", size = 61311, upload-time = "2026-05-21T16:32:28.822Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "26.0"
@@ -986,6 +1502,24 @@ 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" },
 ]
 
+[[package]]
+name = "pathable"
+version = "0.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/f3/5a20387de9bcd0607871bfc2198ee0e15836da7baa4592ccd7f24c27c986/pathable-0.6.0.tar.gz", hash = "sha256:6404b8b82aef5ff0fd478934137128b99b12212ba35afdde5525ca4f8388ea58", size = 18970, upload-time = "2026-05-19T18:15:11.911Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a2/e8/6d75ffd9784bce2e93d1ae4415649427e39a53bb172d4672b2b59c6f0a7b/pathable-0.6.0-py3-none-any.whl", hash = "sha256:82c4ca6c98c502ad12e0d4e9779b6210afee93c38990988c8c5d1b49bdcdf566", size = 18983, upload-time = "2026-05-19T18:15:10.728Z" },
+]
+
+[[package]]
+name = "platformdirs"
+version = "4.10.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/47/e4501f49c178ae1d9f4a75073fda4204f52647993f075a9db4d14930e0c5/platformdirs-4.10.0.tar.gz", hash = "sha256:31e761a6a0ca04faf7353ea759bdba55652be214725111e5aac52dfa29d4bef7", size = 31224, upload-time = "2026-05-28T03:32:53.587Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/e6/cd9575ac904136b3cbf7aa7ee819ef86eedb7274e46f230e94ea4342e729/platformdirs-4.10.0-py3-none-any.whl", hash = "sha256:fb516cdb12eb0d857d0cd85a7c57cea4d060bee4578d6cf5a14dfdf8cbf8784a", size = 22743, upload-time = "2026-05-28T03:32:52.175Z" },
+]
+
 [[package]]
 name = "pluggy"
 version = "1.6.0"
@@ -1127,6 +1661,40 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3a/ed/1cdcab6ba3d6ab7feca11fc14f0eeea80755bb53ef4e892079f31b10a25f/propcache-0.5.2-py3-none-any.whl", hash = "sha256:be1ddfcbb376e3de5d2e2db1d58d6d67463e6b4f9f040c000de8e300295465fe", size = 14036, upload-time = "2026-05-08T21:02:10.673Z" },
 ]
 
+[[package]]
+name = "py-key-value-aio"
+version = "0.4.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "beartype" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fb/e2/d689d922894a7ecde73b6daeaf9b13dab5aae06fe6aaaf7514722644d382/py_key_value_aio-0.4.5.tar.gz", hash = "sha256:c6563a2c6abe5da5e20f4f9e875c2a9b425a2244a54fadbf46cf140a9eea45d7", size = 107547, upload-time = "2026-05-27T16:37:08.107Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f6/95/b8ba862968712caa12a19666175334fa979e1f198b896a430adb3bacfe87/py_key_value_aio-0.4.5-py3-none-any.whl", hash = "sha256:ab862adbcb8c72547d1c57821f22cbbb71ab86509039c96f36e914e0336c8dd7", size = 170005, upload-time = "2026-05-27T16:37:06.629Z" },
+]
+
+[package.optional-dependencies]
+filetree = [
+    { name = "aiofile" },
+    { name = "anyio" },
+]
+keyring = [
+    { name = "keyring" },
+]
+memory = [
+    { name = "cachetools" },
+]
+
+[[package]]
+name = "pycparser"
+version = "3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1b/7d/92392ff7815c21062bea51aa7b87d45576f649f16458d78b7cf94b9ab2e6/pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29", size = 103492, upload-time = "2026-01-21T14:26:51.89Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/c3/44f3fbbfa403ea2a7c779186dc20772604442dde72947e7d01069cbe98e3/pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992", size = 48172, upload-time = "2026-01-21T14:26:50.693Z" },
+]
+
 [[package]]
 name = "pydantic"
 version = "2.12.5"
@@ -1142,6 +1710,11 @@ 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" },
 ]
 
+[package.optional-dependencies]
+email = [
+    { name = "email-validator" },
+]
+
 [[package]]
 name = "pydantic-core"
 version = "2.41.5"
@@ -1213,6 +1786,20 @@ wheels = [
     { 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" },
 ]
 
+[[package]]
+name = "pydantic-settings"
+version = "2.14.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/07/60/1d1e59c9c90d54591469ada7d268251f71c24bdb765f1a8a832cee8c6653/pydantic_settings-2.14.1.tar.gz", hash = "sha256:e874d3bec7e787b0c9958277956ed9b4dd5de6a80e162188fdaff7c5e26fd5fa", size = 235551, upload-time = "2026-05-08T13:40:06.542Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ae/8d/f1af3832f5e6eb13ba94ee809e72b8ecb5eef226d27ee0bef7d963d943c7/pydantic_settings-2.14.1-py3-none-any.whl", hash = "sha256:6e3c7edfd8277687cdc598f56e5cff0e9bfff0910a3749deaa8d4401c3a2b9de", size = 60964, upload-time = "2026-05-08T13:40:04.958Z" },
+]
+
 [[package]]
 name = "pygments"
 version = "2.19.2"
@@ -1222,6 +1809,29 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
 ]
 
+[[package]]
+name = "pyjwt"
+version = "2.13.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3b/81/58d0ac84e1ef3a3843791d6954d94c0b33d526c75eeb1efbce9d0a4c4077/pyjwt-2.13.0.tar.gz", hash = "sha256:41571c89ca91598c79e8ef18a2d07367d4810fbbd6f637794879baf1b7703423", size = 107515, upload-time = "2026-05-21T19:54:36.618Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a3/5e/ecf12fdb62546d64385c158514e9b2b671f7832108ef2ecd2020ce0af2d1/pyjwt-2.13.0-py3-none-any.whl", hash = "sha256:66adcc2aff09b3f1bbd95fc1e1577df8ac8723c978552fd43304c8a290ac5728", size = 31274, upload-time = "2026-05-21T19:54:35.362Z" },
+]
+
+[package.optional-dependencies]
+crypto = [
+    { name = "cryptography" },
+]
+
+[[package]]
+name = "pyperclip"
+version = "1.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e8/52/d87eba7cb129b81563019d1679026e7a112ef76855d6159d24754dbd2a51/pyperclip-1.11.0.tar.gz", hash = "sha256:244035963e4428530d9e3a6101a1ef97209c6825edab1567beac148ccc1db1b6", size = 12185, upload-time = "2025-09-26T14:40:37.245Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/80/fc9d01d5ed37ba4c42ca2b55b4339ae6e200b456be3a1aaddf4a9fa99b8c/pyperclip-1.11.0-py3-none-any.whl", hash = "sha256:299403e9ff44581cb9ba2ffeed69c7aa96a008622ad0c46cb575ca75b5b84273", size = 11063, upload-time = "2025-09-26T14:40:36.069Z" },
+]
+
 [[package]]
 name = "pytest"
 version = "9.0.2"
@@ -1315,6 +1925,34 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/94/f7/0e2f89dd62f45d46d4ea0d8aec5893ce5b37389638db010c117f46f11450/python_telegram_bot-22.7-py3-none-any.whl", hash = "sha256:d72eed532cf763758cd9331b57a6d790aff0bb4d37d8f4e92149436fe21c6475", size = 745365, upload-time = "2026-03-16T09:36:01.498Z" },
 ]
 
+[[package]]
+name = "pywin32"
+version = "312"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/83/ff/32aa7d2ed0ab12b323aaa64f9b75e6ad4f8fd09f9ccfc28c79414d46838d/pywin32-312-cp312-cp312-win32.whl", hash = "sha256:dab4f65ac9c4e48400a2a0530c46c3c579cd5905ecd11b80692373915269208b", size = 6371877, upload-time = "2026-06-04T07:49:28.836Z" },
+    { url = "https://files.pythonhosted.org/packages/03/d9/77040d3b43df3f3be32ea289433d660d2727f5ba327bc73be835127d9d60/pywin32-312-cp312-cp312-win_amd64.whl", hash = "sha256:b457f6d628a47e8a7346ce22acb7e1a46a4a78b52e1d17e1af56871bd19a93bc", size = 6914841, upload-time = "2026-06-04T07:49:31.85Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/cc/7b1ec671775756020a0ee7f4feeaf3c568f0ab86bd3900088cf986937a92/pywin32-312-cp312-cp312-win_arm64.whl", hash = "sha256:6017c58e12f6809fbb0555b75df144c2922a9ffd18e4b9b5afa863b6c1a9d950", size = 6727901, upload-time = "2026-06-04T07:49:34.244Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/41/12fbfd7f36ed2146d8bc9de96c2741296bf0d490b98508496cff322e274c/pywin32-312-cp313-cp313-win32.whl", hash = "sha256:7a27df850933d16a8eabfbaeb73d52b273e2da667f80d70b01a89d1f6828d02c", size = 6370184, upload-time = "2026-06-04T07:49:36.253Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/db/36a78e3403099d31d9746d13fdcde5accc43c1155f375a34d15983a479a7/pywin32-312-cp313-cp313-win_amd64.whl", hash = "sha256:c53e878d15a1c44788082bfe712a905433473aa38f86375b7cf8b45e3acbaaf9", size = 6914298, upload-time = "2026-06-04T07:49:38.876Z" },
+    { url = "https://files.pythonhosted.org/packages/84/37/c1697194092b76de9ed47ca124323f02c57ffc8a45c06f88a3d5acaf01eb/pywin32-312-cp313-cp313-win_arm64.whl", hash = "sha256:59aba5d5940842075343a5ddc6b11f1cdf0d1567fe745290359dfbcc7c2eb831", size = 6727640, upload-time = "2026-06-04T07:49:41.083Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/2b/1f3cded5822fd49c02f40544cbb5f58c7cfd6b1694869fd476cb6170ee97/pywin32-312-cp314-cp314-win32.whl", hash = "sha256:a77a90fbb6881238d2ca9c6fd797b25817f3768fe78d214a90137ff055a75f5b", size = 6468928, upload-time = "2026-06-04T07:49:43.188Z" },
+    { url = "https://files.pythonhosted.org/packages/21/82/3bf86d2e2808902013132e1ce905a7da0da53790f3836c64bf44d55e24f3/pywin32-312-cp314-cp314-win_amd64.whl", hash = "sha256:a4dd3a848290ef724347b19f301045831d8e802fa4464f491b98b1e0a081432e", size = 7024157, upload-time = "2026-06-04T07:49:45.34Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/0e/73f6d6800b4f27655abd9e9f6aaeaefcddb2b946e4674efa2bab184a7f7b/pywin32-312-cp314-cp314-win_arm64.whl", hash = "sha256:9fce94568364e0155e6dfb781ac5d95903be8baf28670632beab1b523f300daa", size = 6839598, upload-time = "2026-06-04T07:49:47.613Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/61/caa39686032d2ebdd04ff0ab5cbe163126c0066d98e00c9018646e42393b/pywin32-312-cp315-cp315-win32.whl", hash = "sha256:5c1fbe4a937a73ae9297384a3da38518cbc694c68ad8a809b2e19acd350f03ed", size = 6471159, upload-time = "2026-06-04T07:49:50.035Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/cd/7e1de64a4a6f69c04214169657ccab0d93a670ea50e35eb8f489d7378249/pywin32-312-cp315-cp315-win_amd64.whl", hash = "sha256:c2f03a0f73f804a13c2735b99392b0cd426bb4f2c4d0178e5ac966a0f21618d5", size = 7025293, upload-time = "2026-06-04T07:49:54.857Z" },
+    { url = "https://files.pythonhosted.org/packages/23/ed/4532e9388e65fa16b46776ef47ad631a64eda1631884488af707666350ed/pywin32-312-cp315-cp315-win_arm64.whl", hash = "sha256:a8597d28f267b39074aef51fa593530082b39cbe5a074226096857b1fed2dfb9", size = 6840337, upload-time = "2026-06-04T07:49:57.531Z" },
+]
+
+[[package]]
+name = "pywin32-ctypes"
+version = "0.2.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/85/9f/01a1a99704853cb63f253eea009390c88e7131c67e66a0a02099a8c917cb/pywin32-ctypes-0.2.3.tar.gz", hash = "sha256:d162dc04946d704503b2edc4d55f3dba5c1d539ead017afa00142c38b9885755", size = 29471, upload-time = "2024-08-14T10:15:34.626Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/3d/8161f7711c017e01ac9f008dfddd9410dff3674334c233bde66e7ba65bbf/pywin32_ctypes-0.2.3-py3-none-any.whl", hash = "sha256:8a1513379d709975552d202d942d9837758905c8d01eb82b8bcc30918929e7b8", size = 30756, upload-time = "2024-08-14T10:15:33.187Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"
@@ -1373,6 +2011,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f2/98/7e6d147fd16a10a5f821db6e25f192265d6ecca3d82957a4fdd592cad49c/ratelim-0.1.6-py2.py3-none-any.whl", hash = "sha256:e1a7dd39e6b552b7cc7f52169cd66cdb826a1a30198e355d7016012987c9ad08", size = 4017, upload-time = "2015-02-27T18:06:06.464Z" },
 ]
 
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
 [[package]]
 name = "requests"
 version = "2.32.5"
@@ -1388,6 +2040,142 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
 ]
 
+[[package]]
+name = "rich"
+version = "15.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+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/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]]
+name = "rich-rst"
+version = "2.0.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pygments" },
+    { name = "rich" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/57/56/3191bae66b08ccc637ea8120426068bcb361cc323c96404c310886937067/rich_rst-2.0.1.tar.gz", hash = "sha256:cbe236ed0901d1ec8427cc6a50bf0a34353ba28ad014dc24def68bfe7f3b9e68", size = 300570, upload-time = "2026-05-16T00:47:57.362Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/3d/55c17d3ebdf3cd81356002afe5bef9bb8af631db2819785b6eac845b925b/rich_rst-2.0.1-py3-none-any.whl", hash = "sha256:7ee15f345ce25fa02b582c272a6cdbaf0c21243e38061cea273cff659bf3ef61", size = 272922, upload-time = "2026-05-16T00:47:55.508Z" },
+]
+
+[[package]]
+name = "rpds-py"
+version = "2026.5.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2e/43/25a8dcd3feedd735039a8f0b5b7e3b118232b5eae288c4fd9ab200d41094/rpds_py-2026.5.1.tar.gz", hash = "sha256:07b24fea40541e28570e5b795a4a38fbdcd12550c06bd0748005ecc8116ca256", size = 64459, upload-time = "2026-05-28T12:02:13.232Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/e7/a78582dc57caa592dcc7d4fb69b61390561e908eb3d2f5df5928a8e354c0/rpds_py-2026.5.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:3abe24a66e57adcfa645d718063a5fa5103ecc71ddbf26d78af8f9368018ff1d", size = 353040, upload-time = "2026-05-28T11:59:12.531Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/43/35e3f136343aef451e545ce8c38d36c2f93c0ed88703db8b64ba2b205c68/rpds_py-2026.5.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:58b1d94308ddf0b1982f61f2eb54bf92997c9ece8a8093ef014250f4a517906c", size = 345775, upload-time = "2026-05-28T11:59:13.827Z" },
+    { url = "https://files.pythonhosted.org/packages/20/e1/0f2160c5982d3157734d5cb3ed63d8b2d583a73c9864f77b666449f32cf8/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0fa92420128dadce7f54bd73ba1825a273e9268fe9e35dbf7e6362890efa4e08", size = 376329, upload-time = "2026-05-28T11:59:15.271Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/11/ee0ba42aff83bf4effdbc576673c6be64c5e173978c3f6d537e94482f77d/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ca653c6546386227cd9800d1bef6a348099acf8db4250341da6d90f663d6dfcb", size = 383539, upload-time = "2026-05-28T11:59:16.665Z" },
+    { url = "https://files.pythonhosted.org/packages/11/df/d94aa6a499d4ac40afe2d7620f2c597fd3c0f182e854ad7cf3f596a81cb6/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:66c93681c4729e4e3ecba31b8179fae083ff3118841672835140338b4b9867c1", size = 494674, upload-time = "2026-05-28T11:59:17.991Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/75/33d30f43bb2f458de11979486a591b1bf6e5651765ed1704c6197c2dc773/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:40ff257542e04796880e011e15cd4dc21c2599975df2aaa8f2c8495ca574e1a5", size = 389268, upload-time = "2026-05-28T11:59:19.434Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/1e/2c9096fc19d5fd084b0184ca2b651e659aa0a37e6fdbecf6ece47f147fe1/rpds_py-2026.5.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b6825cc329b290e93c5f6a9be2393118a763f6ccf6abd83704e0c102ca583644", size = 376280, upload-time = "2026-05-28T11:59:21Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/e5/61ec9f8be8211ea7f48448195549e4aaf02004083475493b0e137702ecb2/rpds_py-2026.5.1-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:de42116e69cb53b911cc34aee5ab98f36c597b822545045d49e938818b99e5e4", size = 387233, upload-time = "2026-05-28T11:59:22.454Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/ca/bcec1005c4f4a234f92a29078631fee49206c7265ccae966f18fd332e80e/rpds_py-2026.5.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c0f920015df2a504bebaba6d4c31ccf3fcf942f92655c086da30b671aad19aa6", size = 405009, upload-time = "2026-05-28T11:59:23.845Z" },
+    { url = "https://files.pythonhosted.org/packages/72/e6/4d5718c5cf26c522dc7c9999e238da1e77380b81d0c5d1df11e271ddfeb1/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:0408a24e44feb919423dc6d9da677cb5cddb894d2ca9e763967d156d9c60fab4", size = 553113, upload-time = "2026-05-28T11:59:25.184Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/25/2ee807bdb3e1f0b7eddf7782acd5665a8b5205a331a7d7244a52c4812fd9/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:cea68bcd53467561ae2f96a6bdad1544299ba97b5b0ddcd5ac3d376e5c781c24", size = 618838, upload-time = "2026-05-28T11:59:26.749Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/c1/7d4c26f167f8c41501cc073d30ee22082b16ce358cf5b00ec97cbc7804ea/rpds_py-2026.5.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:4be8b1d2a705cc37d08256004e1d07de143fa0075c8e85a3df020b776f62b732", size = 582436, upload-time = "2026-05-28T11:59:28.11Z" },
+    { url = "https://files.pythonhosted.org/packages/04/1d/9d12b0a337bab46f4769f8857f4007e3b2d639e14f9a44a0efe157696e64/rpds_py-2026.5.1-cp312-cp312-win32.whl", hash = "sha256:6736718bd4fc49cbcb538ba30516fdbef161522acefb739657d48b97bd864fed", size = 212734, upload-time = "2026-05-28T11:59:29.689Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/93/e4116f2de7f56bc7406a76033dc501811ddeb22b7f056b92d632871ebb0c/rpds_py-2026.5.1-cp312-cp312-win_amd64.whl", hash = "sha256:0a7d1eec967df0e9b22614a5e177622e0c89611d03727fa0cb48e45028907870", size = 229045, upload-time = "2026-05-28T11:59:31.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/53/6c3419d85eb2ec5938a37627c585b42d76a63bb731d6e42ed4b079ebf486/rpds_py-2026.5.1-cp312-cp312-win_arm64.whl", hash = "sha256:1841d067089e117142d79b98aa0df2f08b52f2ecc1819dd2700636c0db74a473", size = 223967, upload-time = "2026-05-28T11:59:32.318Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/32/14c961ad295f490eb0849ada8b79683e93a59b9de3afdd983eaf55fa6867/rpds_py-2026.5.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:efef4ac29c6ff495531eb17ee705b62841ecaa291b7c7077e848ea03e237164d", size = 352787, upload-time = "2026-05-28T11:59:33.655Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/bb/d1b85117967c11191441a7274ae616c65d93901d082c588f89a50a8da5ae/rpds_py-2026.5.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:c39f5b67a8a2e67179ada2a954227d670fe65fa9098457f698f56ddf248709b3", size = 345179, upload-time = "2026-05-28T11:59:35Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/46/d84105f062e626a1b233f863907288a4708c2d833b8b4c6fb2764bc080c0/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b5c30f3f04eef4fbd362226a6f31d7c8895ca4fbb6e0b790f6890a98d8da8559", size = 376173, upload-time = "2026-05-28T11:59:36.43Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/ae/469d7959ce5b1201e1de135dc735b86db3b35dd0d1734f6a44246d5f061c/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:277f6c82f0580848796c7ecc8a7173aa3bfb928e4ff831261c2f60a81dc270db", size = 383162, upload-time = "2026-05-28T11:59:37.995Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/a2/57853d31a1116a561aa072794602ad3f6341e18d70a8523f1bd5b9fc1e5a/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:63c2c4c213f1a4e3f3de28ecab029dbdee976324e729c0d7a55211be72576b02", size = 495093, upload-time = "2026-05-28T11:59:39.453Z" },
+    { url = "https://files.pythonhosted.org/packages/99/63/3a8eabcad9314b7daf5c65f451d2c33d989235cd8a5762186cf2c3f5a4f8/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3350ec808fb538fe71a1f94dfaa0e29c598dfad805ce49f0caec5ae3183c652b", size = 389829, upload-time = "2026-05-28T11:59:40.896Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/25/05678d97fc25e2622df14dc530fb82023174ecfff6733991ed0d78f167bd/rpds_py-2026.5.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b1b964e3ab599e718dc46c018d104b1ebc007cbc6567d827c94a687fca56d77e", size = 374786, upload-time = "2026-05-28T11:59:42.626Z" },
+    { url = "https://files.pythonhosted.org/packages/88/d1/8c90b6431e80a3b91b284a5c7c8c0c4f9c006444d90477a740d6e0f9c694/rpds_py-2026.5.1-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:19cb09fab7b7fc96b2a6e28f2e34b72a3705ff27b37edb77455316e5d3f3dc9b", size = 386920, upload-time = "2026-05-28T11:59:44.124Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/99/4638f672ab356682d633ee0da9255f5b67ce6efd0b85eb94ad3e255e65a5/rpds_py-2026.5.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:abe76bcdba31e576cb83eeb8797aa0d882b738fef6dc65d0601fc753806a5b46", size = 405059, upload-time = "2026-05-28T11:59:47.177Z" },
+    { url = "https://files.pythonhosted.org/packages/66/3f/3546524b6eb4cc2e1f363a3d638fa52f6c24faae3500c25fb488b02f1740/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:8bff7073db3899158fff55ebf57b113a67030af26f80a18978f9f0aa60250ddf", size = 553030, upload-time = "2026-05-28T11:59:48.603Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/c3/7b3388c796fcf471bd17194242d4dc1a7608567c0fa422bcc1c5e79f9c1e/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:8ba264fa49be666cd9cc56bf34ec7002fb3d27a4aee5bcb4d43d0d18feb1bb6f", size = 618975, upload-time = "2026-05-28T11:59:50.314Z" },
+    { url = "https://files.pythonhosted.org/packages/61/1e/a3cb07f2795075d1d88efddae2f541359fde5f08c81ee114c29c2949c90a/rpds_py-2026.5.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4860b603ddda0475a8885499b3729e90229d480105b42651962a5397d995fa89", size = 581178, upload-time = "2026-05-28T11:59:51.673Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/74/e758c03a5ef46f04c37f2651a2893db846d569ba8a7bca469d4b58939bcd/rpds_py-2026.5.1-cp313-cp313-win32.whl", hash = "sha256:7944270ae71383f6e2657dd7d5ce4eeb4ac2d0059a6738f0510583d462ab4842", size = 212481, upload-time = "2026-05-28T11:59:53.148Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ec/a2aca432db9c7359b40fa393eeeaa0d166c2f70175be956e75fa24197c44/rpds_py-2026.5.1-cp313-cp313-win_amd64.whl", hash = "sha256:88647f43a73c4e01be19b04ceef0c8d3a1958153604d13c773becd8016f2a0cf", size = 228519, upload-time = "2026-05-28T11:59:54.505Z" },
+    { url = "https://files.pythonhosted.org/packages/29/60/a73bfdd45b096574556acf303bbd9fa9eed36ca8a818b514e2a5d5fe2b9d/rpds_py-2026.5.1-cp313-cp313-win_arm64.whl", hash = "sha256:453895624ecf7db7063b1004e44037522bbaef9ff6a945e59bc71662d7a03abd", size = 223446, upload-time = "2026-05-28T11:59:56.081Z" },
+    { url = "https://files.pythonhosted.org/packages/18/e2/408105fd611823f00882aea810f3989a30d26b1bab8b6beb20f98c724e0e/rpds_py-2026.5.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:b4e4bc98639ec915f512fde3aa7a95e0041d95d9c3cc86eea841fa63cb1e8600", size = 355287, upload-time = "2026-05-28T11:59:57.448Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/58/5c4a43436843c90d0f6d19f82c200c80e3843ca9fa07b237623327f6d384/rpds_py-2026.5.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:cacedb7a6e167680acba45ad5716e89067d225dc80da0d7040cae8c81d4572fa", size = 347033, upload-time = "2026-05-28T11:59:58.881Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/c2/1a71acdacaf4e259b10278fb87b039ded3cf80041bcd89dd8a3ea702ded6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:68700371c5d7ae1412862ddfa719090925c93ecf351c566d66f09d04b136ea00", size = 376891, upload-time = "2026-05-28T12:00:00.516Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c8/535f3d9b65addd8e28aa87b83c6e526799c3717a88273db8ea795beeef7a/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:296c799becfa849c779c8725494fe9ed94959ed886787df4364b058465bad7f0", size = 385646, upload-time = "2026-05-28T12:00:02.394Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/91/dc033f313345c354ade914dbe73cdb90b615a4409ea02430d5356794f3d8/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d3858b908218ee108d0bbfb2095ccc237648053c9bf98affad7cb079acaf1d97", size = 498830, upload-time = "2026-05-28T12:00:04.189Z" },
+    { url = "https://files.pythonhosted.org/packages/27/fc/90fcbea459dbb8ddc18a2e0fd1de9412b48bc84ffff2db771cf714bacfd6/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4fb8d2e7cb2f850b169806d61d1b991738acec96500a75c30f49caf064ce7cef", size = 392830, upload-time = "2026-05-28T12:00:05.797Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/1d/46cd11a228c9750684a798d98f878be6f614aa762438da7378f035e79e35/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:27b74c10ed6a8f190f4287f53bcfea348b92a84a9c9f70d30183d1e6172d580d", size = 379613, upload-time = "2026-05-28T12:00:07.433Z" },
+    { url = "https://files.pythonhosted.org/packages/24/4a/d9b0c6af3a1de03eb93741bbe8be2bdce84d8fda8224f3005451d86df389/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:b9a6528956191c48c52294a592dbd4a8386d7048bdb25c0efcb6b966466c6d83", size = 388183, upload-time = "2026-05-28T12:00:09.227Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b4/db7aaabdda6d020afc87d981bcc2f57a434c7dec60ecfc2ab3dd50b20351/rpds_py-2026.5.1-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:af03e34e860047bc7a352b842856fcf78798fbb81132cc98bd2f907ab4eb9cd2", size = 408578, upload-time = "2026-05-28T12:00:10.779Z" },
+    { url = "https://files.pythonhosted.org/packages/08/d6/070f6a41cbb343e2ac4171859bf3f3623e0ab002f72619d6d505313ec2de/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:fea6e836d10abbe191d557d33bd58bd5987725fe63aa1eefe557d230209855bd", size = 553573, upload-time = "2026-05-28T12:00:12.443Z" },
+    { url = "https://files.pythonhosted.org/packages/75/ab/1a71ea3589c4345dac0a0518f0e6a031cb42689277851b683c46d27463a5/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:fc0c0f878ea770a0a8a462456c5ad36fc9fe6358e6b76fdadc7f17575e0b8bf1", size = 620861, upload-time = "2026-05-28T12:00:14.09Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/22/9bf80a56069c0c443fcfefac639a86a744550a2898817a6dfd3e26654924/rpds_py-2026.5.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:e0b360f316d966b048b085857630b3cc51f3db2f07b06f440eac8f695374d1e3", size = 585633, upload-time = "2026-05-28T12:00:15.66Z" },
+    { url = "https://files.pythonhosted.org/packages/da/68/3b2c0a75c9e04125696f84ebdbbf304acf5a40b58ba4481cdb98a922c3ba/rpds_py-2026.5.1-cp313-cp313t-win32.whl", hash = "sha256:a2999883eedf72fdfb7520b92c7d4ec2572a71ff40239377aa604cc529eecafc", size = 210074, upload-time = "2026-05-28T12:00:17.291Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/8b/609157d5a25d37d4f29f92840ba531f416907c34ae5c5739dd21fc2bef98/rpds_py-2026.5.1-cp313-cp313t-win_amd64.whl", hash = "sha256:e07be2a9d7122bd6e82dea89814ef8dc893feb1aae97fec1630f3263bbb30e55", size = 228635, upload-time = "2026-05-28T12:00:18.73Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/6f/19c1918a4b590d8de87e712e4abe4b3875771eff60216fb6153cf6665c68/rpds_py-2026.5.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:1f2c391c3059798093b65df23aca2cac150460ae9c630d99dec83d703d9485b9", size = 349756, upload-time = "2026-05-28T12:00:20.217Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/60/a06fe7da34eca79dacbf958a2ba0c6eea85bc2b29de20080bf40f72f66fa/rpds_py-2026.5.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:413b424f7c4ee65ab5e5be91f5731be0f8b41a1ee2b12dfe810d716312e95a78", size = 343831, upload-time = "2026-05-28T12:00:21.711Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/ec/b2333b97b90e2a6ef6ca8ad386ee284968e74bcfe113b3f1a8d9036429a9/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2c595a1d9255dce0599e13130d1440ab2506654f2b50294226ee06402f8fef63", size = 375127, upload-time = "2026-05-28T12:00:23.326Z" },
+    { url = "https://files.pythonhosted.org/packages/14/7f/e00aae54067f2b488c4637961d5f58204d470795fc791085fa3f15060d2e/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1c27c5f6102eac8c03e7595a00827a53b271ba40a53b59ff8709170e0855ea4a", size = 379034, upload-time = "2026-05-28T12:00:24.89Z" },
+    { url = "https://files.pythonhosted.org/packages/be/cc/423999bbb8ae8dc93c77fc1d5e984ade5eb89d237d3bb884ccfa72ae2890/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6c7fcf61d44cacecaf3aea542b0e053db77972a4573e7ceda16fb2b399161195", size = 490823, upload-time = "2026-05-28T12:00:26.676Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/aa/c671bf660f12e68d3c52ff86c7066ed1372df5a0f4f2ff584e419b8207e7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2c817a189d4ee14290420e5ff051e4dd6baa13f3edf84685071dee07a6d538ee", size = 388144, upload-time = "2026-05-28T12:00:28.577Z" },
+    { url = "https://files.pythonhosted.org/packages/19/c8/d63bb75b68afe77b229e3021c6031bcaf01da5db5b0e69d0d10f9ba679a7/rpds_py-2026.5.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:21846aac0ed2e0589f38c12dc44e77bb64e494b771eadbcf169cba00566ba7ba", size = 371959, upload-time = "2026-05-28T12:00:30.304Z" },
+    { url = "https://files.pythonhosted.org/packages/82/35/c51122014d8274ff37dc606d60049c3db7d83da02b5b282511e5a906a9a6/rpds_py-2026.5.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b317c87a13f769a4e787819bd508aaa5d69aa09b0880de9af6d3a8a54571cdec", size = 383558, upload-time = "2026-05-28T12:00:31.764Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/f9/2790cb99c136a5363acdeacf5c27c56f3de0d4118a1f48fca83404c99c89/rpds_py-2026.5.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ce87129d9f2c14fa6c4a8601fb80eb4488c80d38a20cd13758ef11123e14995d", size = 402789, upload-time = "2026-05-28T12:00:33.247Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/1b/e4fb584f8c75d35c38150ff6a332cda949e6f97acba1f4fd123b14ab56fe/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9cdddb6c1207d284d94fd1530adf57fbd797fe7c4b8704ba85f49414f2557e7d", size = 551405, upload-time = "2026-05-28T12:00:34.819Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/f7/a6731b4216cb3793ea1af5391da240f5683dacc0d13e034fe5fc3503f240/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:4e237e139f94d3c036fd28eb9f564c99055476ff4ff05cd42be55ce349b5aa02", size = 616975, upload-time = "2026-05-28T12:00:36.268Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/ea/2e051a81d95d8e63f4b35a1c463a87e8766bc3d083c067c5dfb6bf220747/rpds_py-2026.5.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ed0954b524873214369184a9c82b0eaa45a3fbb9a798cd95b17e0d98499e7ea0", size = 578701, upload-time = "2026-05-28T12:00:37.82Z" },
+    { url = "https://files.pythonhosted.org/packages/65/56/b5f6fdb2083e32bca8a8993d89e70db114b4756c9e2c38421328126689d2/rpds_py-2026.5.1-cp314-cp314-win32.whl", hash = "sha256:2d88621d6a7d4dfa633d21abe90f280bb205274e16b1d1e61c6ad4640b2453b7", size = 209806, upload-time = "2026-05-28T12:00:39.492Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/80/65a5aa96c155e611d1ed844e4e1f57f3e36b021f396d9f8585d756e6b90d/rpds_py-2026.5.1-cp314-cp314-win_amd64.whl", hash = "sha256:cef8ac28d26f4dda3533060c20fbf80a325458fa9fd23ea72a73cdfa8e978838", size = 225985, upload-time = "2026-05-28T12:00:40.94Z" },
+    { url = "https://files.pythonhosted.org/packages/27/7c/ad185212e87b05f196daef92bc5f3caf07298eb47c295b5585c3dd3093ac/rpds_py-2026.5.1-cp314-cp314-win_arm64.whl", hash = "sha256:eaaea962c68cdc68d4a533ba985ab8e9484277910bbfaa2ab3ef7732667bfed8", size = 221219, upload-time = "2026-05-28T12:00:43.15Z" },
+    { url = "https://files.pythonhosted.org/packages/23/58/e14ae18759020334646b031e708ab4158d653a938822bfb7b95ef2e93aa3/rpds_py-2026.5.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:21942f52dbbd5f8758bf021213d28bd45c39e873e65e2407faf5f1846f5761ad", size = 352148, upload-time = "2026-05-28T12:00:44.638Z" },
+    { url = "https://files.pythonhosted.org/packages/31/9b/5f4a1e2f960bca3ac5d052b139dd31eed97b259f9d909173821760d542e8/rpds_py-2026.5.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f414556f6e3958300ff941e40c9f97e3dc9774ddd1b3434c475d73dd354bbed3", size = 345196, upload-time = "2026-05-28T12:00:46.14Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/71/1d9574d6a2fa20ab60eaa55c7467f5aa20cbc770f341a05f09c0876f59e2/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ef1013a8625c74043210190b246f5b1551e09757c1f356c6e4160ef96c5bc081", size = 374981, upload-time = "2026-05-28T12:00:47.531Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/9a/37e99f4915a80aa71670263c1267f7ae0af95f53a3f61e6c3bdc016d4515/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cc68e231a77a5f0d774ae278a1f8e55c0456501820847c1e4efb3829f3441df6", size = 379961, upload-time = "2026-05-28T12:00:49.216Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/ff/6e73f74b89d2e0715e0fc86b7dde893f9a61ae2f9b256ff3bdfe41ac4e94/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9baffb505aff33acc69b422a19f77806680f3c8632227d79f48de8a810d1c2c5", size = 495965, upload-time = "2026-05-28T12:00:51.111Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/e0/425faba25f59d74d4638b267f7c7a80e8649d2ef4db10a19b0c4a71e6e6f/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b8d2f912928d426e8cfa396f7f3f8d29a59e6689c86dcca3c420730c1096322b", size = 389526, upload-time = "2026-05-28T12:00:52.77Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/76/7a41960e3fddae47fab43a28684d5da981401dffd88253de0944148654cb/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90f628283be835db980c941767d41c9a27b5239e54ba0a9c1335247e82406964", size = 376190, upload-time = "2026-05-28T12:00:54.215Z" },
+    { url = "https://files.pythonhosted.org/packages/27/60/5f38dc70824fc6951b51d35377e577a3a3a4c81a6769cc5a2de25ebe0ad1/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:1ebb2f0ab7e16132995a72de805170e0203df0c3dd22e1ef1cd1fdd90bd7a131", size = 383921, upload-time = "2026-05-28T12:00:55.673Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1a/d60a38caa1505f4b9483c3fbbde12c94e1079154f4f401a6da96f7e77621/rpds_py-2026.5.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f3df3d16ded76f1f8c9cdebd0e1ea55fdf4c23b812de189814da7cf229c22a81", size = 404766, upload-time = "2026-05-28T12:00:57.518Z" },
+    { url = "https://files.pythonhosted.org/packages/87/ff/602fd3f174d6425f0bce05ad0dfbec0e96b38d0f7d08a79af5aa20083885/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9af8905b8f854990e40d5206aa5ac58d9b0fe0b7f351ff2bb086c20f6c8c6a47", size = 551343, upload-time = "2026-05-28T12:00:58.978Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/c1/1be13327acdbead3eca1fde03b6a34dbb011f1e864e217f0d32cc1779a7f/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:036a36a87fb1cd3b214d11c4b3c4f7d2ddad933625dca1c900b56a057c07740a", size = 618502, upload-time = "2026-05-28T12:01:00.656Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d7/afb49b49d7f2be8b7ba1a9f0977fa5168003437b93086726f066544e8351/rpds_py-2026.5.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:62ae3853454fe9ef283a03c96c2d835d39e84b14643a9d62c82ef0fb87d702ca", size = 581916, upload-time = "2026-05-28T12:01:02.22Z" },
+    { url = "https://files.pythonhosted.org/packages/25/d1/dbef8c1f8a10f07beb62b5f054e20099fd9924b3ec001b8f0b6ac7813a85/rpds_py-2026.5.1-cp314-cp314t-win32.whl", hash = "sha256:6c3d771a46ec18b12af06ce36243a9a80b07a5d0515236332d90863ca8bb326a", size = 207855, upload-time = "2026-05-28T12:01:03.821Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/72/bfa4e61ab8e7dc1c8adf397e05e6cbdd4239357bd72b248d3de662f23915/rpds_py-2026.5.1-cp314-cp314t-win_amd64.whl", hash = "sha256:c93c629be4636cf54337bd5f06c104d55e42ced54d681f6fe21ae510a65116f6", size = 225422, upload-time = "2026-05-28T12:01:05.194Z" },
+    { url = "https://files.pythonhosted.org/packages/27/3a/7b5da92b640f67b6717ccafc83cdd06bfa7ff2395c3685c68922bb54d703/rpds_py-2026.5.1-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:3574b55c604b8f75dacb007136508bbc0db406e626301778096a133327e7f2fb", size = 349576, upload-time = "2026-05-28T12:01:06.722Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/8a/2aafd7ad355a1bd48ca76e2262b74b15e6432b5a1efe150efd4d779cd55d/rpds_py-2026.5.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:94068eb3ae6d43f5a786b7db96a406a34e6d5c24489feef32fd6e8946ea7b291", size = 343640, upload-time = "2026-05-28T12:01:08.441Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/7d/6c9523c1abbe840a1b7fba3c516d48e1d3487cc80fea4366c4071cf56784/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f3a5b10e8ce894825f380a8f1b6444cf73c294dfea62afbb2d13e3a9e630cec1", size = 375322, upload-time = "2026-05-28T12:01:09.934Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/5d/0b7b03fb1dc509321f01de3149784ab773e34c8573022029af8076afcb9c/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fc09f82e63d4bcd58149572f857a431bae851dc747e313c3b5bdf7abb907fda8", size = 379066, upload-time = "2026-05-28T12:01:11.48Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/e2/8ef6012999ebf1cb1c22f876d9ce5e63d960fd4631d2af3202d3f480aa25/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e10464d17df3b582745c25cec695cb9558bca2cb6ddb631aee1787fc72c767b2", size = 494586, upload-time = "2026-05-28T12:01:13.051Z" },
+    { url = "https://files.pythonhosted.org/packages/80/af/1eeb029bec67582c226b7809172207cd005073af4ebd906e65ff494f4983/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ba05adbf15d994c38ec0b7ab32e858e5110c21e9009a00a86545fd220f84e038", size = 388415, upload-time = "2026-05-28T12:01:14.631Z" },
+    { url = "https://files.pythonhosted.org/packages/18/23/ffbe10711c4d766c1cab0557d6906c074f795814863c67b351355d29354a/rpds_py-2026.5.1-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:77c004fdc7b891967106f78ddfd7b076bfe6813c6139c6fff6aed3bcaa960b26", size = 372427, upload-time = "2026-05-28T12:01:16.153Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/3a/30ba4a6ad457e5b070c18d742a33fb77d8d922b565cc881f8a5313d63bfe/rpds_py-2026.5.1-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:83bcf894486c9d78dd290d3c0124ff6dd8875d3025e2090a8ec49fcc37c55fdd", size = 383615, upload-time = "2026-05-28T12:01:17.809Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/69/62e242b53ce39c0814bd24e1a6e6eba6c92be716277745f317f9540a2e7b/rpds_py-2026.5.1-cp315-cp315-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c3df104083952a0e0c6f10de33e440eabe98fb6317d23e1a58c68f6df08d01b9", size = 402786, upload-time = "2026-05-28T12:01:19.419Z" },
+    { url = "https://files.pythonhosted.org/packages/38/c1/a770b9c186928a1ed0f7e6d7ae50e7f3950ed23e3f9e366dbc8e38cb55de/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:980450826cf22e133c57e0835070bdd0dd3f73b9b708c3ce223def2cb9469e14", size = 551583, upload-time = "2026-05-28T12:01:21.013Z" },
+    { url = "https://files.pythonhosted.org/packages/21/7c/68e8579b95375b70d2a963103c42e705856cdb98569258bd807f4423891c/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:205dde846f24332ab0c1188699a043b8d165b79bb84529ce272c45048ff6be01", size = 616941, upload-time = "2026-05-28T12:01:22.548Z" },
+    { url = "https://files.pythonhosted.org/packages/70/a1/a6135aed5730ff03ab957182259987ac11e55fb392a28dc6f0592048a280/rpds_py-2026.5.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:3966b82dd563176396df030f3dd52a6e54cb69b718e95e78bd555ed3d1e0185d", size = 578349, upload-time = "2026-05-28T12:01:24.118Z" },
+    { url = "https://files.pythonhosted.org/packages/09/6e/f24201a76a84e6c49d0bdfdfcb735210e21701e9b21c5bfc0ba497dd62f6/rpds_py-2026.5.1-cp315-cp315-win32.whl", hash = "sha256:7818f8d0a415be74d2be3590b0a1c1f463a642f4d0217e7d10602dceef5b79aa", size = 209922, upload-time = "2026-05-28T12:01:25.522Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/e4/966bc240bb0485fc265278f6de44d05834bf0b3618886e0b22e33d54c49a/rpds_py-2026.5.1-cp315-cp315-win_amd64.whl", hash = "sha256:b3cc20c0d800af78fd0fac68086e28c1856cec51ea528bb81ea851aa40d39325", size = 226003, upload-time = "2026-05-28T12:01:27.062Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/5c/a15a59269cd5e74472734516c73795c15eccfc841b3d4b0228c3f53f19d0/rpds_py-2026.5.1-cp315-cp315-win_arm64.whl", hash = "sha256:3609e9939a8a76cd904cf98a3f1f13b5dc7e150adeaee89e0ea09652ea213e16", size = 221245, upload-time = "2026-05-28T12:01:28.51Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/22/135ce03804e179a71ceb13be095deda4a279bc88f7a6b8fa161c5ad44e12/rpds_py-2026.5.1-cp315-cp315t-macosx_10_12_x86_64.whl", hash = "sha256:5d333a7127d4b307601ac37792bee01bb95c867cbfacf21b6375b804d6bbd723", size = 352015, upload-time = "2026-05-28T12:01:30.214Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/5f/f1f6d2652eb9d848f6eb369d8db83a2da6249bb49ad2c2a48f45d54538d3/rpds_py-2026.5.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:b5f077b44a4f7808520f66dae234988d867deb9aed9be5da057ce9ba831b2a41", size = 345016, upload-time = "2026-05-28T12:01:31.656Z" },
+    { url = "https://files.pythonhosted.org/packages/88/66/b74182775691ea2290c99e52ac8d5db844e56fbec90ce421f107658c8314/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:55d8f9b7b78c9538fc9e04e82ec0e888ff0c3cffcfad152c77e57cd09351a98a", size = 374775, upload-time = "2026-05-28T12:01:33.136Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/8f/15e5a61d9f0a43902d36561d4f07cae6ae9f4716be825159fd72717f33af/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e3a8ae58895ac107ed934a6bf51e5846f95c53b9b940c2c6d310838fd5846358", size = 380270, upload-time = "2026-05-28T12:01:34.574Z" },
+    { url = "https://files.pythonhosted.org/packages/02/c3/f859b12763a80540cdf2af0f15b19904cf756a71d7bdd3f82ff3e5b1bbf9/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0957cf3c2b8632ec7aaebffebea8005b353cc2a237b6e2ae3c2cac0820704cfb", size = 495285, upload-time = "2026-05-28T12:01:36.127Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/c7/ff27c2ac8411d30b03b1829fd88cae8dad1a4d0da48dd25e57c4038042e6/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c396c1304de421050b3681ea70f371874b54d41b0151e96109758144c231e30b", size = 389581, upload-time = "2026-05-28T12:01:37.635Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/67/fe92ee32a6cc05c77228a2f8b1762e7124f386ec20ff83d0757b762d58d0/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aad1bff7f666b9598e573815affd666aac6a13a585dde336f843e33350c7fadc", size = 376041, upload-time = "2026-05-28T12:01:39.307Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/91/b4d6685c27aba55bd82f25b278be8237038117d05f9659a6213ad3408130/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:656a042550878f12d45752452d47094b7cfe5ad1e9d7b87b5a22ad3ae5ff8015", size = 383946, upload-time = "2026-05-28T12:01:41.043Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/79/2c1d832a53c8e0f8e98fc970ec257b950fecd4f62be2ab7182b500a0cbc8/rpds_py-2026.5.1-cp315-cp315t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:73c4bd4f70294737b5206a3e8e30ccadbf8a60301831c8ea23eec5dbeea1ecfa", size = 405526, upload-time = "2026-05-28T12:01:43.032Z" },
+    { url = "https://files.pythonhosted.org/packages/78/c4/c98117b03c6a8581ab2c2dfccfe9a5ad82bd8128a3c28b46a6ad2d97c393/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:43bca78665423cabae77146f2fe7ce55272b6c8d55d82cca83effd42c7e13972", size = 551165, upload-time = "2026-05-28T12:01:44.648Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/c1/bc479ca069200af730881b1bd525e3114b2b391a351509fcb1b772f28086/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:42d0f20e85e549c870749d0e247f0c10d318a45b7e9676d575d2dcb04a1b2e66", size = 618778, upload-time = "2026-05-28T12:01:46.337Z" },
+    { url = "https://files.pythonhosted.org/packages/77/65/38ab2f90df44c2febfb63cc10ced40763d9b4bc94d173e734528663fe7f5/rpds_py-2026.5.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:b1be5c35683684d5331b93600c210e8367c254683d8a6df6bd21bd2da3a334fb", size = 581839, upload-time = "2026-05-28T12:01:48.109Z" },
+    { url = "https://files.pythonhosted.org/packages/15/2d/ce1f605fe036aadd460e5822e578c6c7ec3a860936cca37d6e0f299daa77/rpds_py-2026.5.1-cp315-cp315t-win32.whl", hash = "sha256:75808f6c38ce7749bb68cc2770161aae5045e6c6f6781a9782e74b93304399df", size = 207866, upload-time = "2026-05-28T12:01:49.648Z" },
+    { url = "https://files.pythonhosted.org/packages/79/cb/966040123eb102371559746908ef2c9471f4d43e17ec9a645a2258dab64b/rpds_py-2026.5.1-cp315-cp315t-win_amd64.whl", hash = "sha256:90bd6630002a1c7f09e7843dd79f0d24f3d2897cc25a753480917865d14f15b3", size = 225441, upload-time = "2026-05-28T12:01:51.408Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.15.6"
@@ -1413,6 +2201,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/7f/d0/578c47dd68152ddddddf31cd7fc67dc30b7cdf639a86275fda821b0d9d98/ruff-0.15.6-py3-none-win_arm64.whl", hash = "sha256:c34de3dd0b0ba203be50ae70f5910b17188556630e2178fd7d79fc030eb0d837", size = 11060497, upload-time = "2026-03-12T23:05:25.968Z" },
 ]
 
+[[package]]
+name = "secretstorage"
+version = "3.5.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cryptography" },
+    { name = "jeepney" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/1c/03/e834bcd866f2f8a49a85eaff47340affa3bfa391ee9912a952a1faa68c7b/secretstorage-3.5.0.tar.gz", hash = "sha256:f04b8e4689cbce351744d5537bf6b1329c6fc68f91fa666f60a380edddcd11be", size = 19884, upload-time = "2025-11-23T19:02:53.191Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/46/f5af3402b579fd5e11573ce652019a67074317e18c1935cc0b4ba9b35552/secretstorage-3.5.0-py3-none-any.whl", hash = "sha256:0ce65888c0725fcb2c5bc0fdb8e5438eece02c523557ea40ce0703c266248137", size = 15554, upload-time = "2025-11-23T19:02:51.545Z" },
+]
+
 [[package]]
 name = "six"
 version = "1.17.0"
@@ -1461,6 +2262,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/5e/f5/0c41cb68dcae6b7de4fac4188a3a9589e21fb31df21ea3a2e888db95e6c9/soupsieve-2.8.4-py3-none-any.whl", hash = "sha256:e7e6b0769c8f51ed59acab6e994b00621096cfb1c640a7509295987388fbaf65", size = 37304, upload-time = "2026-05-24T13:55:55.406Z" },
 ]
 
+[[package]]
+name = "sse-starlette"
+version = "3.4.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "starlette" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f7/2b/58abc2d1fd397e7dde08e947e05c884d8ef2f78d5e2588c17a12d42d6994/sse_starlette-3.4.4.tar.gz", hash = "sha256:07e0fa0460138baf25cdd5fb28683472c3995dc1642225191b3832d62526bcb0", size = 31819, upload-time = "2026-05-12T17:37:17.019Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/67/805710444ea8cc75fbf70b920ed431a560c4bf9c57f7d5a3117213189399/sse_starlette-3.4.4-py3-none-any.whl", hash = "sha256:3f4dd50d8aed2771a091f3a83000323fc3844541c16b4fe585ae2420cc6df973", size = 16514, upload-time = "2026-05-12T17:37:15.601Z" },
+]
+
 [[package]]
 name = "starlette"
 version = "1.2.1"
@@ -1507,6 +2321,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
 ]
 
+[[package]]
+name = "uncalled-for"
+version = "0.3.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b5/82/345cc927f7fbdae6065e7768759932fcc827fc20b29b45dfbafa2f1f7da4/uncalled_for-0.3.2.tar.gz", hash = "sha256:89f5dbcd71e2b8f47c030b1fa302e6cce2ec795d1ac565eeb6525c5fe55cb8a2", size = 50032, upload-time = "2026-05-06T13:38:25.204Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/25/2c87754f3a9e692315f7b811244090e68f362979fc8886b3fbd2985a1d8c/uncalled_for-0.3.2-py3-none-any.whl", hash = "sha256:0ff60b142c7d1f8070bde9d42afaa70aedc77dcc10998c227687e9c15713418e", size = 11444, upload-time = "2026-05-06T13:38:24.025Z" },
+]
+
 [[package]]
 name = "urllib3"
 version = "2.6.3"

From 629c10dc7cdd04da1e47e6f92eebef07d74b48ae Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 20 Jun 2026 05:24:44 +0000
Subject: [PATCH 7/7] Fix CLAUDE.md doc inaccuracies and avoid logging full
 helper-agent prompts

- CLAUDE.md described run_tool() as synchronous and claimed MCP tool routing
  uses rpartition; both are wrong (run_tool is async, routing uses partition)
- helper_agent tool logged the full user prompt at INFO level, which can leak
  sensitive data (tokens, credentials) into application logs; log only the
  prompt length instead
---
 CLAUDE.md                 | 4 ++--
 app/tools/helper_agent.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 192d8c5..e0912cf 100755
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -84,11 +84,11 @@ Current built-in tools: `read_file`, `write_file`, `bash`, `web_fetch`, `get_ski
 
 `_HELPER_AGENT_TOOLS` in `tool_calls.py` is an explicit allowlist of tools available to `HelperAgent` (used internally by scheduled tasks). Scheduled task mutation tools (`add/update/remove_scheduled_task`) are excluded to prevent recursion.
 
-`get_all_tool_specs()` merges built-in specs with any MCP tool specs at call time (not module load). `run_tool_async()` is the async dispatcher used by `handle_tool_call` — it routes to `MCPManager.call_tool()` for MCP tools or falls through to the synchronous `run_tool()` for built-ins.
+`get_all_tool_specs()` merges built-in specs with any MCP tool specs at call time (not module load). `run_tool_async()` is the async dispatcher used by `handle_tool_call` — it routes to `MCPManager.call_tool()` for MCP tools or falls through to `run_tool()` for built-ins.
 
 ### MCP Servers
 
-`MCPManager` (`app/core/mcp_manager.py`) owns persistent FastMCP client connections and their tool catalogs. It is a module-level singleton (`mcp_manager`). `initialize_mcp()` in `main.py` reads `mcp_servers.json`, then calls `mcp_manager.initialize()` which connects all servers concurrently via `asyncio.gather`. Each server's tools are discovered via `list_tools()` and registered under the namespace `servername__toolname` (`_SEP = "__"`). `rpartition` is used when routing calls so tool names may contain underscores freely; only the server name must not contain `__`.
+`MCPManager` (`app/core/mcp_manager.py`) owns persistent FastMCP client connections and their tool catalogs. It is a module-level singleton (`mcp_manager`). `initialize_mcp()` in `main.py` reads `mcp_servers.json`, then calls `mcp_manager.initialize()` which connects all servers concurrently via `asyncio.gather`. Each server's tools are discovered via `list_tools()` and registered under the namespace `servername__toolname` (`_SEP = "__"`). `partition` is used when routing calls so tool names may contain underscores freely; only the server name must not contain `__`.
 
 The singleton is shut down via `mcp_manager.shutdown()` in a `try/finally` block in `main()`. `HelperAgent` does not receive MCP tools — it uses the static `helper_tool_specs` allowlist to prevent recursion.
 
diff --git a/app/tools/helper_agent.py b/app/tools/helper_agent.py
index 5315d31..00cb8e0 100755
--- a/app/tools/helper_agent.py
+++ b/app/tools/helper_agent.py
@@ -29,7 +29,7 @@ def spec():
 
     @staticmethod
     async def call(prompt: str, system_prompt: str = None) -> str:
-        log.info(f"helper_agent tool called with prompt: {prompt}")
+        log.info(f"helper_agent tool called, prompt length: {len(prompt)}")
         from ..core.helper_agent import HelperAgent
         agent = HelperAgent(system_prompt=system_prompt)
         return await agent.run(prompt)