pygpt-net 2.6.20__py3-none-any.whl → 2.6.22__py3-none-any.whl

pygpt_net/core/bridge/context.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.01 19:00:00                  #
+# Updated Date: 2025.08.23 15:00:00                  #
 # ================================================== #
 
 import json
@@ -22,32 +22,32 @@ class BridgeContext:
 
         :param kwargs: keyword arguments
         """
+        self.assistant_id = kwargs.get("assistant_id", "")
+        self.attachments = kwargs.get("attachments", [])
         self.ctx = kwargs.get("ctx", None)
+        self.external_functions = kwargs.get("external_functions", [])
+        self.file_ids = kwargs.get("file_ids", [])
+        self.force = kwargs.get("force", False)  # Force mode flag
+        self.force_sync = kwargs.get("force_sync", False)  # Force sync flag
         self.history = kwargs.get("history", [])
+        self.idx = kwargs.get("idx", None)
+        self.idx_mode = kwargs.get("idx_mode", "chat")
+        self.is_expert_call = kwargs.get("is_expert_call", False)  # Expert call flag
+        self.max_tokens = kwargs.get("max_tokens", 0)
         self.mode = kwargs.get("mode", None)
-        self.parent_mode = kwargs.get("parent_mode", None)  # real mode (global)
         self.model = kwargs.get("model", None)  # model instance, not model name
-        self.temperature = kwargs.get("temperature", 1.0)
+        self.multimodal_ctx = kwargs.get("multimodal_ctx", MultimodalContext())  # AudioContext
+        self.parent_mode = kwargs.get("parent_mode", None)  # real mode (global)
+        self.preset = kwargs.get("preset", None)  # PresetItem
         self.prompt = kwargs.get("prompt", "")
+        self.reply_context = kwargs.get("reply_ctx", None)  # ReplyContext
+        self.request = kwargs.get("request", False)  # Use normal request instead of quick call
+        self.stream = kwargs.get("stream", False)
         self.system_prompt = kwargs.get("system_prompt", "")
         self.system_prompt_raw = kwargs.get("system_prompt_raw", "")  # without plugins addons
-        self.stream = kwargs.get("stream", False)
-        self.assistant_id = kwargs.get("assistant_id", "")
+        self.temperature = kwargs.get("temperature", 1.0)
         self.thread_id = kwargs.get("thread_id", "")
-        self.external_functions = kwargs.get("external_functions", [])
         self.tools_outputs = kwargs.get("tools_outputs", [])
-        self.max_tokens = kwargs.get("max_tokens", 150)
-        self.idx = kwargs.get("idx", None)
-        self.idx_mode = kwargs.get("idx_mode", "chat")
-        self.attachments = kwargs.get("attachments", [])
-        self.file_ids = kwargs.get("file_ids", [])
-        self.reply_context = kwargs.get("reply_ctx", None)  # ReplyContext
-        self.multimodal_ctx = kwargs.get("multimodal_ctx", MultimodalContext())  # AudioContext
-        self.is_expert_call = kwargs.get("is_expert_call", False)  # Expert call flag
-        self.force_sync = kwargs.get("force_sync", False)  # Force sync flag
-        self.request = kwargs.get("request", False)  # Use normal request instead of quick call
-        self.preset = kwargs.get("preset", None)  # PresetItem
-        self.force = kwargs.get("force", False)  # Force mode flag
 
         # check types
         if self.ctx is not None and not isinstance(self.ctx, CtxItem):
@@ -62,38 +62,36 @@ class BridgeContext:
         :return: dictionary
         """
         data = {
+            "assistant_id": self.assistant_id,
+            "attachments": self.attachments,
             "ctx": self.ctx,
-            "reply_context": self.reply_context.to_dict() if self.reply_context else None,
+            "external_functions": self.external_functions,
+            "file_ids": self.file_ids,
+            "force_sync": self.force_sync,
             "history": len(self.history),
+            "idx": self.idx,
+            "idx_mode": self.idx_mode,
+            "is_expert_call": self.is_expert_call,
+            "max_tokens": self.max_tokens,
             "mode": self.mode,
-            "parent_mode": self.parent_mode,
             "model": self.model,
-            "temperature": self.temperature,
+            "parent_mode": self.parent_mode,
             "prompt": self.prompt,
+            "reply_context": self.reply_context.to_dict() if self.reply_context else None,
+            "request": self.request,
+            "stream": self.stream,
             "system_prompt": self.system_prompt,
             "system_prompt_raw": self.system_prompt_raw,
-            "stream": self.stream,
-            "assistant_id": self.assistant_id,
+            "temperature": self.temperature,
             "thread_id": self.thread_id,
-            "external_functions": self.external_functions,
             "tools_outputs": self.tools_outputs,
-            "max_tokens": self.max_tokens,
-            "idx": self.idx,
-            "idx_mode": self.idx_mode,
-            "attachments": self.attachments,
-            "file_ids": self.file_ids,
-            "is_expert_call": self.is_expert_call,
-            "force_sync": self.force_sync,
-            "request": self.request,
         }
         if self.ctx is not None:
             data["ctx"] = self.ctx.to_dict(True)
         if self.model is not None:
             data["model"] = self.model.to_dict()
 
