Add /help command

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 data/*
 !data/.gitkeep
+__pycache__/

pyproject.toml

@@ -17,3 +17,8 @@ quadnite-bot = "quadnite_bot:main"
 [build-system]
 requires = ["uv_build>=0.11.7,<0.12.0"]
 build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "ipdb>=0.13.13",
+]

src/quadnite_bot/__main__.py

@@ -1,3 +1,5 @@
+import logging
+
 from deltabot_cli import BotCli
 from deltachat2 import events
 
@@ -6,6 +8,8 @@ from quadnite_bot.command_registry import dispatcher
 def main():
     cli = BotCli("quadnite-bot")
 
+    logging.basicConfig(level=logging.DEBUG)
+
     cli.on(events.NewMessage)(dispatcher)
 
     cli.start()

src/quadnite_bot/command.py

@@ -1,12 +1,28 @@
 from abc import ABC, abstractmethod
+import logging
 import re
 from deltachat2 import Bot, MsgData, NewMsgEvent
 
+
+logger = logging.getLogger(__name__)
+
 class Context:
-    def __init__(self, bot: Bot, accid: int, event: NewMsgEvent) -> None:
+    match: re.Match[str] | None
+    params: str
+    args: list[str]
+
+    def __init__(self, bot: Bot, accid: int, event: NewMsgEvent, command: "Command") -> None:
         self.bot = bot
         self.accid = accid
         self.event = event
+        if command.command:
+            self.params = re.sub(fr"^/{command.command}\s+", "", event.msg.text)
+        else:
+            self.params = event.msg.text
+        self.args = re.split(r"\s+", self.params)
+        self.match = None
+        if command.regex:
+            self.match = command.regex.search(event.msg.text)
 
     def reply(self, text: str):
         self.bot.rpc.send_msg(
@@ -18,14 +34,21 @@ class Context:
 
 class Command(ABC):
     command: str|None = None
+    commands: list[str]|None = None
     regex: re.Pattern|None = None
     run_next: bool = False
 
     def handles_message(self, event: NewMsgEvent) -> bool:
-        if self.command:
-            return event.msg.text.lower().startswith(f"/{self.command.lower()} ")
+        commands = [self.command] if self.command else self.commands
+        if commands:
+            for command in commands:
+                user_input = event.msg.text.lower()
+                expected_input = f"/{command.lower()}"
+                if user_input == expected_input or user_input.startswith(expected_input + " "):
+                    return True
+            return False
         if self.regex:
-            return self.regex.search(event.msg) is not None
+            return self.regex.search(event.msg.text) is not None
         raise NotImplementedError(f"The command has neither 'command' nor 'regex' set. Required one of the two.")
 
     @abstractmethod
@@ -33,7 +56,7 @@ class Command(ABC):
         pass
 
     def __call__(self, bot: Bot, accid: int, event: NewMsgEvent) -> None:
-        self.process_event(Context(bot, accid, event), event)
+        self.process_event(Context(bot, accid, event, self), event)
 
 
 class CommandDispatcher:
@@ -44,8 +67,11 @@ class CommandDispatcher:
         self._commands.append(command)
 
     def __call__(self, bot: Bot, accid: int, event: NewMsgEvent) -> None:
+        logger.info("Received new message")
         for command in self._commands:
+            logger.debug("Checking against %s", command)
             if command.handles_message(event):
+                logger.info("Match found. Running the command %s", command)
                 command(bot, accid, event)
                 if not command.run_next:
                     break

src/quadnite_bot/command_registry.py

@@ -1,6 +1,19 @@
 from quadnite_bot.command import CommandDispatcher
+from quadnite_bot.commands.absurdify import AbsurdifyCommand
+from quadnite_bot.commands.dice import DiceMatch
 from quadnite_bot.commands.echo import EchoCommand
+from quadnite_bot.commands.help import HelpCommand
+from quadnite_bot.commands.random import CoinCommand, QuestionCommand, WordCommand, WordsCommand
+from quadnite_bot.commands.response import ResponseCommands
 
 dispatcher = CommandDispatcher()
 
 dispatcher.add_command(EchoCommand())
+dispatcher.add_command(AbsurdifyCommand())
+dispatcher.add_command(DiceMatch())
+dispatcher.add_command(QuestionCommand())
+dispatcher.add_command(WordCommand())
+dispatcher.add_command(WordsCommand())
+dispatcher.add_command(CoinCommand())
+dispatcher.add_command(ResponseCommands())
+dispatcher.add_command(HelpCommand())

src/quadnite_bot/commands/absurdify.py

@@ -0,0 +1,16 @@
+import random
+
+from deltachat2 import NewMsgEvent
+
+from quadnite_bot.command import Command, Context
+
+def _absurdify(text):
+    return "".join(
+        random.choice([char.upper(), char.lower()]) for char in text
+    )
+
+class AbsurdifyCommand(Command):
+    command = "absurdify"
+
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        ctx.reply(_absurdify(ctx.params))

src/quadnite_bot/commands/dice.py

@@ -0,0 +1,69 @@
+import random
+import re
+import operator
+
+from deltachat2 import NewMsgEvent
+from quadnite_bot.command import Command, Context
+
+
+class DiceMatch(Command):
+    regex = re.compile(
+        r"""^
+       /?                            # optional slash at beginning
+       (\d*)d(\d+)                   # num of dice + num of side
+       (\s*(kh|kl)\s*(\d+))?         # keep highest / lowest
+       (\s*([-+><]|>=|<=)\s*(\d+))?  # modifier for sum / count successes
+       $""",
+        re.I | re.VERBOSE,
+    )
+
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        if not ctx.match:
+            return
+        num_dice = int(ctx.match.group(1) or 1)
+        dice_sides = int(ctx.match.group(2))
+        if num_dice > 50:
+            ctx.reply("Maximum of 50 dice allowed")
+
+        if dice_sides > 1000:
+            ctx.reply("Number of sides must be 1000 or lower")
+        rolls = [random.randint(1, dice_sides) for _ in range(num_dice)]
+
+        message = "\n".join(
+            f"You rolled a D{dice_sides} and got a {roll}" for roll in rolls
+        )
+        message += "\n\n"
+
+        keep = ctx.match.group(4)
+        if keep:
+            keep_count = int(ctx.match.group(5))
+            rolls = sorted(rolls, reverse=keep=="kh")[:keep_count]
+
+        modifier = ctx.match.group(7)
+        modifier_value = ctx.match.group(8)
+        if modifier_value:
+            modifier_value = int(modifier_value)
+        else:
+            modifier_value = 0
+        if modifier in [None, "+", "-"]:
+            total = sum(rolls)
+            if modifier == "+":
+                total += modifier_value
+            elif modifier == "-":
+                total -= modifier_value
+            message += f"Total = {total}"
+        elif modifier in [">", "<", "<=", ">="]:
+            successes = 0
+            op_map = {
+                ">": operator.gt,
+                "<": operator.lt,
+                ">=": operator.ge,
+                "<=": operator.le,
+            }
+            for roll in rolls:
+                if op_map[modifier](roll, modifier_value):
+                    successes += 1
+
+            message += f"You got {successes} successes."
+
+        ctx.reply(message)

src/quadnite_bot/commands/help.py

@@ -0,0 +1,17 @@
+from pathlib import Path
+from deltachat2 import NewMsgEvent
+from quadnite_bot.command import Command, Context
+
+
+class HelpCommand(Command):
+    command = "help"
+
+    def __init__(self):
+        self.responses = []
+        for file in sorted((Path(__file__).resolve().parent.parent / "static/help").iterdir()):
+            with open(file) as f:
+                self.responses.append(f.read())
+
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        for response in self.responses:
+            ctx.reply(response)

src/quadnite_bot/commands/random.py

@@ -0,0 +1,53 @@
+from pathlib import Path
+import random
+
+from deltachat2 import NewMsgEvent
+
+from quadnite_bot.command import Command, Context
+
+
+class BaseRandomCommand(Command):
+    filename: str
+    def __init__(self):
+        file = Path(__file__).resolve().parent.parent / "static" / self.filename
+        with open(file) as f:
+            self.options = [line.strip() for line in f.readlines()]
+
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        ctx.reply(random.choice(self.options))
+
+
+class QuestionCommand(BaseRandomCommand):
+    filename = "questions.txt"
+    command = "question"
+
+
+class WordCommand(BaseRandomCommand):
+    filename = "words.txt"
+    command = "word"
+
+
+class WordsCommand(BaseRandomCommand):
+    filename = "words.txt"
+    command = "words"
+
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        count = 10
+        if ctx.args:
+            try:
+                count = int(ctx.args[0])
+            except ValueError:
+                ctx.reply(f"{ctx.args[0]!r} is not a number.")
+                return
+
+        if count > 50:
+            count = 50
+            ctx.reply("Number too high. Limiting to 50.")
+
+        ctx.reply("\n".join(random.choices(self.options, k=count)))
+
+
+class CoinCommand(BaseRandomCommand):
+    command = 'coin'
+    def __init__(self):
+        self.options = ['Heads', 'Tails']

src/quadnite_bot/commands/response.py

@@ -0,0 +1,19 @@
+import random
+
+from deltachat2 import NewMsgEvent
+from quadnite_bot.command import Command, Context
+
+
+class ResponseCommands(Command):
+    commands = ["is", "are", "can", "will", "shall", "was", "do", "does", "did", "should"]
+    def process_event(self, ctx: Context, event: NewMsgEvent) -> None:
+        ctx.reply(
+            random.choice(
+                random.choice(
+                    [
+                        ["Yes", "Yep", "Yeah", "Yus", "Ja", "Ya", "Aye", "Ay", "Oui"],
+                        ["No", "Nopes", "Nu", "Nah", "Nein", "Naw", "Nay", "Yesn't"],
+                    ]
+                )
+            )
+        )

src/quadnite_bot/static/commands_list.txt

@@ -1,71 +0,0 @@
-<b>Random</b>
-
-coin - Tosses a coin
-wiki - Search Wikipedia
-arch_wiki - Search the Arch wiki
-kys - Kill yourself
-insult - As expected, insults
-
-<b>Wordplay</b>
-
-question - Get a random question
-word - Get a random word
-words - Get n random words
-weebify - Weebifies the given text
-absurdify - mAke tExT aBSUrd
-expand - Expands a given abbreviation
-
-<b>Ask a question</b>
-<code>
-is       are   can
-will     did   shall
-was      do    does
-should
-</code>
-<b>Roleplay</b>
-<code>
-angry       bite
-blush       bored
-bonk        boop
-chase       cheer
-cringe      cry
-cuddle      dab
-dance       die
-eat         facepalm
-feed        glomp
-happy       hate
-holdhands   hide
-highfive    hug
-kill        kiss
-laugh       lick
-love        lurk
-nervous     no
-nom         nuzzle
-panic       pat
-peck        poke
-pout        run
-shoot       shrug
-sip         slap
-sleep       snuggle
-stab        tease
-think       thumbsup
-tickle      triggered
-twerk       wag
-wave        wink
-yes
-</code>
-<b>Miscellaneous</b>
-
-help - Need help? Go here
-feedback - Send feedback, suggestions for kys, insult text
-rate - Rate me on TGDR
-
-<b>Dice</b>
-
-<code>[num]d[sides] [modifier]</code>
-
-<i>num</i> is the number of the dices to roll. (Optional)
-<i>sides</i> is the number of sides of the dice. (Required)
-<i>modifier</i> is in the form of + or - followed by a number. (Optional)
-
-<i>Examples</i>: 1d6, 2d10 + 5, 3d20 - 2, 2d20

src/quadnite_bot/static/help/10_random.txt

@@ -0,0 +1,5 @@
+Random
+
+/coin - Tosses a coin
+/wiki [search term] - Search Wikipedia
+/arch_wiki [search term] - Search the Arch wiki

src/quadnite_bot/static/help/20_wordplay.txt

@@ -0,0 +1,8 @@
+Wordplay
+
+/question - Get a random question
+/word - Get a random word
+/words [n] - Get n random words
+/weebify [text] - Weebifies the given text
+/absurdify [text] - mAke tExT aBSUrd
+/expand [word] - Expands a given abbreviation

src/quadnite_bot/static/help/30_question.txt

@@ -0,0 +1,8 @@
+Ask a question
+
+/<command> [question]
+
+/is       /are   /can
+/will     /did   /shall
+/was      /do    /does
+/should

src/quadnite_bot/static/help/40_roleplay.txt

@@ -0,0 +1,42 @@
+Roleplay
+
+/<command> [@user1] [@user2] ... [@userN] [message]
+
+(All arguments to the commands are optional)
+
+/angry       /bite
+/blush       /bored
+/bonk        /boop
+/chase       /cheer
+/cringe      /cry
+/cuddle      /dab
+/dance       /die
+/eat         /facepalm
+/feed        /glomp
+/happy       /hate
+/holdhands   /hide
+/highfive    /hug
+/kill        /kiss
+/laugh       /lick
+/love        /lurk
+/nervous     /no
+/nom         /nuzzle
+/panic       /pat
+/peck        /poke
+/pout        /run
+/shoot       /shrug
+/sip         /slap
+/sleep       /snuggle
+/stab        /tease
+/think       /thumbsup
+/tickle      /triggered
+/twerk       /wag
+/wave        /wink
+/yes
+
+
+Examples:
+
+/hug @foobar
+/slap making me angry
+/holdhands @baz biz

src/quadnite_bot/static/help/50_dice.txt

@@ -0,0 +1,16 @@
+Dice
+
+[num]d[sides] [keep modifier] [modifier]
+
+num is the number of the dices to roll. (Optional)
+sides is the number of sides of the dice. (Required)
+keep_modifier is in the form of kh or kl followed by a number. This only keeps either the highest or lowest dice. (Optional)
+modifier is in the form of +, -, >, <, >= or <= followed by a number. In case of + or -, the number is added or subtracted to the total. In case of >, <, >= or <=, the dice roll is checked against the condition and counted as a success if it matches it.(Optional)
+
+Examples:
+1d6
+2d10 + 5
+3d20 kh2 - 2
+2d20 kl 2
+10d6 >= 6
+6d20 < 10

uv.lock

@@ -11,6 +11,33 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/3b/00/2344469e2084fb287c2e0b57b72910309874c3245463acd6cf5e3db69324/appdirs-1.4.4-py2.py3-none-any.whl", hash = "sha256:a841dacd6b99318a741b166adb07e19ee71a274450e68237b4650ca1055ab128", size = 9566, upload-time = "2020-05-11T07:59:49.499Z" },
 ]
 
+[[package]]
+name = "asttokens"
+version = "3.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/be/a5/8e3f9b6771b0b408517c82d97aed8f2036509bc247d46114925e32fe33f0/asttokens-3.0.1.tar.gz", hash = "sha256:71a4ee5de0bde6a31d64f6b13f2293ac190344478f081c3d1bccfcf5eacb0cb7", size = 62308, upload-time = "2025-11-15T16:43:48.578Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/39/e7eaf1799466a4aef85b6a4fe7bd175ad2b1c6345066aa33f1f58d4b18d0/asttokens-3.0.1-py3-none-any.whl", hash = "sha256:15a3ebc0f43c2d0a50eeafea25e19046c68398e487b9f1f5b517f7c0f40f976a", size = 27047, upload-time = "2025-11-15T16:43:16.109Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+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 = "decorator"
+version = "5.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/fa/6d96a0978d19e17b68d634497769987b16c8f4cd0a7a05048bec693caa6b/decorator-5.2.1.tar.gz", hash = "sha256:65f266143752f734b0a7cc83c46f4618af75b8c5911b00ccb61d0ac9b6da0360", size = 56711, upload-time = "2025-02-24T04:41:34.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4e/8c/f3147f5c4b73e7550fe5f9352eaa956ae838d5c51eb58e7a25b9f3e2643b/decorator-5.2.1-py3-none-any.whl", hash = "sha256:d316bb415a2d9e2d2b3abcc4084c6502fc09240e292cd76a76afc106a1c8e04a", size = 9190, upload-time = "2025-02-24T04:41:32.565Z" },
+]
+
 [[package]]
 name = "deltabot-cli"
 version = "8.1.0"
@@ -57,6 +84,74 @@ full = [
     { name = "deltachat-rpc-server" },
 ]
 
+[[package]]
+name = "executing"
+version = "2.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cc/28/c14e053b6762b1044f34a13aab6859bbf40456d37d23aa286ac24cfd9a5d/executing-2.2.1.tar.gz", hash = "sha256:3632cc370565f6648cc328b32435bd120a1e4ebb20c77e3fdde9a13cd1e533c4", size = 1129488, upload-time = "2025-09-01T09:48:10.866Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/ea/53f2148663b321f21b5a606bd5f191517cf40b7072c0497d3c92c4a13b1e/executing-2.2.1-py2.py3-none-any.whl", hash = "sha256:760643d3452b4d777d295bb167ccc74c64a81df23fb5e08eff250c425a4b2017", size = 28317, upload-time = "2025-09-01T09:48:08.5Z" },
+]
+
+[[package]]
+name = "ipdb"
+version = "0.13.13"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "decorator" },
+    { name = "ipython" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/1b/7e07e7b752017f7693a0f4d41c13e5ca29ce8cbcfdcc1fd6c4ad8c0a27a0/ipdb-0.13.13.tar.gz", hash = "sha256:e3ac6018ef05126d442af680aad863006ec19d02290561ac88b8b1c0b0cfc726", size = 17042, upload-time = "2023-03-09T15:40:57.487Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/4c/b075da0092003d9a55cf2ecc1cae9384a1ca4f650d51b00fc59875fe76f6/ipdb-0.13.13-py3-none-any.whl", hash = "sha256:45529994741c4ab6d2388bfa5d7b725c2cf7fe9deffabdb8a6113aa5ed449ed4", size = 12130, upload-time = "2023-03-09T15:40:55.021Z" },
+]
+
+[[package]]
+name = "ipython"
+version = "9.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "decorator" },
+    { name = "ipython-pygments-lexers" },
+    { name = "jedi" },
+    { name = "matplotlib-inline" },
+    { name = "pexpect", marker = "sys_platform != 'emscripten' and sys_platform != 'win32'" },
+    { name = "prompt-toolkit" },
+    { name = "psutil" },
+    { name = "pygments" },
+    { name = "stack-data" },
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/cd/c4/87cda5842cf5c31837c06ddb588e11c3c35d8ece89b7a0108c06b8c9b00a/ipython-9.13.0.tar.gz", hash = "sha256:7e834b6afc99f020e3f05966ced34792f40267d64cb1ea9043886dab0dde5967", size = 4430549, upload-time = "2026-04-24T12:24:55.221Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b9/86/3060e8029b7cc505cce9a0137431dda81d0a3fde93a8f0f50ee0bf37a795/ipython-9.13.0-py3-none-any.whl", hash = "sha256:57f9d4639e20818d328d287c7b549af3d05f12486ea8f2e7f73e52a36ec4d201", size = 627274, upload-time = "2026-04-24T12:24:53.038Z" },
+]
+
+[[package]]
+name = "ipython-pygments-lexers"
+version = "1.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ef/4c/5dd1d8af08107f88c7f741ead7a40854b8ac24ddf9ae850afbcf698aa552/ipython_pygments_lexers-1.1.1.tar.gz", hash = "sha256:09c0138009e56b6854f9535736f4171d855c8c08a563a0dcd8022f78355c7e81", size = 8393, upload-time = "2025-01-17T11:24:34.505Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d9/33/1f075bf72b0b747cb3288d011319aaf64083cf2efef8354174e3ed4540e2/ipython_pygments_lexers-1.1.1-py3-none-any.whl", hash = "sha256:a9462224a505ade19a605f71f8fa63c2048833ce50abc86768a0d81d876dc81c", size = 8074, upload-time = "2025-01-17T11:24:33.271Z" },
+]
+
+[[package]]
+name = "jedi"
+version = "0.20.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "parso" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/46/b7/a3635f6a2d7cf5b5dd98064fc1d5fbbafcb25477bcea204a3a92145d158b/jedi-0.20.0.tar.gz", hash = "sha256:c3f4ccbd276696f4b19c54618d4fb18f9fc24b0aef02acf704b23f487daa1011", size = 3119416, upload-time = "2026-05-01T23:38:47.814Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9a/93/242e2eab5fe682ffcb8b0084bde703a41d51e17ee0f3a31ff0d9d813620a/jedi-0.20.0-py2.py3-none-any.whl", hash = "sha256:7bdd9c2634f56713299976f4cbd59cb3fa92165cc5e05ea811fb253480728b67", size = 4884812, upload-time = "2026-05-01T23:38:43.919Z" },
+]
+
 [[package]]
 name = "markdown-it-py"
 version = "4.0.0"
@@ -69,6 +164,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
 ]
 
+[[package]]
+name = "matplotlib-inline"
+version = "0.2.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "traitlets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bd/c0/9f7c9a46090390368a4d7bcb76bb87a4a36c421e4c0792cdb53486ffac7a/matplotlib_inline-0.2.2.tar.gz", hash = "sha256:72f3fe8fce36b70d4a5b612f899090cd0401deddc4ea90e1572b9f4bfb058c79", size = 8150, upload-time = "2026-05-08T17:33:33.49Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/09/5b161152e2d90f7b87f781c2e1267494aef9c32498df793f73ad0a0a494a/matplotlib_inline-0.2.2-py3-none-any.whl", hash = "sha256:3c821cf1c209f59fb2d2d64abbf5b23b67bcb2210d663f9918dd851c6da1fcf6", size = 9534, upload-time = "2026-05-08T17:33:32.055Z" },
+]
+
 [[package]]
 name = "mdurl"
 version = "0.1.2"
@@ -78,6 +185,85 @@ 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 = "parso"
+version = "0.8.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/30/4b/90c937815137d43ce71ba043cd3566221e9df6b9c805f24b5d138c9d40a7/parso-0.8.7.tar.gz", hash = "sha256:eaaac4c9fdd5e9e8852dc778d2d7405897ec510f2a298071453e5e3a07914bb1", size = 401824, upload-time = "2026-05-01T23:13:02.138Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/99/5d/8268b644392ee874ee82a635cd0df1773de230bde356c38de28e298392cc/parso-0.8.7-py2.py3-none-any.whl", hash = "sha256:a8926eb2a1b915486941fdbd31e86a4baf88fe8c210f25f2f35ecec5b574ca1c", size = 107025, upload-time = "2026-05-01T23:12:58.867Z" },
+]
+
+[[package]]
+name = "pexpect"
+version = "4.9.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ptyprocess" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/c3/059298687310d527a58bb01f3b1965787ee3b40dce76752eda8b44e9a2c5/pexpect-4.9.0-py2.py3-none-any.whl", hash = "sha256:7236d1e080e4936be2dc3e326cec0af72acf9212a7e1d060210e70a47e253523", size = 63772, upload-time = "2023-11-25T06:56:14.81Z" },
+]
+
+[[package]]
+name = "prompt-toolkit"
+version = "3.0.52"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "wcwidth" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a1/96/06e01a7b38dce6fe1db213e061a4602dd6032a8a97ef6c1a862537732421/prompt_toolkit-3.0.52.tar.gz", hash = "sha256:28cde192929c8e7321de85de1ddbe736f1375148b02f2e17edd840042b1be855", size = 434198, upload-time = "2025-08-27T15:24:02.057Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/84/03/0d3ce49e2505ae70cf43bc5bb3033955d2fc9f932163e84dc0779cc47f48/prompt_toolkit-3.0.52-py3-none-any.whl", hash = "sha256:9aac639a3bbd33284347de5ad8d68ecc044b91a762dc39b7c21095fcd6a19955", size = 391431, upload-time = "2025-08-27T15:23:59.498Z" },
+]
+
+[[package]]
+name = "psutil"
+version = "7.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/aa/c6/d1ddf4abb55e93cebc4f2ed8b5d6dbad109ecb8d63748dd2b20ab5e57ebe/psutil-7.2.2.tar.gz", hash = "sha256:0746f5f8d406af344fd547f1c8daa5f5c33dbc293bb8d6a16d80b4bb88f59372", size = 493740, upload-time = "2026-01-28T18:14:54.428Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/51/08/510cbdb69c25a96f4ae523f733cdc963ae654904e8db864c07585ef99875/psutil-7.2.2-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:2edccc433cbfa046b980b0df0171cd25bcaeb3a68fe9022db0979e7aa74a826b", size = 130595, upload-time = "2026-01-28T18:14:57.293Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/f5/97baea3fe7a5a9af7436301f85490905379b1c6f2dd51fe3ecf24b4c5fbf/psutil-7.2.2-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:e78c8603dcd9a04c7364f1a3e670cea95d51ee865e4efb3556a3a63adef958ea", size = 131082, upload-time = "2026-01-28T18:14:59.732Z" },
+    { url = "https://files.pythonhosted.org/packages/37/d6/246513fbf9fa174af531f28412297dd05241d97a75911ac8febefa1a53c6/psutil-7.2.2-cp313-cp313t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1a571f2330c966c62aeda00dd24620425d4b0cc86881c89861fbc04549e5dc63", size = 181476, upload-time = "2026-01-28T18:15:01.884Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/b5/9182c9af3836cca61696dabe4fd1304e17bc56cb62f17439e1154f225dd3/psutil-7.2.2-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:917e891983ca3c1887b4ef36447b1e0873e70c933afc831c6b6da078ba474312", size = 184062, upload-time = "2026-01-28T18:15:04.436Z" },
+    { url = "https://files.pythonhosted.org/packages/16/ba/0756dca669f5a9300d0cbcbfae9a4c30e446dfc7440ffe43ded5724bfd93/psutil-7.2.2-cp313-cp313t-win_amd64.whl", hash = "sha256:ab486563df44c17f5173621c7b198955bd6b613fb87c71c161f827d3fb149a9b", size = 139893, upload-time = "2026-01-28T18:15:06.378Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/61/8fa0e26f33623b49949346de05ec1ddaad02ed8ba64af45f40a147dbfa97/psutil-7.2.2-cp313-cp313t-win_arm64.whl", hash = "sha256:ae0aefdd8796a7737eccea863f80f81e468a1e4cf14d926bd9b6f5f2d5f90ca9", size = 135589, upload-time = "2026-01-28T18:15:08.03Z" },
+    { url = "https://files.pythonhosted.org/packages/81/69/ef179ab5ca24f32acc1dac0c247fd6a13b501fd5534dbae0e05a1c48b66d/psutil-7.2.2-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:eed63d3b4d62449571547b60578c5b2c4bcccc5387148db46e0c2313dad0ee00", size = 130664, upload-time = "2026-01-28T18:15:09.469Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/64/665248b557a236d3fa9efc378d60d95ef56dd0a490c2cd37dafc7660d4a9/psutil-7.2.2-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7b6d09433a10592ce39b13d7be5a54fbac1d1228ed29abc880fb23df7cb694c9", size = 131087, upload-time = "2026-01-28T18:15:11.724Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/2e/e6782744700d6759ebce3043dcfa661fb61e2fb752b91cdeae9af12c2178/psutil-7.2.2-cp314-cp314t-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1fa4ecf83bcdf6e6c8f4449aff98eefb5d0604bf88cb883d7da3d8d2d909546a", size = 182383, upload-time = "2026-01-28T18:15:13.445Z" },
+    { url = "https://files.pythonhosted.org/packages/57/49/0a41cefd10cb7505cdc04dab3eacf24c0c2cb158a998b8c7b1d27ee2c1f5/psutil-7.2.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e452c464a02e7dc7822a05d25db4cde564444a67e58539a00f929c51eddda0cf", size = 185210, upload-time = "2026-01-28T18:15:16.002Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/2c/ff9bfb544f283ba5f83ba725a3c5fec6d6b10b8f27ac1dc641c473dc390d/psutil-7.2.2-cp314-cp314t-win_amd64.whl", hash = "sha256:c7663d4e37f13e884d13994247449e9f8f574bc4655d509c3b95e9ec9e2b9dc1", size = 141228, upload-time = "2026-01-28T18:15:18.385Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/fc/f8d9c31db14fcec13748d373e668bc3bed94d9077dbc17fb0eebc073233c/psutil-7.2.2-cp314-cp314t-win_arm64.whl", hash = "sha256:11fe5a4f613759764e79c65cf11ebdf26e33d6dd34336f8a337aa2996d71c841", size = 136284, upload-time = "2026-01-28T18:15:19.912Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/36/5ee6e05c9bd427237b11b3937ad82bb8ad2752d72c6969314590dd0c2f6e/psutil-7.2.2-cp36-abi3-macosx_10_9_x86_64.whl", hash = "sha256:ed0cace939114f62738d808fdcecd4c869222507e266e574799e9c0faa17d486", size = 129090, upload-time = "2026-01-28T18:15:22.168Z" },
+    { url = "https://files.pythonhosted.org/packages/80/c4/f5af4c1ca8c1eeb2e92ccca14ce8effdeec651d5ab6053c589b074eda6e1/psutil-7.2.2-cp36-abi3-macosx_11_0_arm64.whl", hash = "sha256:1a7b04c10f32cc88ab39cbf606e117fd74721c831c98a27dc04578deb0c16979", size = 129859, upload-time = "2026-01-28T18:15:23.795Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/70/5d8df3b09e25bce090399cf48e452d25c935ab72dad19406c77f4e828045/psutil-7.2.2-cp36-abi3-manylinux2010_x86_64.manylinux_2_12_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:076a2d2f923fd4821644f5ba89f059523da90dc9014e85f8e45a5774ca5bc6f9", size = 155560, upload-time = "2026-01-28T18:15:25.976Z" },
+    { url = "https://files.pythonhosted.org/packages/63/65/37648c0c158dc222aba51c089eb3bdfa238e621674dc42d48706e639204f/psutil-7.2.2-cp36-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b0726cecd84f9474419d67252add4ac0cd9811b04d61123054b9fb6f57df6e9e", size = 156997, upload-time = "2026-01-28T18:15:27.794Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/13/125093eadae863ce03c6ffdbae9929430d116a246ef69866dad94da3bfbc/psutil-7.2.2-cp36-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:fd04ef36b4a6d599bbdb225dd1d3f51e00105f6d48a28f006da7f9822f2606d8", size = 148972, upload-time = "2026-01-28T18:15:29.342Z" },
+    { url = "https://files.pythonhosted.org/packages/04/78/0acd37ca84ce3ddffaa92ef0f571e073faa6d8ff1f0559ab1272188ea2be/psutil-7.2.2-cp36-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:b58fabe35e80b264a4e3bb23e6b96f9e45a3df7fb7eed419ac0e5947c61e47cc", size = 148266, upload-time = "2026-01-28T18:15:31.597Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/90/e2159492b5426be0c1fef7acba807a03511f97c5f86b3caeda6ad92351a7/psutil-7.2.2-cp37-abi3-win_amd64.whl", hash = "sha256:eb7e81434c8d223ec4a219b5fc1c47d0417b12be7ea866e24fb5ad6e84b3d988", size = 137737, upload-time = "2026-01-28T18:15:33.849Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/c7/7bb2e321574b10df20cbde462a94e2b71d05f9bbda251ef27d104668306a/psutil-7.2.2-cp37-abi3-win_arm64.whl", hash = "sha256:8c233660f575a5a89e6d4cb65d9f938126312bca76d8fe087b947b3a1aaac9ee", size = 134617, upload-time = "2026-01-28T18:15:36.514Z" },
+]
+
+[[package]]
+name = "ptyprocess"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/e5/16ff212c1e452235a90aeb09066144d0c5a6a8c0834397e03f5224495c4e/ptyprocess-0.7.0.tar.gz", hash = "sha256:5c5d0a3b48ceee0b48485e0c26037c0acd7d29765ca3fbb5cb3831d347423220", size = 70762, upload-time = "2020-12-28T15:15:30.155Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/22/a6/858897256d0deac81a172289110f31629fc4cee19b6f01283303e18c8db3/ptyprocess-0.7.0-py2.py3-none-any.whl", hash = "sha256:4b41f3967fce3af57cc7e94b888626c18bf37a083e3651ca8feeb66d492fef35", size = 13993, upload-time = "2020-12-28T15:15:28.35Z" },
+]
+
+[[package]]
+name = "pure-eval"
+version = "0.2.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/05/0a34433a064256a578f1783a10da6df098ceaa4a57bbeaa96a6c0352786b/pure_eval-0.2.3.tar.gz", hash = "sha256:5f4e983f40564c576c7c8635ae88db5956bb2229d7e9237d03b3c0b0190eaf42", size = 19752, upload-time = "2024-07-21T12:58:21.801Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8e/37/efad0257dc6e593a18957422533ff0f87ede7c9c6ea010a2177d738fb82f/pure_eval-0.2.3-py3-none-any.whl", hash = "sha256:1db8e35b67b3d218d818ae653e27f06c3aa420901fa7b081ca98cbedc874e0d0", size = 11842, upload-time = "2024-07-21T12:58:20.04Z" },
+]
+
 [[package]]
 name = "pygments"
 version = "2.20.0"
@@ -95,9 +281,17 @@ dependencies = [
     { name = "deltabot-cli" },
 ]
 
+[package.dev-dependencies]
+dev = [
+    { name = "ipdb" },
+]
+
 [package.metadata]
 requires-dist = [{ name = "deltabot-cli", specifier = ">=8.1.0" }]
 
+[package.metadata.requires-dev]
+dev = [{ name = "ipdb", specifier = ">=0.13.13" }]
+
 [[package]]
 name = "rich"
 version = "15.0.0"
@@ -110,3 +304,35 @@ sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13
 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 = "stack-data"
+version = "0.6.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "asttokens" },
+    { name = "executing" },
+    { name = "pure-eval" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/28/e3/55dcc2cfbc3ca9c29519eb6884dd1415ecb53b0e934862d3559ddcb7e20b/stack_data-0.6.3.tar.gz", hash = "sha256:836a778de4fec4dcd1dcd89ed8abff8a221f58308462e1c4aa2a3cf30148f0b9", size = 44707, upload-time = "2023-09-30T13:58:05.479Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f1/7b/ce1eafaf1a76852e2ec9b22edecf1daa58175c090266e9f6c64afcd81d91/stack_data-0.6.3-py3-none-any.whl", hash = "sha256:d5558e0c25a4cb0853cddad3d77da9891a08cb85dd9f9f91b9f8cd66e511e695", size = 24521, upload-time = "2023-09-30T13:58:03.53Z" },
+]
+
+[[package]]
+name = "traitlets"
+version = "5.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1b/22/40f55b26baeab80c2d7b3f1db0682f8954e4617fee7d90ce634022ef05c6/traitlets-5.15.0.tar.gz", hash = "sha256:4fead733f81cf1c4c938e06f8ca4633896833c9d89eff878159457f4d4392971", size = 163197, upload-time = "2026-05-06T08:05:58.016Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/98/a9937a969d018a23badfea0b381f66783649d48e0ea6c41923265c3cbeb3/traitlets-5.15.0-py3-none-any.whl", hash = "sha256:fb36a18867a6803deab09f3c5e0fa81bb7b26a5c9e82501c9933f759166eff40", size = 85877, upload-time = "2026-05-06T08:05:55.853Z" },
+]
+
+[[package]]
+name = "wcwidth"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2c/ee/afaf0f85a9a18fe47a67f1e4422ed6cf1fe642f0ae0a2f81166231303c52/wcwidth-0.7.0.tar.gz", hash = "sha256:90e3a7ea092341c44b99562e75d09e4d5160fe7a3974c6fb842a101a95e7eed0", size = 182132, upload-time = "2026-05-02T16:04:12.653Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/52/e465037f5375f43533d1a80b6923955201596a99142ed524d77b571a1418/wcwidth-0.7.0-py3-none-any.whl", hash = "sha256:5d69154c429a82910e241c738cd0e2976fac8a2dd47a1a805f4afed1c0f136f2", size = 110825, upload-time = "2026-05-02T16:04:11.033Z" },
+]