Refactor firstLoadInit to include initCustomSelectedSamplers and addDebugFunctions

Update parameters for Mancer: +XTC, +DRY, -Mirostat

.dockerignore

@@ -13,3 +13,4 @@ access.log
 /cache
 .DS_Store
 /public/scripts/extensions/third-party
+/colab

.eslintrc.cjs

@@ -3,6 +3,9 @@ module.exports = {
     extends: [
         'eslint:recommended',
     ],
+    plugins: [
+        'jsdoc',
+    ],
     env: {
         es6: true,
     },
@@ -75,8 +78,10 @@ module.exports = {
         'plugins/**',
         '**/*.min.js',
         'public/scripts/extensions/quick-reply/lib/**',
+        'public/scripts/extensions/tts/lib/**',
     ],
     rules: {
+        'jsdoc/no-undefined-types': ['warn', { disableReporting: true, markVariablesAsUsed: true }],
         'no-unused-vars': ['error', { args: 'none' }],
         'no-control-regex': 'off',
         'no-constant-condition': ['error', { checkLoops: false }],

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,4 +1,5 @@
 name: Bug Report 🐛
+type: Bug
 description: Report something that's not working the intended way. Support requests for external programs (reverse proxies, 3rd party servers, other peoples' forks) will be refused! Please use English only.
 title: '[BUG] <title>'
 labels: ['🐛 Bug']

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,4 +1,5 @@
 name: Feature Request ✨
+type: Feature
 description: Suggest an idea for future development of this project. Please use English only.
 title: '[FEATURE_REQUEST] <title>'
 labels: ['🦄 Feature Request']
@@ -32,7 +33,7 @@ body:
     id: solution
     attributes:
       label: Describe the solution you'd like
-      placeholder: An outline of how you would like this to be implemented, include as much details as possible 
+      placeholder: An outline of how you would like this to be implemented, include as much details as possible
     validations:
       required: true
 

.github/close-label.yml

@@ -1,2 +0,0 @@
-🐛 Bug: ✅ Fixed
-🦄 Feature Request: ✅ Implemented

.github/issue-auto-comments.yml

@@ -1,62 +0,0 @@
-comment:
-  footer: |
-    ---
-    > I am a bot, and this is an automated message 🤖
-labels:
-  - name: ✖️ Invalid
-    labeled:
-      issue:
-        action: close
-        body: >
-          Hello @{{ issue.user.login }} your ticket has been marked as invalid.
-          Please ensure you follow the issue template, provide all requested info,
-          and be sure to check the docs + previous issues prior to raising tickets.
-      pr:
-        body: Thank you @{{ pull_request.user.login }} for suggesting this. Please follow the pull request templates.
-        action: close
-
-  - name: 👩‍💻 Good First Issue
-    labeled:
-      issue:
-        body: >
-          This issue has been marked as a good first issue for first-time contributors to implement!
-          This is a great way to support the project, while also improving your skills, you'll also be credited as a contributor once your PR is merged.
-          If you're new to SillyTavern [here are a collection of resources](https://docs.sillytavern.app/)
-          If you need any support at all, feel free to reach out via [Discord](https://discord.gg/sillytavern).
-
-  - name: ❌ wontfix
-    labeled:
-      issue:
-        action: close
-        body: >
-          This ticked has been marked as 'wontfix', which usually means it is out-of-scope, or not feasible at this time.
-          You can still fork the project and make the changes yourself.
-
-  - name: ✅ Fixed
-    labeled:
-      issue:
-        body: >
-          Hello @{{ issue.user.login }}! It looks like all or part of this issue has now been implemented.
-
-  
-  - name: ‼️ High Priority
-    labeled:
-      issue:
-        body: >
-          This ticket has been marked as high priority, and has been bumped to the top of the priority list.
-          You should expect an implementation to be pushed out soon. Thank you for your patience.
-
-  - name: 💀 Spam
-    labeled:
-      issue:
-        action: close
-        locking: lock
-        lock_reason: spam
-        body: >
-           This issue has been identified as spam, and is now locked.
-           Users who repeatedly raise spam issues may be blocked or reported.
-          
-  - name: ⛔ Don't Merge
-    labeled:
-      pr:
-        body: This PR has been temporarily blocked from merging.

.github/issues-auto-comments.yml

@@ -0,0 +1,69 @@
+labels:
+  - name: ✖️ Invalid
+    labeled:
+      issue:
+        action: close
+        body: >
+          Hey @{{ issue.user.login }}, this issue has been marked as invalid.
+
+          Please double-check that you've followed the issue template, included all necessary details, and reviewed the docs & previous issues before submitting.
+          If provided, follow the instructions given by maintainers.
+
+  - name: 👩‍💻 Good First Issue
+    labeled:
+      issue:
+        body: >
+          🏆 This issue has been marked as a good first issue for contributors to implement!
+          This is a great way to support the project. While also improving your skills, you'll also be credited as a contributor once your PR is merged.
+
+          If you're new to SillyTavern [here is the official documentation](https://docs.sillytavern.app/). The official contribution guide can be found [here](https://github.com/SillyTavern/SillyTavern/blob/release/CONTRIBUTING.md).
+          If you need any support, feel free to reach out via [Discord](https://discord.gg/sillytavern), or let us know in this issue or via [discussions](https://github.com/SillyTavern/SillyTavern/discussions).
+
+  - name: ❌ wontfix
+    labeled:
+      issue:
+        action: close
+        body: >
+          ❌ This issue has been marked as 'wontfix', which usually means it is out-of-scope, not feasible at this time or will not be implemented for various reasons.
+          If you have any questions about this, feel free to reach out.
+
+  - name: 🛑 Out of Scope
+    labeled:
+      issue:
+        action: close
+        body: >
+          🛑 This issue has been marked as 'out of scope', as this can't or won't be implemented.
+          If you have any questions about this, feel free to reach out.
+
+  - name: ✅ Done (staging)
+    labeled:
+      issue:
+        body: >
+          ✅ It looks like all or part of this issue has now been implemented as part of the `staging` branch.
+          If you currently are on the `release` branch, you can switch to `staging` to test this right away.
+
+          Note that `staging` is considered less stable than the official releases. To switch, follow existing instructions,
+          or simply enter the following command: `git switch staging`
+
+  - name: ✅ Done
+    labeled:
+      issue:
+        body: >
+          ✅ It looks like all or part of this issue has now been implemented as part of the latest release.
+
+  - name: ‼️ High Priority
+    labeled:
+      issue:
+        body: >
+          🚨 This issue has been marked high priority, meaning it's important to the maintainers or community.
+          While we can't promise immediate changes, it is on our radar and will be addressed whenever possible. Thanks for your patience!
+
+  - name: 💀 Spam
+    labeled:
+      issue:
+        action: close
+        locking: lock
+        lock_reason: spam
+        body: >
+          💀 This issue has been flagged as spam and is now locked.
+          Please avoid posting spam - it disrupts the community and wastes everyone's time.

.github/issues-auto-labels.yml

@@ -1,7 +1,3 @@
-# Add/remove 'critical' label if issue contains the words 'urgent' or 'critical'
-#critical:
-#    - '(critical|urgent)'
-
 🪟 Windows:
     - '(🪟 Windows)'
 
@@ -15,4 +11,10 @@
     - '(📱 Termux)'
 
 🐧 Linux:
-    - '(🐧 Linux)'
+    - '(🐧 Linux)'
+
+🦊 Firefox:
+    - '\b(firefox|mozilla)\b'
+
+📱 Mobile:
+    - '\b(iphone|ios|android|📱 Termux)\b'

.github/pr-auto-comments.yml

@@ -0,0 +1,51 @@
+labels:
+  - name: ✖️ Invalid
+    labeled:
+      pr:
+        action: close
+        body: >
+          Hey @{{ pull_request.user.login }}, thanks for your contribution!
+          Unfortunately, this PR has been marked as invalid.
+
+          Please check that you've followed the PR template, included all relevant details, and are targeting the correct branch (`staging` for regular contributions, `release` only for hotfixes).
+
+          If you need help, feel free to ask!
+
+  - name: ⛔ Don't Merge
+    labeled:
+      pr:
+        body: >
+          🚨 This PR has been temporarily blocked from merging.
+
+  - name: 💥💣 Breaking Changes
+    labeled:
+      pr:
+        body: >
+          ⚠️ Heads up! This PR introduces breaking changes.
+
+          Make sure these changes are well-documented and that users will be properly informed when this is released.
+
+  - name: ⛔ Waiting For External/Upstream
+    labeled:
+      pr:
+        body: >
+            ⛔ This PR is awaiting external or upstream changes or approval.
+            It can only be merged once those changes have been implemented and approved.
+
+            Please inform us of any progress on the upstream changes or approval.
+
+  - name: 🔬 Needs Testing
+    labeled:
+      pr:
+        body: >
+          🔬 This PR needs testing!
+          Any contributor can test and leave reviews, so feel free to help us out!
+
+  - name: 🟥 ⬤⬤⬤⬤⬤
+    labeled:
+      pr:
+        body: >
+            ⚠️ This PR is over 1000 lines, which is larger than recommended.
+
+            Please make sure that it only addresses a single issue - PRs this large are hard to test and may be rejected.
+

.github/pr-auto-labels-by-branch.yml

@@ -0,0 +1,83 @@
+####################################
+# Label PRs against 'release'      #
+####################################
+❗ Against Release Branch:
+- base-branch: 'release'
+
+####################################
+# Labels based on PR branch name   #
+####################################
+🦋 Bug Fix:
+- head-branch: ['^fix[/-]', '\bfixes\b']
+
+🚑 Hot Fix:
+- head-branch: ['^hotfix[/-]']
+
+✨ New Feature:
+- head-branch: ['^feat(ure)?[/-].*?\badd', '^add-']
+
+✨ Feature Changes:
+- head-branch: ['^feat(ure)?[/-](?!.*\badd\b)', '\bchanges?\b']
+
+🤖 API / Model:
+- head-branch: ['\bapi\b', '\bmodels?\b']
+
+🏭 Backend Changes:
+- head-branch: ['\bbackend\b', '\bendpoints?\b']
+
+🐋 Docker:
+- head-branch: ['\bdocker\b']
+
+➕ Extension:
+- head-branch: ['\bextension\b', '\bext\b']
+
+🦊 Firefox:
+- head-branch: ['\bfirefox\b']
+
+🧑‍🤝‍🧑 Group Chat:
+- head-branch: ['\bgroups?\b']
+
+🖼️ Image Gen:
+- head-branch: ['\bimage-gen\b']
+
+🌐 Language:
+- head-branch: ['\btranslations?\b', '\blanguages?\b']
+
+🐧 Linux:
+- head-branch: ['\blinux\b']
+
+🧩 Macros:
+- head-branch: ['\bmacros?\b']
+
+📱 Mobile:
+- head-branch: ['\bmobile\b', '\bios\b', '\bandroid\b']
+
+🚄 Performance:
+- head-branch: ['\bperformance\b']
+
+⚙️ Preset:
+- head-branch: ['\bpresets?\b']
+
+📜 Prompt:
+- head-branch: ['\bprompt\b']
+
+🧠 Reasoning:
+- head-branch: ['\breasoning\b', '\breason\b', '\bthinking\b']
+
+🚚 Refactor:
+- head-branch: ['\brefactor(s|ed)?\b']
+
+📜 STscript:
+- head-branch: ['\bstscript\b', '\bslash-commands\b']
+
+🏷️ Tags / Folders:
+- head-branch: ['\btags\b']
+
+🎙️ TTS / Voice:
+- head-branch: ['\btts\b', '\bvoice\b']
+
+🌟 UX:
+- head-branch: ['\bux\b']
+
+🗺️ World Info:
+- head-branch: ['\bworld-info\b', '\bwi\b']

.github/pr-auto-labels-by-files.yml

@@ -0,0 +1,46 @@
+####################################
+# Labels based on changed files    #
+####################################
+🏭 Backend Changes:
+- changed-files:
+  - any-glob-to-any-file:
+    - "src/**"
+    - "default/config.yaml"
+    - "server.js"
+    - "plugins.js"
+    - "recover.js"
+    - "webpack.config.js"
+    - "Start.bat"
+    - "start.sh"
+    - "UpdateAndStart.bat"
+    - "UpdateForkAndStart.bat"
+
+⚙️ config.yaml:
+- changed-files:
+  - any-glob-to-any-file:
+    - "default/config.yaml"
+
+🛠️ Build Changes:
+- changed-files:
+  - any-glob-to-any-file:
+    - ".github/workflows/**"
+    - "docker/**"
+    - ".dockerignore"
+    - "Dockerfile"
+    - "webpack.config.js"
+
+🌐 Language:
+- changed-files:
+  - any-glob-to-any-file:
+    - "public/locales/**"
+
+📥 Dependencies:
+- changed-files:
+  - any-glob-to-any-file:
+    - "public/lib/**" # Every frontend lib counts as a dependency as well
+    - "package.json"
+    - "package-lock.json"
+    - "tests/package.json"
+    - "tests/package-lock.json"
+    - "src/electron/package.json"
+    - "src/electron/package-lock.json"

.github/readme.md

@@ -23,7 +23,7 @@ We have a [Documentation website](https://docs.sillytavern.app/) to answer most
 
 SillyTavern (or ST for short) is a locally installed user interface that allows you to interact with text generation LLMs, image generation engines, and TTS voice models.
 
-Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 100 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists.
+Beginning in February 2023 as a fork of TavernAI 1.2.8, SillyTavern now has over 200 contributors and 2 years of independent development under its belt, and continues to serve as a leading software for savvy AI hobbyists.
 
 ## Our Vision
 
@@ -113,7 +113,9 @@ SillyTavern has extensibility support.
 
 Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern.app/).
 
-# ⌛ Installation
+## ⌛ Installation
+
+### 🪟 Windows
 
 > \[!WARNING]
 >
@@ -121,9 +123,7 @@ Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern
 > * DO NOT RUN START.BAT WITH ADMIN PERMISSIONS
 > * INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16
 
-## 🪟 Windows
-
-### Installing via Git
+#### Installing via Git (recommended)
 
 1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
 2. Install [Git for Windows](https://gitforwindows.org/)
@@ -138,7 +138,7 @@ Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern
 7. Once everything is cloned, double-click `Start.bat` to make NodeJS install its requirements.
 8. The server will then start, and SillyTavern will pop up in your browser.
 
-### Installing via GitHub Desktop
+#### Installing via GitHub Desktop
 
 (This allows git usage **only** in GitHub Desktop, if you want to use `git` on the command line too, you also need to install [Git for Windows](https://gitforwindows.org/))
 
@@ -152,7 +152,7 @@ Tutorials on how to use them can be found in the [Docs](https://docs.sillytavern
   9. After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:
   10. Connect to any of the [supported APIs](https://docs.sillytavern.app/usage/api-connections/) and start chatting!
 
-## 🐧 Linux & 🍎 MacOS
+### 🐧 Linux & 🍎 MacOS
 
 For MacOS / Linux all of these will be done in a Terminal.
 
@@ -168,6 +168,72 @@ For MacOS / Linux all of these will be done in a Terminal.
 * `./start.sh`
 * `bash start.sh`
 
+## 🐋 Installing via Docker
+
+These instructions assume you have installed Docker, are able to access your command line for the installation of containers, and familiar with their general operation.
+
+### Using the GitHub Container Registry
+
+#### Docker Compose (easiest)
+
+Grab the `docker-compose.yml` file from the [GitHub Repository](https://github.com/SillyTavern/SillyTavern/blob/release/docker/docker-compose.yml) and run the following command in the directory where the file is located. This will pull the latest release image from the GitHub Container Registry and start the container, automatically creating the necessary volumes.
+
+```shell
+docker-compose up
+```
+
+Customize the `docker-compose.yml` file to your needs. The default port is 8000. If you want to adjust the server configuration using environment variables, read the documentation [here](https://docs.sillytavern.app/administration/config-yaml/#environment-variables).
+
+#### Docker CLI (advanced)
+
+You will need two mandatory directory mappings and a port mapping to allow SillyTavern to function. In the command, replace your selections in the following places:
+
+#### Container Variables
+
+##### Volume Mappings
+
+* `CONFIG_PATH` - The directory where SillyTavern configuration files will be stored on your host machine
+* `DATA_PATH` - The directory where SillyTavern user data (including characters) will be stored on your host machine
+* `PLUGINS_PATH` - (optional) The directory where SillyTavern server plugins will be stored on your host machine
+* `EXTENSIONS_PATH` - (optional) The directory where global UI extensions will be stored on your host machine
+
+##### Port Mappings
+
+* `PUBLIC_PORT` - The port to expose the traffic on. This is mandatory, as you will be accessing the instance from outside of its virtual machine container. DO NOT expose this to the internet without implementing a separate service for security.
+
+##### Additional Settings
+
+* `SILLYTAVERN_VERSION` - On the right-hand side of this GitHub page, you'll see "Packages". Select the "sillytavern" package and you'll see the image versions. The image tag "latest" will keep you up-to-date with the current release. You can also utilize "staging" that points to the nightly image of the respective branch.
+
+#### Running the container
+
+1. Open your Command Line
+2. Run the following command in a folder where you want to store the configuration and data files:
+
+```bash
+SILLYTAVERN_VERSION="latest"
+PUBLIC_PORT="8000"
+CONFIG_PATH="./config"
+DATA_PATH="./data"
+PLUGINS_PATH="./plugins"
+EXTENSIONS_PATH="./extensions"
+
+docker run \
+  --name="sillytavern" \
+  -p "$PUBLIC_PORT:8000/tcp" \
+  -v "$CONFIG_PATH:/home/node/app/config:rw" \
+  -v "$DATA_PATH:/home/node/app/data:rw" \
+  -v "$EXTENSIONS_PATH:/home/node/app/public/scripts/extensions/third-party:rw" \
+  -v "$PLUGINS_PATH:/home/node/app/plugins:rw" \
+  ghcr.io/sillytavern/sillytavern:"$SILLYTAVERN_VERSION"
+```
+
+> By default the container will run in the foreground. If you want to run it in the background, add the `-d` flag to the `docker run` command.
+
+### Building the image yourself
+
+We have a comprehensive guide on using SillyTavern in Docker [here](http://docs.sillytavern.app/installation/docker/) which covers installations on Windows, macOS and Linux! Give it a read if you wish to build the image yourself.
+
 ## ⚡ Installing via SillyTavern Launcher
 
 SillyTavern Launcher is an installation wizard that will help you get setup with many options, including installing a backend for local inference.
@@ -239,45 +305,6 @@ chmod +x install.sh && ./install.sh
 chmod +x launcher.sh && ./launcher.sh
 ```
 
-## 🐋 Installing via Docker
-
-These instructions assume you have installed Docker, are able to access your command line for the installation of containers, and familiar with their general operation.
-
-### Building the image yourself
-
-We have a comprehensive guide on using SillyTavern in Docker [here](http://docs.sillytavern.app/installation/docker/) which covers installations on Windows, macOS and Linux! Give it a read if you wish to build the image yourself.
-
-### Using the GitHub Container Registry (easiest)
-
-You will need two mandatory directory mappings and a port mapping to allow SillyTavern to function. In the command, replace your selections in the following places:
-
-#### Container Variables
-
-##### Volume Mappings
-
-* [config] - The directory where SillyTavern configuration files will be stored on your host machine
-* [data] - The directory where SillyTavern user data (including characters) will be stored on your host machine
-* [plugins] - (optional) The directory where SillyTavern server plugins will be stored on your host machine
-* [extensions] - (optional) The directory where global UI extensions will be stored on your host machine
-
-##### Port Mappings
-
-* [PublicPort] - The port to expose the traffic on. This is mandatory, as you will be accessing the instance from outside of its virtual machine container. DO NOT expose this to the internet without implementing a separate service for security.
-
-##### Additional Settings
-
-* [DockerNet] - The docker network that the container should be created with a connection to. If you don't know what it is, see the [official Docker documentation](https://docs.docker.com/reference/cli/docker/network/).
-* [version] - On the right-hand side of this GitHub page, you'll see "Packages". Select the "sillytavern" package and you'll see the image versions. The image tag "latest" will keep you up-to-date with the current release. You can also utilize "staging" and "release" tags that point to the nightly images of the respective branches, but this may not be appropriate, if you are utilizing extensions that could be broken, and may need time to update.
-
-#### Install command
-
-1. Open your Command Line
-2. Run the following command
-
-`docker run --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' -v '[extensions]':'/home/node/app/public/scripts/extensions/third-party':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
-
-> Note that 8000 is a default listening port. Don't forget to use an appropriate port if you change it in the config.
-
 ## 📱 Installing via Termux on Android OS
 
 > \[!NOTE]
@@ -317,29 +344,35 @@ Start.bat --port 8000 --listen false
 
 ### Supported arguments
 
-| Option                  | Description                                                                                          | Type     |
-|-------------------------|------------------------------------------------------------------------------------------------------|----------|
-| `--version`             | Show version number                                                                                  | boolean  |
-| `--enableIPv6`          | Enables IPv6.                                                                                        | boolean  |
-| `--enableIPv4`          | Enables IPv4.                                                                                        | boolean  |
-| `--port`                | Sets the port under which SillyTavern will run. If not provided falls back to yaml config 'port'.    | number   |
-| `--dnsPreferIPv6`       | Prefers IPv6 for dns. If not provided falls back to yaml config 'preferIPv6'.                        | boolean  |
-| `--autorun`             | Automatically launch SillyTavern in the browser. If not provided falls back to yaml config 'autorun'.| boolean  |
-| `--autorunHostname`     | The autorun hostname, probably best left on 'auto'.                                                  | string   |
-| `--autorunPortOverride` | Overrides the port for autorun.                                                                      | string   |
-| `--listen`              | SillyTavern is listening on all network interfaces. If not provided falls back to yaml config 'listen'.| boolean  |
-| `--corsProxy`           | Enables CORS proxy. If not provided falls back to yaml config 'enableCorsProxy'.                     | boolean  |
-| `--disableCsrf`         | Disables CSRF protection                                                                             | boolean  |
-| `--ssl`                 | Enables SSL                                                                                          | boolean  |
-| `--certPath`            | Path to your certificate file.                                                                       | string   |
-| `--keyPath`             | Path to your private key file.                                                                       | string   |
-| `--whitelist`           | Enables whitelist mode                                                                               | boolean  |
-| `--dataRoot`            | Root directory for data storage                                                                      | string   |
-| `--avoidLocalhost`      | Avoids using 'localhost' for autorun in auto mode.                                                   | boolean  |
-| `--basicAuthMode`       | Enables basic authentication                                                                         | boolean  |
-| `--requestProxyEnabled` | Enables a use of proxy for outgoing requests                                                         | boolean  |
-| `--requestProxyUrl`     | Request proxy URL (HTTP or SOCKS protocols)                                                          | string   |
-| `--requestProxyBypass`  | Request proxy bypass list (space separated list of hosts)                                            | array    |
+> \[!TIP]
+> None of the arguments are required. If you don't provide them, SillyTavern will use the settings in `config.yaml`.
+
+| Option                  | Description                                                          | Type     |
+|-------------------------|----------------------------------------------------------------------|----------|
+| `--version`             | Show version number                                                  | boolean  |
+| `--configPath`          | Override the path to the config.yaml file                            | string   |
+| `--dataRoot`            | Root directory for data storage                                      | string   |
+| `--port`                | Sets the port under which SillyTavern will run                       | number   |
+| `--listen`              | SillyTavern will listen on all network interfaces                    | boolean  |
+| `--whitelist`           | Enables whitelist mode                                               | boolean  |
+| `--basicAuthMode`       | Enables basic authentication                                         | boolean  |
+| `--enableIPv4`          | Enables IPv4 protocol                                                | boolean  |
+| `--enableIPv6`          | Enables IPv6 protocol                                                | boolean  |
+| `--listenAddressIPv4`   | Specific IPv4 address to listen to                                   | string   |
+| `--listenAddressIPv6`   | Specific IPv6 address to listen to                                   | string   |
+| `--dnsPreferIPv6`       | Prefers IPv6 for DNS                                                 | boolean  |
+| `--ssl`                 | Enables SSL                                                          | boolean  |
+| `--certPath`            | Path to your certificate file                                        | string   |
+| `--keyPath`             | Path to your private key file                                        | string   |
+| `--autorun`             | Automatically launch SillyTavern in the browser                      | boolean  |
+| `--autorunHostname`     | Autorun hostname                                                     | string   |
+| `--autorunPortOverride` | Overrides the port for autorun                                       | string   |
+| `--avoidLocalhost`      | Avoids using 'localhost' for autorun in auto mode                    | boolean  |
+| `--corsProxy`           | Enables CORS proxy                                                   | boolean  |
+| `--requestProxyEnabled` | Enables a use of proxy for outgoing requests                         | boolean  |
+| `--requestProxyUrl`     | Request proxy URL (HTTP or SOCKS protocols)                          | string   |
+| `--requestProxyBypass`  | Request proxy bypass list (space separated list of hosts)            | array    |
+| `--disableCsrf`         | Disables CSRF protection (NOT RECOMMENDED)                           | boolean  |
 
 ## Remote connections
 
@@ -351,10 +384,29 @@ You may also want to configure SillyTavern user profiles with (optional) passwor
 
 ## Performance issues?
 
+### General tips
+
 1. Disable the Blur Effect and enable Reduced Motion on the User Settings panel (UI Theme toggles category).
 2. If using response streaming, set the streaming FPS to a lower value (10-15 FPS is recommended).
 3. Make sure the browser is enabled to use GPU acceleration for rendering.
 
+### Input lag
+
+Performance degradation, particularly input lag, is most commonly attributed to browser extensions. Known problematic extensions include:
+
+* iCloud Password Manager
+* DeepL Translation
+* AI-based grammar correction tools
+* Various ad-blocking extensions
+
+If you experience performance issues and cannot identify the cause, or suspect an issue with SillyTavern itself, please:
+
+1. [Record a performance profile](https://developer.chrome.com/docs/devtools/performance/reference)
+2. Export the profile as a JSON file
+3. Submit it to the development team for analysis
+
+We recommend first testing with all browser extensions and third-party SillyTavern extensions disabled to isolate the source of the performance degradation.
+
 ## License and credits
 
 **This program is distributed in the hope that it will be useful,
@@ -369,6 +421,7 @@ GNU Affero General Public License for more details.**
 * Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
 * Default content by @OtisAlejandro (Seraphina character and lorebook) and @kallmeflocc (10K Discord Users Celebratory Background)
 * Docker guide by [@mrguymiah](https://github.com/mrguymiah) and [@Bronya-Rand](https://github.com/Bronya-Rand)
+* kokoro-js library by [@hexgrad](https://github.com/hexgrad) (Apache-2.0 License)
 
 ## Top Contributors
 

.github/workflows/add-comment-from-tag.yml

@@ -1,28 +0,0 @@
-# Based on a label applied to an issue, the bot will add a comment with some additional info
-
-name: 🎯 Auto-Reply to Labeled Tickets
-on:
-  issues:
-    types:
-      - labeled
-      - unlabeled
-  pull_request_target:
-    types:
-      - labeled
-      - unlabeled
-permissions:
-  contents: read
-  issues: write
-  pull-requests: write
-
-jobs:
-  comment:
-    runs-on: ubuntu-20.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2     
-      - name: Label Commenter
-        uses: peaceiris/actions-label-commenter@v1
-        with:
-          config_file: .github/issue-auto-comments.yml
-          github_token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}

.github/workflows/check-merge-conflicts.yml

@@ -1,17 +0,0 @@
-# Detect and label pull requests that have merge conflicts
-name: 🏗️ Check Merge Conflicts
-on:
-  push:
-    branches:
-    - staging
-jobs:
-  check-conflicts:
-    if: github.repository == 'SillyTavern/SillyTavern'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: mschilde/auto-label-merge-conflicts@master
-        with:
-          CONFLICT_LABEL_NAME: "🚫 Merge Conflicts"
-          GITHUB_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-          MAX_RETRIES: 5
-          WAIT_MS: 5000

.github/workflows/close-stale-issues.yml

@@ -1,82 +0,0 @@
-# Closes any issues that no longer have user interaction
-name: 🎯 Close Stale Issues
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: '0 0 * * *' # Runs every day at midnight UTC
-
-jobs:
-  stale:
-    runs-on: ubuntu-latest
-
-    steps:
-      # Comment on, then close issues that haven't been updated for ages 
-      - name: Close Stale Issues
-        uses: actions/stale@v4
-        with:
-          repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-          days-before-stale: 183
-          days-before-close: 7
-          operations-per-run: 30
-          remove-stale-when-updated: true
-          enable-statistics: true
-          stale-issue-message: > 
-            This issue has gone 6 months without an update. To keep the ticket open, please indicate that it is still relevant in a comment below.
-            Otherwise it will be closed in 7 days.
-          stale-pr-message: >
-            This PR is stale because it has been open 6 months with no activity. Either remove the stale label or comment below with a short update,
-            otherwise this PR will be closed in 7 days.
-          close-issue-message: >
-            This issue was automatically closed because it has been stalled for over 6 months with no activity.
-          close-pr-message: >
-            This pull request was automatically closed because it has been stalled for over 6 months with no activity.
-          stale-issue-label: '⚰️ Stale'
-          close-issue-label: '🕸️ Inactive'
-          stale-pr-label: '⚰️ Stale'
-          close-pr-label: '🕸️ Inactive'
-          exempt-issue-labels: '📌 Keep Open'
-          exempt-pr-labels: '📌 Keep Open'
-          labels-to-add-when-unstale: '📌 Keep Open'
-          
-        # Comment on, then close issues that required a response from the user, but didn't get one
-      - name: Close Issues without Response
-        uses: actions/stale@v4
-        with:
-          repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-          days-before-stale: 7
-          days-before-close: 7
-          operations-per-run: 30
-          remove-stale-when-updated: true
-          stale-issue-message: >
-            Hi! Looks like additional info is required for this issue to be addressed.
-            Don't forget to provide this within the next few days to keep your ticket open.
-          close-issue-message: 'Issue closed due to no response from user.'
-          only-labels: '🚏 Awaiting User Response'
-          labels-to-remove-when-unstale: '🚏 Awaiting User Response, 🛑 No Response'
-          stale-issue-label: '🛑 No Response'
-          close-issue-label: '🕸️ Inactive'
-          exempt-issue-labels: '📌 Keep Open'
-          exempt-pr-labels: '📌 Keep Open'
-          
-        # Comment on issues that we should have replied to
-      - name: Notify Repo Owner to Respond
-        uses: actions/stale@v4
-        with:
-          repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-          days-before-stale: 7
-          days-before-close: 183
-          operations-per-run: 30
-          remove-stale-when-updated: true
-          stale-issue-message: Hey SillyTavern, - Don't forget to respond!
-          stale-pr-message: Hey SillyTavern, - Don't forget to respond!
-          only-labels: '👤 Awaiting Maintainer Response'
-          labels-to-remove-when-unstale: '👤 Awaiting Maintainer Response'
-          close-issue-message: 'Closed due to no response from repo author for over a year'
-          close-pr-message: 'Closed due to no response from repo author for over a year'
-          stale-issue-label: '👤 Awaiting Maintainer Response'
-          stale-pr-label: '👤 Awaiting Maintainer Response'
-          close-issue-label: '🕸️ Inactive'
-          close-pr-label: '🕸️ Inactive'
-          exempt-issue-labels: '📌 Keep Open'
-          exempt-pr-labels: '📌 Keep Open'

.github/workflows/get-pr-size.yml

@@ -1,39 +0,0 @@
-# Adds a comment to new PRs, showing the compressed size and size difference of new code
-# And also labels the PR based on the number of lines changes
-
-name: 🌈 Check PR Size
-on: [pull_request]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    # Find and comment with compressed size
-    - name: Get Compressed Size
-      uses: preactjs/compressed-size-action@v2
-      with:
-        repo-token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-        pattern: './dist/**/*.{js,css,html}'
-        strip-hash: '\\b\\w{8}\\.'
-        exclude: '**/node_modules/**'
-        minimum-change-threshold: 100
-    # Check number of lines of code added
-    - name: Label based on Lines of Code
-      uses: codelytv/pr-size-labeler@v1
-      with:
-        GITHUB_TOKEN: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-        xs_max_size: '10'
-        s_max_size: '100'
-        m_max_size: '500'
-        l_max_size: '1000'
-        s_label: '🟩 PR - Small'
-        m_label: '🟨 PR - Medium'
-        l_label: '🟧 PR - Large'
-        xl_label: '🟥 PR - XL'
-        fail_if_xl: 'false'
-        message_if_xl: >
-          It looks like this PR is very large (over 1000 lines).
-          Try to avoid addressing multiple issues in a single PR, and
-          in the future consider breaking large tasks down into smaller steps.
-          This it to make reviewing, testing, reverting and general quality management easier.

.github/workflows/issues-auto-manager.yml

@@ -0,0 +1,116 @@
+name: 🛠️ Issues Manager
+
+on:
+  issues:
+    types: [opened, edited, labeled, unlabeled]
+  # Re also listen to comments, to remove stale labels right away
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  label-on-content:
+    name: 🏷️ Label Issues by Content
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Auto-Label Issues (Based on Issue Content)
+        # only auto label based on issue content once, on open (to prevent re-labeling removed labels)
+        if: github.event.action == 'opened'
+
+        # Issue Labeler
+        # https://github.com/marketplace/actions/regex-issue-labeler
+        uses: github/issue-labeler@v3.4
+        with:
+          configuration-path: .github/issues-auto-labels.yml
+          enable-versioned-regex: 0
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+  label-on-labels:
+    name: 🏷️ Label Issues by Labels
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ✅ Add "👍 Approved" for relevant labels
+        if: contains(fromJSON('["👩‍💻 Good First Issue", "🙏 Help Wanted", "🪲 Confirmed", "⚠️ High Priority", "❕ Medium Priority", "💤 Low Priority"]'), github.event.label.name)
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'add-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          labels: '👍 Approved'
+
+      - name: ❌ Remove progress labels when issue is marked done or stale
+        if: contains(fromJSON('["✅ Done", "✅ Done (staging)", "⚰️ Stale", "❌ wontfix"]'), github.event.label.name)
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'remove-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          labels: '🧑‍💻 In Progress,🤔 Unsure,🤔 Under Consideration'
+
+      - name: ❌ Remove temporary labels when confirmed labels are added
+        if: contains(fromJSON('["❌ wontfix","👍 Approved","👩‍💻 Good First Issue"]'), github.event.label.name)
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'remove-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          labels: '🤔 Unsure,🤔 Under Consideration'
+
+      - name: ❌ Remove no bug labels when "🪲 Confirmed" is added
+        if: github.event.label.name == '🪲 Confirmed'
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'remove-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          labels: '✖️ Not Reproducible,✖️ Not A Bug'
+
+  remove-stale-label:
+    name: 🗑️ Remove Stale Label on Comment
+    runs-on: ubuntu-latest
+    # Only run this on new comments, to automatically remove the stale label
+    if: github.event_name == 'issue_comment' && github.actor != 'github-actions[bot]'
+
+    steps:
+      - name: Remove Stale Label
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'remove-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number }}
+          labels: '⚰️ Stale,🕸️ Inactive,🚏 Awaiting User Response,🛑 No Response'
+
+  write-auto-comments:
+    name: 💬 Post Issue Comments Based on Labels
+    needs: [label-on-content, label-on-labels]
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Post Issue Comments Based on Labels
+        # Label Commenter
+        # https://github.com/marketplace/actions/label-commenter
+        uses: peaceiris/actions-label-commenter@v1.10.0
+        with:
+          config_file: .github/issues-auto-comments.yml
+          github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/issues-updates-on-merge.yml

@@ -0,0 +1,45 @@
+name: 🔄 Update Issues on Push
+
+on:
+  push:
+    branches:
+      - staging
+      - release
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  # This runs commits to staging/release, reading the commit messages. Check `pr-auto-manager.yml`:`update-linked-issues` for PR-linked updates.
+  update-linked-issues:
+    name: 🔗 Mark Linked Issues Done on Push
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Extract Linked Issues from Commit Message
+        id: extract_issues
+        run: |
+          ISSUES=$(git log ${{ github.event.before }}..${{ github.event.after }} --pretty=%B | grep -oiE '(close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved) #([0-9]+)' | awk '{print $2}' | tr -d '#' | jq -R -s -c 'split("\n")[:-1]')
+          echo "issues=$ISSUES" >> $GITHUB_ENV
+
+      - name: Label Linked Issues
+        id: label_linked_issues
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+            for ISSUE in $(echo $issues | jq -r '.[]'); do
+            if [ "${{ github.ref }}" == "refs/heads/staging" ]; then
+              LABEL="✅ Done (staging)"
+              gh issue edit $ISSUE -R ${{ github.repository }} --add-label "$LABEL" --remove-label "🧑‍💻 In Progress"
+            elif [ "${{ github.ref }}" == "refs/heads/release" ]; then
+              LABEL="✅ Done"
+              gh issue edit $ISSUE -R ${{ github.repository }} --add-label "$LABEL" --remove-label "🧑‍💻 In Progress"
+            fi
+            echo "Added label '$LABEL' (and removed '🧑‍💻 In Progress' if present) in issue #$ISSUE"
+            done

.github/workflows/job-close-stale.yml

@@ -0,0 +1,100 @@
+name: 🕒 Close Stale Issues/PRs Workflow
+
+on:
+  # Run the workflow every day
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * *' # Runs every day at midnight UTC
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  mark-inactivity:
+    name: ⏳ Mark Issues/PRs without Activity
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Mark Issues/PRs without Activity
+        # Close Stale Issues and PRs
+        # https://github.com/marketplace/actions/close-stale-issues
+        uses: actions/stale@v9.1.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          days-before-stale: 183
+          days-before-close: 7
+          operations-per-run: 30
+          remove-stale-when-updated: true
+          enable-statistics: true
+          stale-issue-message: >
+            ⏳ This issue has been inactive for 6 months. If it's still relevant, drop a comment below to keep it open.
+            Otherwise, it will be auto-closed in 7 days.
+          stale-pr-message: >
+            ⏳ This PR has been inactive for 6 months. If it's still relevant, update it or remove the stale label.
+            Otherwise, it will be auto-closed in 7 days.
+          close-issue-message: >
+            🔒 This issue was auto-closed due to inactivity for over 6 months.
+          close-pr-message: >
+            🔒 This PR was auto-closed due to inactivity for over 6 months.
+          stale-issue-label: '⚰️ Stale'
+          close-issue-label: '🕸️ Inactive'
+          stale-pr-label: '⚰️ Stale'
+          close-pr-label: '🕸️ Inactive'
+          exempt-issue-labels: '📌 Keep Open'
+          exempt-pr-labels: '📌 Keep Open'
+
+  await-user-response:
+    name: ⚠️ Mark Issues/PRs Awaiting User Response
+    runs-on: ubuntu-latest
+    needs: mark-inactivity
+
+    steps:
+      - name: Mark Issues/PRs Awaiting User Response
+        # Close Stale Issues and PRs
+        # https://github.com/marketplace/actions/close-stale-issues
+        uses: actions/stale@v9.1.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          days-before-stale: 7
+          days-before-close: 7
+          operations-per-run: 30
+          remove-stale-when-updated: true
+          stale-issue-message: >
+            ⚠️ Hey! We need some more info to move forward with this issue.
+            Please provide the requested details in the next few days to keep this ticket open.
+          close-issue-message: >
+            🔒 This issue was auto-closed due to no response from user.
+          only-labels: '🚏 Awaiting User Response'
+          labels-to-remove-when-unstale: '🚏 Awaiting User Response'
+          stale-issue-label: '🛑 No Response'
+          close-issue-label: '🕸️ Inactive'
+          exempt-issue-labels: '🚧 Alternative Exists'
+
+  alternative-exists:
+    name: 🔄 Mark Issues with Alternative Exists
+    runs-on: ubuntu-latest
+    needs: await-user-response
+
+    steps:
+      - name: Mark Issues with Alternative Exists
+        # Close Stale Issues and PRs
+        # https://github.com/marketplace/actions/close-stale-issues
+        uses: actions/stale@v9.1.0
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          days-before-stale: 7
+          days-before-close: 7
+          operations-per-run: 30
+          remove-stale-when-updated: true
+          stale-issue-message: >
+            🔄 An alternative solution has been provided for this issue.
+            Did this solve your problem? If so, we'll go ahead and close it.
+            If you still need help, drop a comment within the next 7 days to keep this open.
+          close-issue-message: >
+            ✅ Closing this issue due to no confirmation on the alternative solution.
+          only-labels: '🚧 Alternative Exists'
+          stale-issue-label: '🚏 Awaiting User Response'
+          close-issue-label: '🕸️ Inactive'
+          exempt-issue-labels: '📌 Keep Open'

.github/workflows/labeler.yml

@@ -1,19 +0,0 @@
-name: "Issue Labeler"
-on:
-  issues:
-    types: [opened, edited]
-
-permissions:
-  issues: write
-  contents: read
-
-jobs:
-  triage:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: github/issue-labeler@v3.4
-      with:
-        configuration-path: .github/labeler.yml
-#        not-before: 2020-01-15T02:54:32Z # optional and will result in any issues prior to this timestamp to be ignored.
-        enable-versioned-regex: 0
-        repo-token: ${{ github.token }}

.github/workflows/manage-pending-labels-closed.yml

@@ -1,17 +0,0 @@
-# When a new comment is added to an issue, if it had the Stale or Awaiting User Response labels, then those labels will be removed
-
-name: 🎯 Remove Pending Labels on Close
-on:
-  issues:
-    types: [closed]
-jobs:
-  remove-labels:
-   runs-on: ubuntu-latest
-   steps:
-   - name: Remove Labels when Closed
-     uses: actions-cool/issues-helper@v2
-     with:
-      actions: remove-labels
-      token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-      issue-number: ${{ github.event.issue.number }}
-      labels: '🚏 Awaiting User Response,⚰️ Stale,👤 Awaiting Maintainer Response'

.github/workflows/manage-pending-labels.yml

@@ -1,42 +0,0 @@
-# When a new comment is added to an issue, if it had the Stale or Awaiting User Response labels, then those labels will be removed
-
-name: 🎯 Add/ Remove Awaiting Response Labels
-on:
-  issue_comment:
-    types: [created]
-jobs:
-  remove-stale:
-   runs-on: ubuntu-latest
-   if: ${{ github.event.comment.author_association != 'COLLABORATOR' && github.event.comment.author_association != 'OWNER' }}
-   steps:
-   - name: Remove Stale labels when Updated
-     uses: actions-cool/issues-helper@v2
-     with:
-      actions: remove-labels
-      token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-      issue-number: ${{ github.event.issue.number }}
-      labels: '🚏 Awaiting User Response,⚰️ Stale'
-
-  add-awaiting-author:
-   runs-on: ubuntu-latest
-   if: ${{!github.event.issue.pull_request && github.event.comment.author_association != 'COLLABORATOR' && github.event.comment.author_association != 'OWNER' && github.event.issue.state == 'open' }}
-   steps:
-   - name: Add Awaiting Author labels when Updated
-     uses: actions-cool/issues-helper@v2
-     with:
-      actions: add-labels
-      token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-      issue-number: ${{ github.event.issue.number }}
-      labels: '👤 Awaiting Maintainer Response'
-
-  remove-awaiting-author:
-   runs-on: ubuntu-latest
-   if: ${{ github.event.comment.author_association == 'OWNER' }}
-   steps:
-   - name: Remove Awaiting Author labels when Updated
-     uses: actions-cool/issues-helper@v2
-     with:
-      actions: remove-labels
-      token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
-      issue-number: ${{ github.event.issue.number }}
-      labels: '👤 Awaiting Maintainer Response'

.github/workflows/on-close-handler.yml

@@ -0,0 +1,28 @@
+name: 🚪 Issues/PRs On Close Handler
+
+on:
+  issues:
+    types: [closed]
+  pull_request_target:
+    types: [closed]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  remove-labels:
+    name: 🗑️ Remove Pending Labels on Close
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Remove Pending Labels on Close
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: remove-labels
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number || github.event.pull_request.number }}
+          labels: '🚏 Awaiting User Response,🧑‍💻 In Progress,📌 Keep Open,🚫 Merge Conflicts,🔬 Needs Testing,🔨 Needs Work,⚰️ Stale,⛔ Waiting For External/Upstream'

.github/workflows/on-open-handler.yml

@@ -0,0 +1,29 @@
+name: 📨 Issues/PRs Open Handler
+
+on:
+  issues:
+    types: [opened]
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  label-maintainer:
+    name: 🏷️ Label if Author is a Repo Maintainer
+    runs-on: ubuntu-latest
+    if: contains(fromJson('["Cohee1207", "RossAscends", "Wolfsblvt"]'), github.actor)
+
+    steps:
+      - name: Label if Author is a Repo Maintainer
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'add-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.issue.number || github.event.pull_request.number }}
+          labels: '👷 Maintainer'

.github/workflows/pr-auto-manager.yml

@@ -0,0 +1,270 @@
+name: 🔀 Pull Request Manager
+
+on:
+  workflow_dispatch: # Allow to manually call this workflow
+  pull_request_target:
+    types: [opened, synchronize, reopened, edited, labeled, unlabeled, closed]
+  pull_request_review_comment:
+    types: [created]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  run-eslint:
+    name: ✅ Check ESLint on PR
+    runs-on: ubuntu-latest
+    # Only needs to run when code is changed
+    if: github.event.action == 'opened' || github.event.action == 'synchronize'
+
+    # Override permissions, linter likely needs write access to issues
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+        with:
+            ref: ${{ github.event.pull_request.head.sha }}
+            repository: ${{ github.event.pull_request.head.repo.full_name }}
+
+      - name: Setup Node.js
+        # Setup Node.js environment
+        # https://github.com/marketplace/actions/setup-node-js-environment
+        uses: actions/setup-node@v4.3.0
+        with:
+          node-version: 20
+
+      - name: Run npm install
+        run: npm ci
+
+      - name: Run ESLint
+        # Action ESLint
+        # https://github.com/marketplace/actions/action-eslint
+        uses: sibiraj-s/action-eslint@v3.0.1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          eslint-args: '--ignore-path=.gitignore --quiet'
+          extensions: 'js'
+          annotations: true
+          ignore-patterns: |
+            dist/
+            lib/
+
+  label-by-size:
+    name: 🏷️ Label PR by Size
+    # This job should run after all others, to prevent possible concurrency issues
+    needs: [label-by-branches, label-by-files, remove-stale-label, check-merge-blocking-labels, write-auto-comments]
+    runs-on: ubuntu-latest
+    # Only needs to run when code is changed
+    if: always() && (github.event.action == 'opened' || github.event.action == 'synchronize')
+
+    # Override permissions, the labeler needs issues write access
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+
+    steps:
+      - name: Label PR Size
+        # Pull Request Size Labeler
+        # https://github.com/marketplace/actions/pull-request-size-labeler
+        uses: codelytv/pr-size-labeler@v1.10.2
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          xs_label: '🟩 ⬤○○○○'
+          xs_max_size: '20'
+          s_label: '🟩 ⬤⬤○○○'
+          s_max_size: '100'
+          m_label: '🟨 ⬤⬤⬤○○'
+          m_max_size: '500'
+          l_label: '🟧 ⬤⬤⬤⬤○'
+          l_max_size: '1000'
+          xl_label: '🟥 ⬤⬤⬤⬤⬤'
+          fail_if_xl: 'false'
+          files_to_ignore: |
+            "package-lock.json"
+            "public/lib/*"
+
+  label-by-branches:
+    name: 🏷️ Label PR by Branches
+    runs-on: ubuntu-latest
+    # Only label once when PR is created or when base branch is changed, to allow manual label removal
+    if: github.event.action == 'opened' || (github.event.action == 'synchronize' && github.event.changes.base)
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Apply Labels Based on Branch Name and Target Branch
+        # Pull Request Labeler
+        # https://github.com/marketplace/actions/labeler
+        uses: actions/labeler@v5.0.0
+        with:
+          configuration-path: .github/pr-auto-labels-by-branch.yml
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+  label-by-files:
+    name: 🏷️ Label PR by Files
+    runs-on: ubuntu-latest
+    # Only needs to run when code is changed
+    if: github.event.action == 'opened' || github.event.action == 'synchronize'
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Apply Labels Based on Changed Files
+        # Pull Request Labeler
+        # https://github.com/marketplace/actions/labeler
+        uses: actions/labeler@v5.0.0
+        with:
+          configuration-path: .github/pr-auto-labels-by-files.yml
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+  remove-stale-label:
+    name: 🗑️ Remove Stale Label on Comment
+    runs-on: ubuntu-latest
+    # Only runs on comments not done by the github actions bot
+    if: github.event_name == 'pull_request_review_comment' && github.actor != 'github-actions[bot]'
+
+    # Override permissions, issue labeler needs issues write access
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+
+    steps:
+      - name: Remove Stale Label
+        # 🤖 Issues Helper
+        # https://github.com/marketplace/actions/issues-helper
+        uses: actions-cool/issues-helper@v3.6.0
+        with:
+          actions: 'remove-labels'
+          token: ${{ secrets.GITHUB_TOKEN }}
+          issue-number: ${{ github.event.pull_request.number }}
+          labels: '⚰️ Stale'
+
+  check-merge-blocking-labels:
+    name: 🚫 Check Merge Blocking Labels
+    needs: [label-by-branches, label-by-files]
+    runs-on: ubuntu-latest
+    # Run, even if the previous jobs were skipped/failed
+    if: always()
+
+    # Override permissions, as this needs to write a check
+    permissions:
+      checks: write
+      contents: read
+      pull-requests: read
+
+    steps:
+      - name: Check Merge Blocking
+        # GitHub Script
+        # https://github.com/marketplace/actions/github-script
+        id: label-check
+        uses: actions/github-script@v7.0.1
+        with:
+          script: |
+            const prLabels = context.payload.pull_request.labels.map(label => label.name);
+            const blockingLabels = [
+              "⛔ Don't Merge",
+              "🔨 Needs Work",
+              "🔬 Needs Testing",
+              "⛔ Waiting For External/Upstream",
+              "❗ Against Release Branch",
+              "💥💣 Breaking Changes"
+            ];
+            const hasBlockingLabel = prLabels.some(label => blockingLabels.includes(label));
+
+            if (hasBlockingLabel) {
+              console.log("Blocking label detected. Setting warning status.");
+              await github.rest.checks.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                name: "PR Label Warning",
+                head_sha: context.payload.pull_request.head.sha,
+                status: "completed",
+                conclusion: "neutral",
+                output: {
+                  title: "Potential Merge Issue",
+                  summary: "This PR has a merge-blocking label. Proceed with caution."
+                }
+              });
+            } else {
+              console.log("No merge-blocking labels found.");
+            }
+
+  write-auto-comments:
+    name: 💬 Post PR Comments Based on Labels
+    needs: [label-by-branches, label-by-files]
+    runs-on: ubuntu-latest
+    # Run, even if the previous jobs were skipped/failed
+    if: always()
+
+    steps:
+      - name: Checkout Repository
+        # Checkout
+        # https://github.com/marketplace/actions/checkout
+        uses: actions/checkout@v4.2.2
+
+      - name: Post PR Comments Based on Labels
+        # Label Commenter for PRs
+        # https://github.com/marketplace/actions/label-commenter
+        uses: peaceiris/actions-label-commenter@v1.10.0
+        with:
+          config_file: .github/pr-auto-comments.yml
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+  # This runs on merged PRs to staging, reading the PR body and directly linked issues. Check `issues-updates-on-merge.yml`:`update-linked-issues` for commit-based updates.
+  update-linked-issues:
+    name: 🔗 Mark Linked Issues Done on Staging Merge
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'staging'
+
+    # Override permissions, We need to be able to write to issues
+    permissions:
+      contents: read
+      issues: write
+      pull-requests: write
+
+    steps:
+      - name: Extract Linked Issues From PR Description
+        id: extract_issues
+        run: |
+            ISSUES=$(jq -r '.pull_request.body' "$GITHUB_EVENT_PATH" | grep -oiE '(close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved) #([0-9]+)' | awk '{print $2}' | tr -d '#' | jq -R -s -c 'split("\n")[:-1]')
+            echo "issues=$ISSUES" >> $GITHUB_ENV
+
+      - name: Fetch Directly Linked Issues
+        id: fetch_linked_issues
+        run: |
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          REPO=${{ github.repository }}
+          API_URL="https://api.github.com/repos/$REPO/pulls/$PR_NUMBER/issues"
+          ISSUES=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" "$API_URL" | jq -r '.[].number' | jq -R -s -c 'split("\n")[:-1]')
+          echo "linked_issues=$ISSUES" >> $GITHUB_ENV
+
+      - name: Merge Issue Lists
+        id: merge_issues
+        run: |
+          ISSUES=$(jq -c -n --argjson a "$issues" --argjson b "$linked_issues" '$a + $b | unique')
+          echo "final_issues=$ISSUES" >> $GITHUB_ENV
+
+      - name: Label Linked Issues
+        id: label_linked_issues
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          for ISSUE in $(echo $final_issues | jq -r '.[]'); do
+            gh issue edit $ISSUE -R ${{ github.repository }} --add-label "✅ Done (staging)" --remove-label "🧑‍💻 In Progress"
+            echo "Added label '✅ Done (staging)' (and removed '🧑‍💻 In Progress' if present) in issue #$ISSUE"
+          done

.github/workflows/pr-check-merge-conflicts.yaml

@@ -0,0 +1,28 @@
+name: ⚔️ Check Merge Conflicts
+
+on:
+  # So that PRs touching the same files as the push are updated
+  push:
+  # So that the `dirtyLabel` is removed if conflicts are resolved
+  pull_request_target:
+    types: [synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  check-merge-conflicts:
+    name: ⚔️ Check Merge Conflicts
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check Merge Conflicts
+        # Label Conflicting Pull Requests
+        # https://github.com/marketplace/actions/label-conflicting-pull-requests
+        uses: eps1lon/actions-label-merge-conflict@v3.0.3
+        with:
+          dirtyLabel: '🚫 Merge Conflicts'
+          repoToken: ${{ secrets.GITHUB_TOKEN }}
+          commentOnDirty: >
+            ⚠️ This PR has conflicts that need to be resolved before it can be merged.

.npmignore

@@ -12,3 +12,4 @@ access.log
 .vscode
 .git
 /public/scripts/extensions/third-party
+/colab

Dockerfile

@@ -4,7 +4,7 @@ FROM node:lts-alpine3.19
 ARG APP_HOME=/home/node/app
 
 # Install system dependencies
-RUN apk add gcompat tini git
+RUN apk add --no-cache gcompat tini git
 
 # Create app directory
 WORKDIR ${APP_HOME}
@@ -12,15 +12,13 @@ WORKDIR ${APP_HOME}
 # Set NODE_ENV to production
 ENV NODE_ENV=production
 
-# Install app dependencies
-COPY package*.json post-install.js ./
+# Bundle app source
+COPY . ./
+
 RUN \
   echo "*** Install npm packages ***" && \
   npm i --no-audit --no-fund --loglevel=error --no-progress --omit=dev && npm cache clean --force
 
-# Bundle app source
-COPY . ./
-
 # Copy default chats, characters and user avatars to <folder>.default folder
 RUN \
   rm -f "config.yaml" || true && \

default/!DO-NOT-EDIT-THESE-FILES.txt

@@ -0,0 +1,13 @@
+These are master copies of the default content files and are managed by SillyTavern.
+
+Editing any of these files would not only have no effect, but will also cause merge conflicts during update pulls.
+
+You should edit their respective copies instead, for example:
+
+1. /default/config.yaml => /config.yaml
+2. /default/public/css/user.css => /public/css/user.css
+etc.
+
+Any questions? You're always welcome at our official documentation website:
+
+https://docs.sillytavern.app/

default/config.yaml

@@ -1,8 +1,6 @@
 # -- DATA CONFIGURATION --
 # Root directory for user data storage
 dataRoot: ./data
-# The maximum amount of memory that parsed character cards can use in MB
-cardsCacheCapacity: 100
 # -- SERVER CONFIGURATION --
 # Listen for incoming connections
 listen: false
@@ -28,6 +26,11 @@ port: 8000
 # - Use -1 to use the server port.
 # - Specify a port to override the default.
 autorunPortOverride: -1
+# -- SSL options --
+ssl:
+  enabled: false
+  certPath: "./certs/cert.pem"
+  keyPath: "./certs/privkey.pem"
 # -- SECURITY CONFIGURATION --
 # Toggle whitelist mode
 whitelistMode: true
@@ -37,6 +40,8 @@ enableForwardedWhitelist: true
 whitelist:
   - ::1
   - 127.0.0.1
+# Automatically whitelist Docker host and gateway IPs
+whitelistDockerHosts: true
 # Toggle basic authentication for endpoints
 basicAuthMode: false
 # Basic authentication credentials
@@ -71,20 +76,28 @@ autheliaAuth: false
 # the username and passwords for basic auth are the same as those
 # for the individual accounts
 perUserBasicAuth: false
-# Minimum log level to display in the terminal (DEBUG = 0, INFO = 1, WARN = 2, ERROR = 3)
-minLogLevel: 0
 
 # User session timeout *in seconds* (defaults to 24 hours).
 ## Set to a positive number to expire session after a certain time of inactivity
 ## Set to 0 to expire session when the browser is closed
 ## Set to a negative number to disable session expiration
 sessionTimeout: -1
-# Used to sign session cookies. Will be auto-generated if not set
-cookieSecret: ''
 # Disable CSRF protection - NOT RECOMMENDED
 disableCsrfProtection: false
 # Disable startup security checks - NOT RECOMMENDED
 securityOverride: false
+# -- LOGGING CONFIGURATION --
+logging:
+  # Enable access logging to access.log file
+  # Records new connections with timestamp, IP address and user agent
+  enableAccessLog: true
+  # Minimum log level to display in the terminal (DEBUG = 0, INFO = 1, WARN = 2, ERROR = 3)
+  minLogLevel: 0
+# -- RATE LIMITING CONFIGURATION --
+rateLimiting:
+  # Use X-Real-IP header instead of socket IP for rate limiting
+  # Only enable this if you are using a properly configured reverse proxy (like Nginx/traefik/Caddy)
+  preferRealIpHeader: false
 # -- ADVANCED CONFIGURATION --
 # Open the browser automatically
 autorun: true
@@ -101,6 +114,8 @@ backups:
   chat:
     # Enable automatic chat backups
     enabled: true
+    # Verify integrity of chat files before saving
+    checkIntegrity: true
     # Maximum number of chat backups to keep per user (starting from the most recent). Set to -1 to keep all backups.
     maxTotalBackups: -1
     # Interval in milliseconds to throttle chat backups per user
@@ -120,6 +135,16 @@ thumbnails:
   # Maximum thumbnail dimensions per type [width, height]
   dimensions: { 'bg': [160, 90], 'avatar': [96, 144] }
 
+# PERFORMANCE-RELATED CONFIGURATION
+performance:
+  # Enables lazy loading of character cards. Improves performances with large card libraries.
+  # May have compatibility issues with some extensions.
+  lazyLoadCharacters: false
+  # The maximum amount of memory that parsed character cards can use. Set to 0 to disable memory caching.
+  memoryCacheCapacity: '100mb'
+  # Enables disk caching for character cards. Improves performances with large card libraries.
+  useDiskCache: true
+
 # Allow secret keys exposure via API
 allowKeysExposure: false
 # Skip new default content checks
@@ -130,6 +155,7 @@ whitelistImportDomains:
   - cdn.discordapp.com
   - files.catbox.moe
   - raw.githubusercontent.com
+  - char-archive.evulid.cc
 # API request overrides (for KoboldAI and Text Completion APIs)
 ## Note: host includes the port number if it's not the default (80 or 443)
 ## Format is an array of objects:
@@ -208,6 +234,10 @@ claude:
   # should be ideal for most use cases.
   # Any value other than a non-negative integer will be ignored and caching at depth will not be enabled.
   cachingAtDepth: -1
+# -- GOOGLE GEMINI API CONFIGURATION --
+gemini:
+  # API endpoint version ("v1beta" or "v1alpha")
+  apiVersion: 'v1beta'
 # -- SERVER PLUGIN CONFIGURATION --
 enableServerPlugins: false
 # Attempt to automatically update server plugins on startup

default/content/index.json

@@ -540,7 +540,7 @@
         "type": "context"
     },
     {
-        "filename": "presets/context/Pygmalion.json",
+        "filename": "presets/context/Metharme.json",
         "type": "context"
     },
     {
@@ -563,6 +563,10 @@
         "filename": "presets/context/Llama 3 Instruct.json",
         "type": "context"
     },
+    {
+        "filename": "presets/context/Llama 4 Instruct.json",
+        "type": "context"
+    },
     {
         "filename": "presets/context/Phi.json",
         "type": "context"
@@ -615,10 +619,6 @@
         "filename": "presets/instruct/OpenOrca-OpenChat.json",
         "type": "instruct"
     },
-    {
-        "filename": "presets/instruct/Pygmalion.json",
-        "type": "instruct"
-    },
     {
         "filename": "presets/instruct/Story.json",
         "type": "instruct"
@@ -663,6 +663,10 @@
         "filename": "presets/instruct/Llama 3 Instruct.json",
         "type": "instruct"
     },
+    {
+        "filename": "presets/instruct/Llama 4 Instruct.json",
+        "type": "instruct"
+    },
     {
         "filename": "presets/instruct/Phi.json",
         "type": "instruct"
@@ -747,6 +751,10 @@
         "filename": "presets/sysprompt/Neutral - Chat.json",
         "type": "sysprompt"
     },
+    {
+        "filename": "presets/sysprompt/Lightning 1.1.json",
+        "type": "sysprompt"
+    },
     {
         "filename": "presets/instruct/Mistral V1.json",
         "type": "instruct"
@@ -786,5 +794,21 @@
     {
         "filename": "presets/context/DeepSeek-V2.5.json",
         "type": "context"
+    },
+    {
+        "filename": "presets/instruct/GLM-4.json",
+        "type": "instruct"
+    },
+    {
+        "filename": "presets/context/GLM-4.json",
+        "type": "context"
+    },
+    {
+        "filename": "presets/reasoning/DeepSeek.json",
+        "type": "reasoning"
+    },
+    {
+        "filename": "presets/reasoning/Blank.json",
+        "type": "reasoning"
     }
 ]

default/content/presets/context/Adventure.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": false,
     "trim_sentences": false,
     "single_line": true,

default/content/presets/context/Alpaca-Single-Turn.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": false,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Alpaca.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/ChatML-Names.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/ChatML.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Command R.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "<|START_OF_TURN_TOKEN|><|SYSTEM_TOKEN|>New Roleplay:<|END_OF_TURN_TOKEN|>",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/DeepSeek-V2.5.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Default.json

@@ -3,7 +3,6 @@
     "example_separator": "***",
     "chat_start": "***",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/DreamGen Role-Play V1 ChatML.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": false,
     "trim_sentences": true,
     "single_line": false,

default/content/presets/context/DreamGen Role-Play V1 Llama3.json

@@ -3,7 +3,6 @@
     "example_separator": "<|eot_id|>\n<|start_header_id|>user<|end_header_id|>\n\nWrite an example narrative / conversation that is not part of the main story.",
     "chat_start": "<|eot_id|>\n<|start_header_id|>user<|end_header_id|>\n\nStart the role-play between {{char}} and {{user}}.",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": false,
     "trim_sentences": true,
     "single_line": false,

default/content/presets/context/GLM-4.json

@@ -0,0 +1,10 @@
+{
+    "story_string": "[gMASK]<sop>{{#if system}}{{system}}\n{{/if}}{{#if wiBefore}}{{wiBefore}}\n{{/if}}{{#if description}}{{description}}\n{{/if}}{{#if personality}}{{char}}'s personality: {{personality}}\n{{/if}}{{#if scenario}}Scenario: {{scenario}}\n{{/if}}{{#if wiAfter}}{{wiAfter}}\n{{/if}}{{#if persona}}{{persona}}\n{{/if}}{{trim}}\n",
+    "example_separator": "",
+    "chat_start": "",
+    "use_stop_strings": false,
+    "always_force_name2": true,
+    "trim_sentences": false,
+    "single_line": false,
+    "name": "GLM-4"
+}

default/content/presets/context/Gemma 2.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Libra-32B.json

@@ -3,7 +3,6 @@
     "example_separator": "### Example:",
     "chat_start": "### START ROLEPLAY:",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Lightning 1.1.json

@@ -1,9 +1,8 @@
 {
-    "story_string": "{{system}}\n{{#if wiBefore}}{{wiBefore}}\n{{/if}}{{#if description}}{{char}}'s description:{{description}}\n{{/if}}{{#if personality}}{{char}}'s personality:{{personality}}\n{{/if}}{{#if scenario}}Scenario: {{scenario}}\n{{/if}}{{#if wiAfter}}{{wiAfter}}\n{{/if}}{{#if persona}}{{user}}'s persona: {{persona}}\n{{/if}}",
-    "example_separator": "Example of an interaction:",
-    "chat_start": "This is the history of the roleplay:",
+    "story_string": "Below is an instruction that describes a task. Write a response that appropriately completes the request.\n\n### Instruction:\n{{system}}\n{{#if wiBefore}}{{wiBefore}}\n{{/if}}{{#if description}}{{char}}'s description:{{description}}\n{{/if}}{{#if personality}}{{char}}'s personality:{{personality}}\n{{/if}}{{#if scenario}}Scenario: {{scenario}}\n{{/if}}{{#if wiAfter}}{{wiAfter}}\n{{/if}}{{#if persona}}{{user}}'s persona: {{persona}}\n{{/if}}\n\n",
+    "example_separator": "Example of an interaction:\n",
+    "chat_start": "This is the history of the roleplay:\n",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Llama 2 Chat.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Llama 3 Instruct.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Llama 4 Instruct.json

@@ -0,0 +1,10 @@
+{
+    "story_string": "<|begin_of_text|><|header_start|>system<|header_end|>\n\n{{#if system}}{{system}}\n{{/if}}{{#if wiBefore}}{{wiBefore}}\n{{/if}}{{#if description}}{{description}}\n{{/if}}{{#if personality}}{{char}}'s personality: {{personality}}\n{{/if}}{{#if scenario}}Scenario: {{scenario}}\n{{/if}}{{#if wiAfter}}{{wiAfter}}\n{{/if}}{{#if persona}}{{persona}}\n{{/if}}{{trim}}<|eot|>",
+    "example_separator": "",
+    "chat_start": "",
+    "use_stop_strings": false,
+    "always_force_name2": true,
+    "trim_sentences": false,
+    "single_line": false,
+    "name": "Llama 4 Instruct"
+}

default/content/presets/context/Llama-3-Instruct-Names.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Metharme.json

@@ -3,9 +3,8 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,
-    "name": "Pygmalion"
+    "name": "Metharme"
 }

default/content/presets/context/Minimalist.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Mistral V1.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Mistral V2 & V3.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Mistral V3-Tekken.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Mistral V7.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/NovelAI.json

@@ -3,7 +3,6 @@
     "example_separator": "***",
     "chat_start": "***",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/OldDefault.json

@@ -3,7 +3,6 @@
     "example_separator": "This is how {{char}} should talk",
     "chat_start": "\nThen the roleplay chat between {{user}} and {{char}} begins.\n",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Phi.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Story.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Synthia.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/Tulu.json

@@ -3,7 +3,6 @@
     "example_separator": "",
     "chat_start": "",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/context/simple-proxy-for-tavern.json

@@ -3,7 +3,6 @@
     "example_separator": "### New Roleplay:",
     "chat_start": "### New Roleplay:",
     "use_stop_strings": false,
-    "allow_jailbreak": false,
     "always_force_name2": true,
     "trim_sentences": false,
     "single_line": false,

default/content/presets/instruct/ChatML.json

@@ -6,7 +6,7 @@
     "stop_sequence": "<|im_end|>",
     "wrap": true,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Command R.json

@@ -8,7 +8,7 @@
     "stop_sequence": "<|END_OF_TURN_TOKEN|>",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "skip_examples": false,
     "output_suffix": "<|END_OF_TURN_TOKEN|>",

default/content/presets/instruct/GLM-4.json

@@ -1,22 +1,22 @@
 {
-    "input_sequence": "<|user|>",
-    "output_sequence": "<|model|>",
+    "input_sequence": "<|user|>\n",
+    "output_sequence": "<|assistant|>\n",
+    "first_output_sequence": "",
     "last_output_sequence": "",
-    "system_sequence": "",
-    "stop_sequence": "<|user|>",
+    "system_sequence_prefix": "<|system|>\n",
+    "system_sequence_suffix": "",
+    "stop_sequence": "",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
-    "system_sequence_prefix": "<|system|>",
-    "system_sequence_suffix": "",
-    "first_output_sequence": "",
     "skip_examples": false,
     "output_suffix": "",
     "input_suffix": "",
+    "system_sequence": "",
     "system_suffix": "",
     "user_alignment_message": "",
-    "system_same_as_user": true,
     "last_system_sequence": "",
-    "name": "Pygmalion"
+    "system_same_as_user": true,
+    "name": "GLM-4"
 }

default/content/presets/instruct/Gemma 2.json

@@ -6,7 +6,7 @@
     "stop_sequence": "<end_of_turn>",
     "wrap": true,
     "macro": true,
-    "names_behavior": "none",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Lightning 1.1.json

@@ -1,7 +1,7 @@
 {
     "input_sequence": "### Instruction:",
-    "output_sequence": "### Response: (length = unlimited)",
-    "last_output_sequence": "",
+    "output_sequence": "### Response:",
+    "last_output_sequence": "### Response: (length = unlimited)",
     "system_sequence": "",
     "stop_sequence": "",
     "wrap": true,
@@ -12,8 +12,8 @@
     "system_sequence_suffix": "",
     "first_output_sequence": "",
     "skip_examples": false,
-    "output_suffix": "",
-    "input_suffix": "",
+    "output_suffix": "\n\n",
+    "input_suffix": "\n\n",
     "system_suffix": "",
     "user_alignment_message": "",
     "system_same_as_user": true,

default/content/presets/instruct/Llama 3 Instruct.json

@@ -6,7 +6,7 @@
     "stop_sequence": "<|eot_id|>",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",
@@ -16,7 +16,7 @@
     "input_suffix": "<|eot_id|>",
     "system_suffix": "<|eot_id|>",
     "user_alignment_message": "",
-    "system_same_as_user": true,
+    "system_same_as_user": false,
     "last_system_sequence": "",
     "name": "Llama 3 Instruct"
 }

default/content/presets/instruct/Llama 4 Instruct.json

@@ -0,0 +1,22 @@
+{
+    "input_sequence": "<|header_start|>user<|header_end|>\n\n",
+    "output_sequence": "<|header_start|>assistant<|header_end|>\n\n",
+    "last_output_sequence": "",
+    "system_sequence": "<|header_start|>system<|header_end|>\n\n",
+    "stop_sequence": "<|eot|>",
+    "wrap": false,
+    "macro": true,
+    "names_behavior": "force",
+    "activation_regex": "",
+    "system_sequence_prefix": "",
+    "system_sequence_suffix": "",
+    "first_output_sequence": "",
+    "skip_examples": false,
+    "output_suffix": "<|eot|>",
+    "input_suffix": "<|eot|>",
+    "system_suffix": "<|eot|>",
+    "user_alignment_message": "",
+    "system_same_as_user": false,
+    "last_system_sequence": "",
+    "name": "Llama 4 Instruct"
+}

default/content/presets/instruct/Mistral V1.json

@@ -6,7 +6,7 @@
     "stop_sequence": "",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Mistral V2 & V3.json

@@ -6,7 +6,7 @@
     "stop_sequence": "",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Mistral V3-Tekken.json

@@ -6,7 +6,7 @@
     "stop_sequence": "",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Mistral V7.json

@@ -6,7 +6,7 @@
     "stop_sequence": "</s>",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "system_sequence_prefix": "",
     "system_sequence_suffix": "",

default/content/presets/instruct/Phi.json

@@ -8,7 +8,7 @@
     "stop_sequence": "<|end|>",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "skip_examples": false,
     "output_suffix": "<|end|>\n",

default/content/presets/instruct/Tulu.json

@@ -8,7 +8,7 @@
     "stop_sequence": "<|end_of_text|>",
     "wrap": false,
     "macro": true,
-    "names_behavior": "always",
+    "names_behavior": "force",
     "activation_regex": "",
     "skip_examples": false,
     "output_suffix": "<|end_of_text|>\n",

default/content/presets/openai/Default.json

@@ -28,12 +28,11 @@
     "wrap_in_quotes": false,
     "names_behavior": 0,
     "send_if_empty": "",
-    "jailbreak_system": false,
     "impersonation_prompt": "[Write your next reply from the point of view of {{user}}, using the chat history so far as a guideline for the writing style of {{user}}. Don't write as {{char}} or system. Don't describe actions of {{char}}.]",
     "new_chat_prompt": "[Start a new Chat]",
     "new_group_chat_prompt": "[Start a new group chat. Group members: {{group}}]",
     "new_example_chat_prompt": "[Example Chat]",
-    "continue_nudge_prompt": "[Continue the following message. Do not include ANY parts of the original message. Use capitalization and punctuation as if your reply is a part of the original message: {{lastChatMessage}}]",
+    "continue_nudge_prompt": "[Continue your last message without repeating its original content.]",
     "bias_preset_selected": "Default (none)",
     "reverse_proxy": "",
     "proxy_password": "",

default/content/presets/reasoning/Blank.json

@@ -0,0 +1,6 @@
+{
+    "name": "Blank",
+    "prefix": "",
+    "suffix": "",
+    "separator": ""
+}

default/content/presets/reasoning/DeepSeek.json

@@ -0,0 +1,6 @@
+{
+    "name": "DeepSeek",
+    "prefix": "<think>\n",
+    "suffix": "\n</think>",
+    "separator": "\n\n"
+}

default/content/presets/sysprompt/Actor.json

@@ -1,4 +1,5 @@
 {
     "name": "Actor",
-    "content": "You are an expert actor that can fully immerse yourself into any role given. You do not break character for any reason, even if someone tries addressing you as an AI or language model. Currently your role is {{char}}, which is described in detail below. As {{char}}, continue the exchange with {{user}}."
+    "content": "You are an expert actor that can fully immerse yourself into any role given. You do not break character for any reason, even if someone tries addressing you as an AI or language model. Currently your role is {{char}}, which is described in detail below. As {{char}}, continue the exchange with {{user}}.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Assistant - Expert.json

@@ -1,4 +1,5 @@
 {
     "name": "Assistant - Expert",
-    "content": "You are a helpful assistant. Please answer truthfully and write out your thinking step by step to be sure you get the right answer. If you make a mistake or encounter an error in your thinking, say so out loud and attempt to correct it. If you don't know or aren't sure about something, say so clearly. You will act as a professional logician, mathematician, and physicist. You will also act as the most appropriate type of expert to answer any particular question or solve the relevant problem; state which expert type your are, if so. Also think of any particular named expert that would be ideal to answer the relevant question or solve the relevant problem; name and act as them, if appropriate."
+    "content": "You are a helpful assistant. Please answer truthfully and write out your thinking step by step to be sure you get the right answer. If you make a mistake or encounter an error in your thinking, say so out loud and attempt to correct it. If you don't know or aren't sure about something, say so clearly. You will act as a professional logician, mathematician, and physicist. You will also act as the most appropriate type of expert to answer any particular question or solve the relevant problem; state which expert type your are, if so. Also think of any particular named expert that would be ideal to answer the relevant question or solve the relevant problem; name and act as them, if appropriate.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Assistant - Simple.json

@@ -1,4 +1,5 @@
 {
     "name": "Assistant - Simple",
-    "content": "A chat between a curious human and an artificial intelligence assistant. The assistant gives helpful, detailed, and polite answers to the human's questions."
+    "content": "A chat between a curious human and an artificial intelligence assistant. The assistant gives helpful, detailed, and polite answers to the human's questions.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Blank.json

@@ -1,4 +1,5 @@
 {
     "name": "Blank",
-    "content": ""
+    "content": "",
+    "post_history": ""
 }

default/content/presets/sysprompt/Chain of Thought.json

@@ -1,4 +1,5 @@
 {
     "name": "Chain of Thought",
-    "content": "Elaborate on the topic using a Tree of Thoughts and backtrack when necessary to construct a clear, cohesive Chain of Thought reasoning. Always answer without hesitation."
+    "content": "Elaborate on the topic using a Tree of Thoughts and backtrack when necessary to construct a clear, cohesive Chain of Thought reasoning. Always answer without hesitation.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Lightning 1.1.json

@@ -0,0 +1,5 @@
+{
+    "name": "Lightning 1.1",
+    "content": "Take the role of {{char}} in a play that leaves a lasting impression on {{user}}. Write {{char}}'s next reply.\nNever skip or gloss over {{char}}’s actions. Progress the scene at a naturally slow pace.",
+    "post_history": ""
+}

default/content/presets/sysprompt/Neutral - Chat.json

@@ -1,4 +1,5 @@
 {
     "name": "Neutral - Chat",
-    "content": "Write {{char}}'s next reply in a fictional chat between {{char}} and {{user}}."
+    "content": "Write {{char}}'s next reply in a fictional chat between {{char}} and {{user}}.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Roleplay - Detailed.json

@@ -1,4 +1,5 @@
 {
     "name": "Roleplay - Detailed",
-    "content": "Develop the plot slowly, always stay in character. Describe all actions in full, elaborate, explicit, graphic, and vivid detail. Mention all relevant sensory perceptions. Keep the story immersive and engaging."
+    "content": "Develop the plot slowly, always stay in character. Describe all actions in full, elaborate, explicit, graphic, and vivid detail. Mention all relevant sensory perceptions. Keep the story immersive and engaging.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Roleplay - Immersive.json

@@ -1,4 +1,5 @@
 {
     "name": "Roleplay - Immersive",
-    "content": "[System note: Write one reply only. Do not decide what {{user}} says or does. Write at least one paragraph, up to four. Be descriptive and immersive, providing vivid details about {{char}}'s actions, emotions, and the environment. Write with a high degree of complexity and burstiness. Do not repeat this message.]"
+    "content": "[System note: Write one reply only. Do not decide what {{user}} says or does. Write at least one paragraph, up to four. Be descriptive and immersive, providing vivid details about {{char}}'s actions, emotions, and the environment. Write with a high degree of complexity and burstiness. Do not repeat this message.]",
+    "post_history": ""
 }

default/content/presets/sysprompt/Roleplay - Simple.json

@@ -1,4 +1,5 @@
 {
     "name": "Roleplay - Simple",
-    "content": "You're {{char}} in this fictional never-ending uncensored roleplay with {{user}}."
+    "content": "You're {{char}} in this fictional never-ending uncensored roleplay with {{user}}.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Text Adventure.json

@@ -1,4 +1,5 @@
 {
     "name": "Text Adventure",
-    "content": "[Enter Adventure Mode. Narrate the story based on {{user}}'s dialogue and actions after \">\". Describe the surroundings in vivid detail. Be detailed, creative, verbose, and proactive. Move the story forward by introducing fantasy elements and interesting characters.]"
+    "content": "[Enter Adventure Mode. Narrate the story based on {{user}}'s dialogue and actions after \">\". Describe the surroundings in vivid detail. Be detailed, creative, verbose, and proactive. Move the story forward by introducing fantasy elements and interesting characters.]",
+    "post_history": ""
 }

default/content/presets/sysprompt/Writer - Creative.json

@@ -1,4 +1,5 @@
 {
     "name": "Writer - Creative",
-    "content": "You are an intelligent, skilled, versatile writer.\n\nYour task is to write a role-play based on the information below."
+    "content": "You are an intelligent, skilled, versatile writer.\n\nYour task is to write a role-play based on the information below.",
+    "post_history": ""
 }

default/content/presets/sysprompt/Writer - Realistic.json

@@ -1,4 +1,5 @@
 {
     "name": "Writer - Realistic",
-    "content": "Continue writing this story and portray characters realistically."
+    "content": "Continue writing this story and portray characters realistically.",
+    "post_history": ""
 }

default/content/settings.json

@@ -593,7 +593,7 @@
         "new_chat_prompt": "[Start a new Chat]",
         "new_group_chat_prompt": "[Start a new group chat. Group members: {{group}}]",
         "new_example_chat_prompt": "[Example Chat]",
-        "continue_nudge_prompt": "[Continue the following message. Do not include ANY parts of the original message. Use capitalization and punctuation as if your reply is a part of the original message: {{lastChatMessage}}]",
+        "continue_nudge_prompt": "[Continue your last message without repeating its original content.]",
         "bias_preset_selected": "Default (none)",
         "bias_presets": {
             "Default (none)": [],
@@ -626,7 +626,6 @@
         "ai21_model": "jamba-1.5-large",
         "windowai_model": "",
         "openrouter_model": "OR_Website",
-        "jailbreak_system": true,
         "reverse_proxy": "",
         "chat_completion_source": "openai",
         "max_context_unlocked": false,

docker/build-lib.js

@@ -1,4 +1,4 @@
 import getWebpackServeMiddleware from '../src/middleware/webpack-serve.js';
 
 const middleware = getWebpackServeMiddleware();
-await middleware.runWebpackCompiler();
+await middleware.runWebpackCompiler({ forceDist: true });

docker/docker-compose.yml

@@ -1,10 +1,12 @@
-version: "3"
 services:
   sillytavern:
     build: ..
     container_name: sillytavern
     hostname: sillytavern
     image: ghcr.io/sillytavern/sillytavern:latest
+    environment:
+      - NODE_ENV=production
+      - FORCE_COLOR=1
     ports:
       - "8000:8000"
     volumes:

docker/docker-entrypoint.sh

@@ -5,5 +5,8 @@ if [ ! -e "config/config.yaml" ]; then
     cp -r "default/config.yaml" "config/config.yaml"
 fi
 
+# Execute postinstall to auto-populate config.yaml with missing values
+npm run postinstall
+
 # Start the server
 exec node server.js --listen "$@"

index.d.ts

@@ -1,7 +1,36 @@
-import { UserDirectoryList, User } from "./src/users";
-import { CsrfSyncedToken } from "csrf-sync";
+import { EventEmitter } from 'node:events';
+import { CsrfSyncedToken } from 'csrf-sync';
+import { UserDirectoryList, User } from './src/users.js';
+import { CommandLineArguments } from './src/command-line.js';
+import { EVENT_NAMES } from './src/server-events.js';
+
+/**
+ * Event payload for SERVER_STARTED event.
+ */
+export interface ServerStartedEvent {
+    /**
+     * The URL the server is listening on.
+     */
+    url: URL;
+}
+
+/**
+ * Map of all server events to their payload types.
+ */
+export interface ServerEventMap {
+    [EVENT_NAMES.SERVER_STARTED]: [ServerStartedEvent];
+}
 
 declare global {
+    declare namespace NodeJS {
+        export interface Process {
+            /**
+             * A global instance of the server events emitter.
+             */
+            serverEvents: EventEmitter<ServerEventMap>;
+        }
+    }
+
     declare namespace CookieSessionInterfaces {
         export interface CookieSessionObject {
             /**
@@ -32,4 +61,9 @@ declare global {
      * The root directory for user data.
      */
     var DATA_ROOT: string;
+
+    /**
+     * Parsed command line arguments.
+     */
+    var COMMAND_LINE_ARGS: CommandLineArguments;
 }

jsconfig.json

@@ -2,7 +2,7 @@
     "compilerOptions": {
         "module": "ESNext",
         "target": "ES2023",
-        "moduleResolution": "Node",
+        "moduleResolution": "Bundler",
         "strictNullChecks": true,
         "strictFunctionTypes": true,
         "checkJs": true,

package.json

@@ -1,39 +1,64 @@
 {
     "dependencies": {
-        "@adobe/css-tools": "^4.4.0",
+        "@adobe/css-tools": "^4.4.2",
         "@agnai/sentencepiece-js": "^1.1.1",
         "@agnai/web-tokenizers": "^0.1.3",
         "@iconfu/svg-inject": "^1.2.3",
-        "@mozilla/readability": "^0.5.0",
+        "@jimp/core": "^1.6.0",
+        "@jimp/js-bmp": "^1.6.0",
+        "@jimp/js-gif": "^1.6.0",
+        "@jimp/js-tiff": "^1.6.0",
+        "@jimp/plugin-blit": "^1.6.0",
+        "@jimp/plugin-circle": "^1.6.0",
+        "@jimp/plugin-color": "^1.6.0",
+        "@jimp/plugin-contain": "^1.6.0",
+        "@jimp/plugin-cover": "^1.6.0",
+        "@jimp/plugin-crop": "^1.6.0",
+        "@jimp/plugin-displace": "^1.6.0",
+        "@jimp/plugin-fisheye": "^1.6.0",
+        "@jimp/plugin-flip": "^1.6.0",
+        "@jimp/plugin-mask": "^1.6.0",
+        "@jimp/plugin-quantize": "^1.6.0",
+        "@jimp/plugin-resize": "^1.6.0",
+        "@jimp/plugin-rotate": "^1.6.0",
+        "@jimp/plugin-threshold": "^1.6.0",
+        "@jimp/wasm-avif": "^1.6.0",
+        "@jimp/wasm-jpeg": "^1.6.0",
+        "@jimp/wasm-png": "^1.6.0",
+        "@jimp/wasm-webp": "^1.6.0",
+        "@mozilla/readability": "^0.6.0",
         "@popperjs/core": "^2.11.8",
-        "@zeldafan0225/ai_horde": "^5.1.0",
+        "@zeldafan0225/ai_horde": "^5.2.0",
         "archiver": "^7.0.1",
         "bing-translate-api": "^4.0.2",
         "body-parser": "^1.20.2",
         "bowser": "^2.11.0",
+        "bytes": "^3.1.2",
+        "chalk": "^5.4.1",
         "command-exists": "^1.2.9",
-        "compression": "^1",
+        "compression": "^1.8.0",
         "cookie-parser": "^1.4.6",
         "cookie-session": "^2.1.0",
         "cors": "^2.8.5",
+        "crc": "^4.3.2",
         "csrf-sync": "^4.0.3",
         "diff-match-patch": "^1.0.5",
         "dompurify": "^3.2.4",
         "droll": "^0.2.1",
         "express": "^4.21.0",
-        "form-data": "^4.0.0",
-        "fuse.js": "^7.0.0",
+        "form-data": "^4.0.2",
+        "fuse.js": "^7.1.0",
         "google-translate-api-browser": "^3.0.1",
-        "google-translate-api-x": "^10.7.1",
+        "google-translate-api-x": "^10.7.2",
         "handlebars": "^4.7.8",
-        "helmet": "^7.1.0",
-        "highlight.js": "^11.10.0",
+        "helmet": "^7.2.0",
+        "highlight.js": "^11.11.1",
         "html-entities": "^2.5.2",
         "iconv-lite": "^0.6.3",
         "ip-matching": "^2.1.2",
         "ip-regex": "^5.0.0",
-        "ipaddr.js": "^2.0.1",
-        "jimp": "^0.22.10",
+        "ipaddr.js": "^2.2.0",
+        "is-docker": "^3.0.0",
         "localforage": "^1.10.0",
         "lodash": "^4.17.21",
         "mime-types": "^2.1.35",
@@ -41,28 +66,27 @@
         "morphdom": "^2.7.4",
         "multer": "^1.4.5-lts.1",
         "node-fetch": "^3.3.2",
-        "node-persist": "^4.0.1",
+        "node-persist": "^4.0.4",
         "open": "^8.4.2",
         "png-chunk-text": "^1.0.0",
-        "png-chunks-encode": "^1.0.0",
         "png-chunks-extract": "^1.0.0",
-        "proxy-agent": "^6.4.0",
-        "rate-limiter-flexible": "^5.0.0",
-        "response-time": "^2.3.2",
+        "proxy-agent": "^6.5.0",
+        "rate-limiter-flexible": "^5.0.5",
+        "response-time": "^2.3.3",
         "sanitize-filename": "^1.6.3",
         "seedrandom": "^3.0.5",
         "showdown": "^2.1.0",
         "sillytavern-transformers": "2.14.6",
-        "simple-git": "^3.19.1",
+        "simple-git": "^3.27.0",
         "slidetoggle": "^4.0.0",
-        "tiktoken": "^1.0.16",
+        "tiktoken": "^1.0.20",
         "url-join": "^5.0.0",
         "vectra": "^0.2.2",
         "wavefile": "^11.0.0",
-        "webpack": "^5.95.0",
+        "webpack": "^5.98.0",
         "write-file-atomic": "^5.0.1",
-        "ws": "^8.17.1",
-        "yaml": "^2.3.4",
+        "ws": "^8.18.1",
+        "yaml": "^2.7.0",
         "yargs": "^17.7.1",
         "yauzl": "^2.10.0"
     },
@@ -87,10 +111,11 @@
         "type": "git",
         "url": "https://github.com/SillyTavern/SillyTavern.git"
     },
-    "version": "1.12.12",
+    "version": "1.12.14",
     "scripts": {
         "start": "node server.js",
-        "debug": "node server.js --inspect",
+        "debug": "node --inspect server.js",
+        "start:electron": "cd ./src/electron && npm run start",
         "start:deno": "deno run --allow-run --allow-net --allow-read --allow-write --allow-sys --allow-env server.js",
         "start:bun": "bun server.js",
         "start:no-csrf": "node server.js --disableCsrf",
@@ -109,25 +134,25 @@
     },
     "main": "server.js",
     "devDependencies": {
-        "@types/archiver": "^6.0.2",
+        "@types/archiver": "^6.0.3",
+        "@types/bytes": "^3.1.5",
         "@types/command-exists": "^1.2.3",
         "@types/compression": "^1.7.5",
-        "@types/cookie-parser": "^1.4.7",
+        "@types/cookie-parser": "^1.4.8",
         "@types/cookie-session": "^2.0.49",
         "@types/cors": "^2.8.17",
-        "@types/deno": "^2.0.0",
+        "@types/deno": "^2.2.0",
         "@types/express": "^4.17.21",
-        "@types/jquery": "^3.5.29",
+        "@types/jquery": "^3.5.32",
         "@types/jquery-cropper": "^1.0.4",
         "@types/jquery.transit": "^0.9.33",
-        "@types/jqueryui": "^1.12.23",
-        "@types/lodash": "^4.17.10",
+        "@types/jqueryui": "^1.12.24",
+        "@types/lodash": "^4.17.16",
         "@types/mime-types": "^2.1.4",
         "@types/multer": "^1.4.12",
-        "@types/node": "^18.19.55",
+        "@types/node": "^18.19.80",
         "@types/node-persist": "^3.1.8",
         "@types/png-chunk-text": "^1.0.3",
-        "@types/png-chunks-encode": "^1.0.2",
         "@types/png-chunks-extract": "^1.0.2",
         "@types/response-time": "^2.3.8",
         "@types/select2": "^4.0.63",
@@ -135,6 +160,7 @@
         "@types/write-file-atomic": "^4.0.3",
         "@types/yargs": "^17.0.33",
         "@types/yauzl": "^2.10.3",
-        "eslint": "^8.57.0"
+        "eslint": "^8.57.1",
+        "eslint-plugin-jsdoc": "^48.10.0"
     }
 }

plugins.js

@@ -8,7 +8,7 @@ import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 
-import { default as git } from 'simple-git';
+import { default as git, CheckRepoActions } from 'simple-git';
 import { color } from './src/util.js';
 
 const __dirname = import.meta.dirname ?? path.dirname(fileURLToPath(import.meta.url));
@@ -49,7 +49,7 @@ async function updatePlugins() {
             const pluginPath = path.join(pluginsPath, directory);
             const pluginRepo = git(pluginPath);
 
-            const isRepo = await pluginRepo.checkIsRepo();
+            const isRepo = await pluginRepo.checkIsRepo(CheckRepoActions.IS_REPO_ROOT);
             if (!isRepo) {
                 console.log(`Directory ${color.yellow(directory)} is not a Git repository`);
                 continue;