-        # sort by keys
-        data = dict(sorted(data.items(), key=lambda item: item[0]))
-        return data
+        return dict(sorted(data.items(), key=lambda item: item[0]))  # sort by keys
 
     def dump(self) -> str:
         """
@@ -135,5 +133,4 @@ class MultimodalContext:
             "audio_format": self.audio_format,
         }
         # sort by keys
-        data = dict(sorted(data.items(), key=lambda item: item[0]))
-        return data
+        return dict(sorted(data.items(), key=lambda item: item[0]))

pygpt_net/core/ctx/container.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.05 21:00:00                  #
+# Updated Date: 2025.08.24 23:00:00                  #
 # ================================================== #
 
 from typing import List
@@ -15,9 +15,9 @@ from PySide6.QtWidgets import QVBoxLayout, QWidget
 
 from pygpt_net.core.tabs.tab import Tab
 from pygpt_net.ui.widget.textarea.output import ChatOutput
+from pygpt_net.item.ctx import CtxItem
 
 from .bag import Bag
-from ...item.ctx import CtxItem
 
 
 class Container:
@@ -28,8 +28,7 @@ class Container:
         :param window: Window
         """
         self.window = window
-        self.bags = {}
-        self.bags[0] = Bag(window)  # always create initial bag
+        self.bags = {0: Bag(window)}
 
     def get(self, tab: Tab) -> QWidget:
         """
@@ -92,14 +91,16 @@ class Container:
 
         :param tab: Tab
         """
-        if tab.pid in self.window.ui.nodes['output_plain']:
-            self.window.ui.nodes['output_plain'][tab.pid].on_delete()  # clean up
-            self.window.ui.nodes['output_plain'][tab.pid] = None
-            del self.window.ui.nodes['output_plain'][tab.pid]
-        if tab.pid in self.window.ui.nodes['output']:
-            self.window.ui.nodes['output'][tab.pid].on_delete()  # clean up
-            self.window.ui.nodes['output'][tab.pid] = None
-            del self.window.ui.nodes['output'][tab.pid]
+        nodes = self.window.ui.nodes
+
+        if tab.pid in nodes['output_plain']:
+            nodes['output_plain'][tab.pid].on_delete()  # clean up
+            nodes['output_plain'][tab.pid] = None
+            del nodes['output_plain'][tab.pid]
+        if tab.pid in nodes['output']:
+            nodes['output'][tab.pid].on_delete()  # clean up
+            nodes['output'][tab.pid] = None
+            del nodes['output'][tab.pid]
 
         self.window.controller.chat.render.remove_pid(tab.pid)  # remove pid data from renderer registry
         self.window.core.ctx.output.remove_pid(tab.pid)  # remove pid from ctx output mapping

pygpt_net/core/ctx/ctx.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.15 23:00:00                  #
+# Updated Date: 2025.08.24 02:00:00                  #
 # ================================================== #
 
 import copy

pygpt_net/core/ctx/output.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2024.12.14 08:00:00                  #
+# Updated Date: 2025.08.24 23:00:00                  #
 # ================================================== #
 
 from typing import Optional, List, Dict
@@ -87,6 +87,9 @@ class Output:
     def is_mapped(self, meta: CtxMeta) -> bool:
         """
         Check if meta is mapped anywhere
+
+        :param meta: Meta
+        :return: True if mapped, False otherwise
         """
         self.init()
 
@@ -182,6 +185,8 @@ class Output:
     def is_empty(self) -> bool:
         """
         Check if mapping is empty for the active PID across columns
+
+        :return: True if empty, False otherwise
         """
         self.init()
 
@@ -211,9 +216,7 @@ class Output:
         return self.store(meta)
 
     def clear(self):
-        """
-        Clear mapping
-        """
+        """Clear mapping"""
         self.mapping.clear()
         self.last_pids.clear()
         self.last_pid = 0

pygpt_net/core/db/database.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2024.12.14 08:00:00                  #
+# Updated Date: 2025.08.24 02:00:00                  #
 # ================================================== #
 
 import os
@@ -60,6 +60,7 @@ class Database:
             'output',
             'input_name',
             'output_name',
+            'extra',
             'input_ts',
             'output_ts',
             'mode',
@@ -74,7 +75,6 @@ class Database:
             'files_json',
             'attachments_json',
             'additional_ctx_json',
-            'extra',
             'hidden_input',
             'hidden_output',
             'input_tokens',

pygpt_net/core/debug/console/console.py

@@ -6,10 +6,10 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.11 18:00:00                  #
+# Updated Date: 2025.08.24 23:00:00                  #
 # ================================================== #
 
-from qasync import QApplication
+from PySide6.QtWidgets import QApplication
 
 from pygpt_net.utils import mem_clean
 

pygpt_net/core/debug/debug.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.19 07:00:00                  #
+# Updated Date: 2025.08.24 02:00:00                  #
 # ================================================== #
 
 import gc
@@ -416,6 +416,17 @@ class Debug:
         print("\n".join(stats))
         return res
 
+    def trace(self):
+        """
+        Print current stack trace
+
+        Prints the current stack trace and returns it as a string.
+        """
+        stack = traceback.format_stack()
+        formatted_trace = "".join(stack)
+        print(formatted_trace)
+        return formatted_trace
+
     def pause(self, *args):
         """
         Pause execution

pygpt_net/core/dispatcher/dispatcher.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.18 01:00:00                  #
+# Updated Date: 2025.08.23 15:00:00                  #
 # ================================================== #
 
 from typing import List, Tuple
@@ -47,6 +47,9 @@ class Dispatcher:
         :param all: bool: If True, dispatch to all plugins regardless of their state.
         :return: Tuple[List[str], BaseEvent]: A tuple containing a list of affected plugin IDs and the event.
         """
+        if not isinstance(event, BaseEvent):
+            raise RuntimeError(f"Not an event object: {event}")
+
         if not isinstance(event, RenderEvent):
             event.call_id = self.call_id
 
@@ -68,6 +71,7 @@ class Dispatcher:
 
         handled = False
 
+        # kernel
         if isinstance(event, KernelEvent):
             kernel_auto = (KernelEvent.INIT, KernelEvent.RESTART, KernelEvent.STOP, KernelEvent.TERMINATE)
             if event.name not in kernel_auto:
@@ -78,6 +82,7 @@ class Dispatcher:
             if event.name not in kernel_auto:
                 handled = True
 
+        # render
         elif isinstance(event, RenderEvent):
             controller.chat.render.handle(event)
             if log_event:
@@ -85,11 +90,28 @@ class Dispatcher:
             self.call_id += 1
             handled = True
 
+        # tools
         wnd.tools.handle(event)
 
         if handled:
             return [], event
 
+        # agents
+        controller.agent.handle(event)
+
+        # ctx
+        controller.ctx.handle(event)
+
+        # model
+        controller.model.handle(event)
+
+        # idx
+        controller.idx.handle(event)
+
+        # ui
+        controller.ui.handle(event)
+
+        # access
         if isinstance(event, (ControlEvent, AppEvent)):
             controller.access.handle(event)
 
@@ -98,6 +120,7 @@ class Dispatcher:
         plugins_dict = plugins_mgr.plugins
         plugin_ids = tuple(plugins_dict.keys())
 
+        # plugins
         for pid in plugin_ids:
             if controller.plugins.is_enabled(pid) or all:
                 if event.stop:

pygpt_net/core/events/app.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2024.12.14 08:00:00                  #
+# Updated Date: 2025.08.23 21:00:00                  #
 # ================================================== #
 
 from typing import Optional
@@ -16,16 +16,16 @@ from .base import BaseEvent
 class AppEvent(BaseEvent):
     """Events dispatched by application"""
     APP_STARTED = "app.started"
+    CAMERA_CAPTURED = "camera.captured"
+    CAMERA_DISABLED = "camera.disabled"
+    CAMERA_ENABLED = "camera.enabled"
+    CTX_ATTACHMENTS_CLEAR = "ctx.attachments.clear"
     CTX_CREATED = "ctx.created"
     CTX_END = "ctx.end"
     CTX_SELECTED = "ctx.selected"
-    CTX_ATTACHMENTS_CLEAR = "ctx.attachments.clear"
-    CAMERA_ENABLED = "camera.enabled"
-    CAMERA_DISABLED = "camera.disabled"
-    CAMERA_CAPTURED = "camera.captured"
+    INPUT_CALL = "input.call"
     INPUT_ERROR = "input.error"
     INPUT_SENT = "input.sent"
-    INPUT_CALL = "input.call"
     INPUT_STOPPED = "input.stopped"
     INPUT_VOICE_LISTEN_STARTED = "input.voice.listen.started"
     INPUT_VOICE_LISTEN_STOPPED = "input.voice.listen.stopped"
@@ -33,10 +33,10 @@ class AppEvent(BaseEvent):
     MODEL_SELECTED = "model.selected"
     PRESET_SELECTED = "preset.selected"
     TAB_SELECTED = "tab.switch"
-    VOICE_CONTROL_TOGGLE = "voice.control.toggle"
     VOICE_CONTROL_STARTED = "voice.control.started"
     VOICE_CONTROL_STOPPED = "voice.control.stopped"
     VOICE_CONTROL_SENT = "voice.control.sent"
+    VOICE_CONTROL_TOGGLE = "voice.control.toggle"
     VOICE_CONTROL_UNRECOGNIZED = "voice.control.unrecognized"
 
     def __init__(

pygpt_net/core/events/control.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.03.02 19:00:00                  #
+# Updated Date: 2025.08.23 21:00:00                  #
 # ================================================== #
 
 from typing import Optional
@@ -16,42 +16,42 @@ from .base import BaseEvent
 
 class ControlEvent(BaseEvent):
     """Events used for app control"""
-    APP_STATUS = "app.status"
     APP_EXIT = "app.exit"
-    CMD_CONFIRM = "cmd.confirm"
-    CMD_LIST = "cmd.list"
-    AUDIO_OUTPUT_ENABLE = "audio.output.enable"
-    AUDIO_OUTPUT_DISABLE = "audio.output.disable"
-    AUDIO_INPUT_ENABLE = "audio.input.enable"
+    APP_STATUS = "app.status"
     AUDIO_INPUT_DISABLE = "audio.input.disable"
+    AUDIO_INPUT_ENABLE = "audio.input.enable"
+    AUDIO_OUTPUT_DISABLE = "audio.output.disable"
+    AUDIO_OUTPUT_ENABLE = "audio.output.enable"
     CALENDAR_ADD = "calendar.add"
     CALENDAR_CLEAR = "calendar.clear"
     CALENDAR_READ = "calendar.read"
-    CAMERA_ENABLE = "camera.enable"
-    CAMERA_DISABLE = "camera.disable"
     CAMERA_CAPTURE = "camera.capture"
-    CTX_NEW = "ctx.new"
-    CTX_PREV = "ctx.prev"
-    CTX_NEXT = "ctx.next"
-    CTX_LAST = "ctx.last"
-    CTX_INPUT_FOCUS = "ctx.input.focus"
-    CTX_INPUT_SEND = "ctx.input.send"
-    CTX_INPUT_CLEAR = "ctx.input.clear"
-    CTX_STOP = "ctx.stop"
+    CAMERA_DISABLE = "camera.disable"
+    CAMERA_ENABLE = "camera.enable"
+    CMD_CONFIRM = "cmd.confirm"
+    CMD_LIST = "cmd.list"
     CTX_ATTACHMENTS_CLEAR = "ctx.attachments.clear"
     CTX_CURRENT = "ctx.current"
-    CTX_READ_LAST = "ctx.read.last"
+    CTX_INPUT_CLEAR = "ctx.input.clear"
+    CTX_INPUT_FOCUS = "ctx.input.focus"
+    CTX_INPUT_SEND = "ctx.input.send"
+    CTX_LAST = "ctx.last"
+    CTX_NEW = "ctx.new"
+    CTX_NEXT = "ctx.next"
+    CTX_PREV = "ctx.prev"
     CTX_READ_ALL = "ctx.read.all"
+    CTX_READ_LAST = "ctx.read.last"
     CTX_RENAME = "ctx.rename"
-    CTX_SEARCH_STRING = "ctx.search.string"
     CTX_SEARCH_CLEAR = "ctx.search.clear"
-    INPUT_SEND = "input.send"
+    CTX_SEARCH_STRING = "ctx.search.string"
+    CTX_STOP = "ctx.stop"
     INPUT_APPEND = "input.append"
+    INPUT_SEND = "input.send"
     MODE_CHAT = "mode.chat"
-    MODE_RESEARCH = "mode.research"
     MODE_LLAMA_INDEX = "mode.llama_index"
     MODE_NEXT = "mode.next"
     MODE_PREV = "mode.prev"
+    MODE_RESEARCH = "mode.research"
     MODEL_NEXT = "model.next"
     MODEL_PREV = "model.prev"
     NOTE_ADD = "note.add"
@@ -59,20 +59,20 @@ class ControlEvent(BaseEvent):
     NOTEPAD_READ = "notepad.read"
     PRESET_NEXT = "preset.next"
     PRESET_PREV = "preset.prev"
-    TAB_CHAT = "tab.chat"
     TAB_CALENDAR = "tab.calendar"
+    TAB_CHAT = "tab.chat"
     TAB_DRAW = "tab.draw"
     TAB_FILES = "tab.files"
-    TAB_NOTEPAD = "tab.notepad"
     TAB_NEXT = "tab.next"
+    TAB_NOTEPAD = "tab.notepad"
     TAB_PREV = "tab.prev"
-    VOICE_MESSAGE_START = "voice_msg.start"
-    VOICE_MESSAGE_STOP = "voice_msg.stop"
-    VOICE_MESSAGE_TOGGLE = "voice_msg.toggle"
     VOICE_COMMAND_START = "voice_cmd.start"
     VOICE_COMMAND_STOP = "voice_cmd.stop"
     VOICE_COMMAND_TOGGLE = "voice_cmd.toggle"
     VOICE_CONTROL_UNRECOGNIZED = "unrecognized"
+    VOICE_MESSAGE_START = "voice_msg.start"
+    VOICE_MESSAGE_STOP = "voice_msg.stop"
+    VOICE_MESSAGE_TOGGLE = "voice_msg.toggle"
 
     def __init__(
             self,

pygpt_net/core/events/event.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.06.30 02:00:00                  #
+# Updated Date: 2025.08.23 21:00:00                  #
 # ================================================== #
 
 import json
@@ -23,13 +23,14 @@ class Event(BaseEvent):
     AUDIO_INPUT_RECORD_START = "audio.input.record.start"  # start audio input recording
     AUDIO_INPUT_RECORD_STOP = "audio.input.record.stop"  # stop audio input recording
     AUDIO_INPUT_RECORD_TOGGLE = "audio.input.record.toggle"  # toggle audio input recording
-    AUDIO_INPUT_TRANSCRIBE = "audio.input.transcribe"  # transcribe audio file
     AUDIO_INPUT_STOP = "audio.input.stop"
     AUDIO_INPUT_TOGGLE = "audio.input.toggle"
+    AUDIO_INPUT_TRANSCRIBE = "audio.input.transcribe"  # transcribe audio file
     AUDIO_OUTPUT_STOP = "audio.output.stop"
     AUDIO_OUTPUT_TOGGLE = "audio.output.toggle"
     AUDIO_PLAYBACK = "audio.playback"
     AUDIO_READ_TEXT = "audio.read_text"
+    BRIDGE_BEFORE = "bridge.before"
     CMD_EXECUTE = "cmd.execute"
     CMD_INLINE = "cmd.inline"
     CMD_SYNTAX = "cmd.syntax"
@@ -42,14 +43,16 @@ class Event(BaseEvent):
     DISABLE = "disable"
     ENABLE = "enable"
     FORCE_STOP = "force.stop"
+    INPUT_ACCEPT = "input.accept"
     INPUT_BEFORE = "input.before"
+    INPUT_BEGIN = "input.begin"
     MODE_BEFORE = "mode.before"
     MODE_SELECT = "mode.select"
     MODEL_BEFORE = "model.before"
     MODEL_SELECT = "model.select"
     MODELS_CHANGED = "models.changed"
-    PLUGIN_SETTINGS_CHANGED = "plugin.settings.changed"
     PLUGIN_OPTION_GET = "plugin.option.get"
+    PLUGIN_SETTINGS_CHANGED = "plugin.settings.changed"
     POST_PROMPT = "post.prompt"
     POST_PROMPT_ASYNC = "post.prompt.async"
     POST_PROMPT_END = "post.prompt.end"

pygpt_net/core/events/kernel.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.01 19:00:00                  #
+# Updated Date: 2025.08.23 21:00:00                  #
 # ================================================== #
 
 from typing import Optional
@@ -50,8 +50,8 @@ class KernelEvent(BaseEvent):
     # state
     STATE = "kernel.state"
     STATE_BUSY = "kernel.state.busy"
-    STATE_IDLE = "kernel.state.idle"
     STATE_ERROR = "kernel.state.error"
+    STATE_IDLE = "kernel.state.idle"
     STATUS = "kernel.status"
 
     LIVE_APPEND = "kernel.live.append"

pygpt_net/core/events/render.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.08.01 19:00:00                  #
+# Updated Date: 2025.08.23 21:00:00                  #
 # ================================================== #
 
 from typing import Optional
@@ -18,13 +18,13 @@ class RenderEvent(BaseEvent):
     """Events used for rendering"""
     BEGIN = "render.begin"
     END = "render.end"
+    FRESH = "render.fresh"
+    PREPARE = "render.prepare"
     RELOAD = "render.reload"
     RESET = "render.reset"
-    PREPARE = "render.prepare"
-    FRESH = "render.fresh"
 
-    STREAM_BEGIN = "render.stream.begin"
     STREAM_APPEND = "render.stream.append"
+    STREAM_BEGIN = "render.stream.begin"
     STREAM_END = "render.stream.end"
     STREAM_NEXT = "render.stream.next"
 
@@ -33,37 +33,37 @@ class RenderEvent(BaseEvent):
     CLEAR_INPUT = "render.clear.input"
     CLEAR_OUTPUT = "render.clear.output"
 
+    CTX_APPEND = "render.ctx.append"
     INPUT_APPEND = "render.input.append"
     OUTPUT_APPEND = "render.output.append"
-    CTX_APPEND = "render.ctx.append"
 
-    EXTRA_BEGIN = "render.extra.begin"
     EXTRA_APPEND = "render.extra.append"
+    EXTRA_BEGIN = "render.extra.begin"
     EXTRA_END = "render.extra.end"
 
+    ON_EDIT_DISABLE = "render.on.edit.disable"
+    ON_EDIT_ENABLE = "render.on.edit.enable"
     ON_LOAD = "render.on.load"
     ON_PAGE_LOAD = "render.on.page.load"
+    ON_SWITCH = "render.on.switch"
     ON_THEME_CHANGE = "render.on.theme.change"
-    ON_EDIT_ENABLE = "render.on.edit.enable"
-    ON_EDIT_DISABLE = "render.on.edit.disable"
-    ON_TS_ENABLE = "render.on.ts.enable"
     ON_TS_DISABLE = "render.on.ts.disable"
-    ON_SWITCH = "render.on.switch"
+    ON_TS_ENABLE = "render.on.ts.enable"
 
     TOOL_BEGIN = "render.tool.begin"
-    TOOL_UPDATE = "render.tool.update"
     TOOL_CLEAR = "render.tool.clear"
     TOOL_END = "render.tool.end"
+    TOOL_UPDATE = "render.tool.update"
 
-    ACTION_REGEN_SUBMIT = "render.action.regen.submit"
     ACTION_EDIT_SUBMIT = "render.action.edit.submit"
+    ACTION_REGEN_SUBMIT = "render.action.regen.submit"
 
     ITEM_DELETE_ID = "render.item.delete.id"
     ITEM_DELETE_FROM_ID = "render.item.delete.from_id"
 
-    STATE_IDLE = "render.state.idle"
     STATE_BUSY = "render.state.busy"
     STATE_ERROR = "render.state.error"
+    STATE_IDLE = "render.state.idle"
 
     LIVE_APPEND = "render.live.append"
     LIVE_CLEAR = "render.live.clear"