sillytavern 1.16.0 → 1.17.0

package/.dockerignore

@@ -11,6 +11,7 @@
 /docker/extensions
 /docker/data
 /docker/plugins
+/docker/dist
 /public/scripts/extensions/third-party
 
 # --- Plugins (keep only package files) ---

package/.eslintrc.cjs

@@ -102,5 +102,28 @@ module.exports = {
         // These rules should eventually be enabled.
         'no-async-promise-executor': 'off',
         'no-inner-declarations': 'off',
+        // Additional formatting rules based on codebase conventions
+        'brace-style': ['error', '1tbs', { allowSingleLine: true }],
+        'array-bracket-spacing': ['error', 'never'],
+        'computed-property-spacing': ['error', 'never'],
+        'block-spacing': ['error', 'always'],
+        'keyword-spacing': ['error', { before: true, after: true }],
+        'space-before-blocks': ['error', 'always'],
+        'space-before-function-paren': ['error', { anonymous: 'always', named: 'never', asyncArrow: 'always' }],
+        'space-in-parens': ['error', 'never'],
+        'comma-spacing': ['error', { before: false, after: true }],
+        'key-spacing': ['error', { beforeColon: false, afterColon: true }],
+        'func-call-spacing': ['error', 'never'],
+        'no-multiple-empty-lines': ['error', { max: 2, maxEOF: 1, maxBOF: 0 }],
+        'padded-blocks': ['error', 'never'],
+        'no-whitespace-before-property': 'error',
+        'space-unary-ops': ['error', { words: true, nonwords: false }],
+        'arrow-spacing': ['error', { before: true, after: true }],
+        'template-curly-spacing': ['error', 'never'],
+        'rest-spread-spacing': ['error', 'never'],
+        'generator-star-spacing': ['error', { before: false, after: true }],
+        'yield-star-spacing': ['error', { before: false, after: true }],
+        'template-tag-spacing': ['error', 'never'],
+        'switch-colon-spacing': ['error', { after: true, before: false }],
     },
 };

package/config.yaml

@@ -165,6 +165,8 @@ rateLimiting:
 
 ## BACKUP CONFIGURATION
 backups:
+  # Allow users to create a full backup archive of their data
+  allowFullDataBackup: true
   # Common settings for all backup types
   common:
     # Number of backups to keep for each chat and settings file
@@ -202,6 +204,16 @@ performance:
   memoryCacheCapacity: '100mb'
   # Enables disk caching for character cards. Improves performances with large card libraries.
   useDiskCache: true
+  # Configures gzip compression for client requests with large payloads (e.g. settings or chat saves).
+  requestCompression:
+    # Enable request compression.
+    enabled: false
+    # Minimum payload size to trigger compression. Set to 0 to compress all requests regardless of size.
+    minPayloadSize: '256kb'
+    # Hard upper payload size limit for compression. Set to 0 to allow compression of any size.
+    maxPayloadSize: '8mb'
+    # Timeout for request compression in milliseconds.
+    timeout: 4000
 
 # CACHE BUSTER CONFIGURATION
 # IMPORTANT: Requires localhost or a domain with HTTPS, otherwise will not work!
@@ -250,6 +262,13 @@ extensions:
     speechToText: Xenova/whisper-small
     textToSpeech: Xenova/speecht5_tts
 
+# Git backend for plugin/extension repository operations.
+# - Use "auto" to prefer system git, falling back to the integrated backend
+# - Use "system" to force system backend
+# - Use "builtin" to force integrated backend
+git:
+  backend: auto
+
 # Additional model tokenizers can be downloaded on demand.
 # Disabling will fallback to another locally available tokenizer.
 enableDownloadableTokenizers: true
@@ -293,7 +312,7 @@ claude:
   # Otherwise, you'll just waste money on cache misses.
   enableSystemPromptCache: false
   # Enables caching of the message history at depth (if supported).
-  # https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
+  # https://platform.claude.com/docs/en/build-with-claude/prompt-caching
   # -- IMPORTANT! --
   # Use with caution. Behavior may be unpredictable and no guarantees can or will be made.
   # Set to an integer to specify the desired depth. 0 (which does NOT include the prefill)
@@ -304,6 +323,10 @@ claude:
   ## 5m: base price x 1.25
   ## 1h: base price x 2
   extendedTTL: false
+  # Enables adaptive thinking for supported models (Opus 4.6+).
+  # Disable to enforce legacy thinking mode (with thinking budget).
+  # https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking
+  enableAdaptiveThinking: false
 # -- GOOGLE GEMINI API CONFIGURATION --
 gemini:
   # API endpoint version ("v1beta" or "v1alpha")

package/default/config.yaml

@@ -165,6 +165,8 @@ rateLimiting:
 
 ## BACKUP CONFIGURATION
 backups:
+  # Allow users to create a full backup archive of their data
+  allowFullDataBackup: true
   # Common settings for all backup types
   common:
     # Number of backups to keep for each chat and settings file
@@ -202,6 +204,16 @@ performance:
   memoryCacheCapacity: '100mb'
   # Enables disk caching for character cards. Improves performances with large card libraries.
   useDiskCache: true
+  # Configures gzip compression for client requests with large payloads (e.g. settings or chat saves).
+  requestCompression:
+    # Enable request compression.
+    enabled: false
+    # Minimum payload size to trigger compression. Set to 0 to compress all requests regardless of size.
+    minPayloadSize: '256kb'
+    # Hard upper payload size limit for compression. Set to 0 to allow compression of any size.
+    maxPayloadSize: '8mb'
+    # Timeout for request compression in milliseconds.
+    timeout: 4000
 
 # CACHE BUSTER CONFIGURATION
 # IMPORTANT: Requires localhost or a domain with HTTPS, otherwise will not work!
@@ -250,6 +262,13 @@ extensions:
     speechToText: Xenova/whisper-small
     textToSpeech: Xenova/speecht5_tts
 
+# Git backend for plugin/extension repository operations.
+# - Use "auto" to prefer system git, falling back to the integrated backend
+# - Use "system" to force system backend
+# - Use "builtin" to force integrated backend
+git:
+  backend: auto
+
 # Additional model tokenizers can be downloaded on demand.
 # Disabling will fallback to another locally available tokenizer.
 enableDownloadableTokenizers: true
@@ -293,7 +312,7 @@ claude:
   # Otherwise, you'll just waste money on cache misses.
   enableSystemPromptCache: false
   # Enables caching of the message history at depth (if supported).
-  # https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching
+  # https://platform.claude.com/docs/en/build-with-claude/prompt-caching
   # -- IMPORTANT! --
   # Use with caution. Behavior may be unpredictable and no guarantees can or will be made.
   # Set to an integer to specify the desired depth. 0 (which does NOT include the prefill)
@@ -304,6 +323,10 @@ claude:
   ## 5m: base price x 1.25
   ## 1h: base price x 2
   extendedTTL: false
+  # Enables adaptive thinking for supported models (Opus 4.6+).
+  # Disable to enforce legacy thinking mode (with thinking budget).
+  # https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking
+  enableAdaptiveThinking: false
 # -- GOOGLE GEMINI API CONFIGURATION --
 gemini:
   # API endpoint version ("v1beta" or "v1alpha")

package/default/content/index.json

@@ -638,5 +638,9 @@
     {
         "filename": "presets/reasoning/OpenAI Harmony.json",
         "type": "reasoning"
+    },
+    {
+        "filename": "presets/reasoning/Think XML.json",
+        "type": "reasoning"
     }
 ]

package/default/content/presets/instruct/KoboldAI.json

@@ -1,6 +1,6 @@
 {
     "input_sequence": "{{[INPUT]}}",
-    "output_sequence": "{{[OUPUT]}}",
+    "output_sequence": "{{[OUTPUT]}}",
     "last_output_sequence": "",
     "system_sequence": "{{[SYSTEM]}}",
     "stop_sequence": "",

package/default/content/presets/reasoning/Think XML.json

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

package/default/content/settings.json

@@ -191,7 +191,7 @@
         "custom_stopping_strings_macro": true,
         "fuzzy_search": true,
         "encode_tags": false,
-        "experimental_macro_engine": false,
+        "experimental_macro_engine": true,
         "enableLabMode": false,
         "enableZenSliders": false,
         "ui_mode": 1,

package/index.d.ts

@@ -40,7 +40,7 @@ declare global {
             /**
              * Authenticated user handle.
              */
-            handle: string;
+            handle: string | null;
             /**
              * Last time the session was extended.
              */

package/package.json

@@ -48,10 +48,11 @@
         "droll": "^0.2.1",
         "env-paths": "^3.0.0",
         "express": "^4.21.0",
+        "fflate": "^0.8.2",
         "form-data": "^4.0.4",
         "fuse.js": "^7.1.0",
         "google-translate-api-x": "^10.7.2",
-        "handlebars": "^4.7.8",
+        "handlebars": "^4.7.9",
         "helmet": "^8.1.0",
         "highlight.js": "^11.11.1",
         "host-validation-middleware": "^0.1.1",
@@ -62,12 +63,13 @@
         "ip-regex": "^5.0.0",
         "ipaddr.js": "^2.2.0",
         "is-docker": "^3.0.0",
+        "isomorphic-git": "^1.36.3",
         "localforage": "^1.10.0",
         "lodash": "^4.17.21",
         "mime-types": "^3.0.2",
         "moment": "^2.30.1",
         "morphdom": "^2.7.7",
-        "multer": "^2.0.2",
+        "multer": "^2.1.1",
         "node-fetch": "^3.3.2",
         "node-persist": "^4.0.4",
         "open": "^10.2.0",
@@ -80,21 +82,21 @@
         "seedrandom": "^3.0.5",
         "showdown": "^2.1.0",
         "sillytavern-transformers": "2.14.6",
-        "simple-git": "^3.28.0",
+        "simple-git": "^3.33.0",
         "slidetoggle": "^4.0.0",
         "tiktoken": "^1.0.22",
         "url-join": "^5.0.0",
         "vectra": "^0.2.2",
         "wavefile": "^11.0.0",
-        "webpack": "^5.98.0",
+        "webpack": "^5.105.4",
         "write-file-atomic": "^5.0.1",
         "ws": "^8.18.3",
-        "yaml": "^2.8.1",
+        "yaml": "^2.8.3",
         "yargs": "^17.7.1",
-        "yauzl": "^3.2.0"
+        "yauzl": "^3.2.1"
     },
     "engines": {
-        "node": ">= 18"
+        "node": ">= 20"
     },
     "overrides": {
         "vectra": {
@@ -111,7 +113,7 @@
         "type": "git",
         "url": "https://github.com/SillyTavern/SillyTavern.git"
     },
-    "version": "1.16.0",
+    "version": "1.17.0",
     "scripts": {
         "start": "node server.js",
         "debug": "node --inspect server.js",
@@ -151,7 +153,7 @@
         "@types/jqueryui": "^1.12.24",
         "@types/lodash": "^4.17.20",
         "@types/mime-types": "^3.0.1",
-        "@types/multer": "^2.0.0",
+        "@types/multer": "^2.1.0",
         "@types/node": "^18.19.84",
         "@types/node-persist": "^3.1.8",
         "@types/png-chunk-text": "^1.0.3",

package/plugins.js

@@ -9,11 +9,13 @@ import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 
 import { default as git, CheckRepoActions } from 'simple-git';
+import { createGitClient } from './src/git/client.js';
 import { color } from './src/util.js';
 
 const __dirname = import.meta.dirname ?? path.dirname(fileURLToPath(import.meta.url));
 process.chdir(__dirname);
 const pluginsPath = './plugins';
+const gitBackend = process.env.SILLYTAVERN_GIT_BACKEND || 'auto';
 
 const command = process.argv[2];
 
@@ -87,10 +89,9 @@ async function installPlugin(pluginName) {
             return console.log(color.yellow(`Directory already exists at ${pluginPath}`));
         }
 
-        await git().clone(pluginName, pluginPath, { '--depth': 1 });
+        await createGitClient({ backend: gitBackend }).clone(pluginName, pluginPath, { depth: 1 });
         console.log(`Plugin ${color.green(pluginName)} installed to ${color.cyan(pluginPath)}`);
-    }
-    catch (error) {
+    } catch (error) {
         console.error(color.red(`Failed to install plugin ${pluginName}`), error);
     }
 }

package/public/css/backgrounds.css

@@ -107,7 +107,8 @@
     opacity: 1;
 }
 
-.bg_example .mobile-only-menu-toggle {
+.bg_example .mobile-only-menu-toggle,
+.bg_folder_tile .mobile-only-menu-toggle {
     display: none;
 }
 
@@ -135,19 +136,32 @@
     outline-offset: 0;
 }
 
-.bg_example.locked-background::after {
-    content: '\f023';
+.bg_example.locked-background::after,
+.bg_example.selected-background::before,
+#Backgrounds.bg-selection-mode #bg_menu_content .bg_example.folder-group-selected::before {
     font-family: 'Font Awesome 6 Free';
     font-weight: 900;
-
     position: absolute;
+    z-index: 4;
+    filter: drop-shadow(0 1px 3px rgba(0, 0, 0, 0.8));
+    pointer-events: none;
+}
+
+.bg_example.selected-background::before,
+#Backgrounds.bg-selection-mode #bg_menu_content .bg_example.folder-group-selected::before {
+    content: '\f00c';
+    top: 5px;
+    color: var(--white100);
+    font-size: calc(var(--mainFontSize) * 0.9);
+}
+
+.bg_example.locked-background::after {
+    content: '\f023';
     bottom: 5px;
     right: 5px;
-    z-index: 4;
     color: var(--golden);
     filter: drop-shadow(0 1px 2px rgba(0, 0, 0, 0.8));
     font-size: calc(var(--mainFontSize) * 0.8);
-    pointer-events: none;
 }
 
 .bg_example:not(.locked-background) .jg-unlock,
@@ -161,17 +175,28 @@
 }
 
 .bg_example.selected-background::before {
-    content: '\f00c';
-    font-family: 'Font Awesome 6 Free';
-    font-weight: 900;
-    position: absolute;
-    top: 5px;
     left: 5px;
-    z-index: 4;
-    color: var(--white100);
-    filter: drop-shadow(0 1px 3px rgba(0, 0, 0, 0.8));
-    font-size: calc(var(--mainFontSize) * 0.9);
-    pointer-events: none;
+}
+
+#bg_selection_mode_button.active {
+    color: var(--golden);
+}
+
+#bg_group_select_count {
+    font-weight: 700;
+}
+
+#Backgrounds.bg-selection-mode #bg_menu_content .bg_example .jg-menu {
+    display: none;
+}
+
+#Backgrounds.bg-selection-mode #bg_menu_content .bg_example.folder-group-selected {
+    outline: 2px solid var(--interactable-outline-color);
+    outline-offset: 0;
+}
+
+#Backgrounds.bg-selection-mode #bg_menu_content .bg_example.folder-group-selected::before {
+    right: 5px;
 }
 
 .bg_example .jg-menu {
@@ -376,3 +401,169 @@
 #bg_custom_content:not(:empty)~#bg_chat_hint {
     display: none;
 }
+
+.bg_folder_grid.bg_list {
+    display: grid;
+    gap: 5px;
+    width: 100%;
+    grid-template-columns: repeat(calc(var(--bg-thumb-columns, 5) + 2), 1fr);
+    margin-bottom: 10px;
+}
+
+.bg_folder_grid:empty {
+    display: none;
+}
+
+.bg_folder_tile {
+    cursor: pointer;
+    position: relative;
+    overflow: hidden;
+    border-radius: 8px;
+    height: auto;
+    aspect-ratio: 1 / 1;
+    outline: 2px solid var(--SmartThemeBorderColor);
+    outline-offset: -1px;
+    box-shadow: 0 0 7px var(--black50a);
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    background-color: var(--SmartThemeBlurTintColor);
+    transition: filter var(--animation-duration) ease;
+}
+
+.bg_folder_tile:hover {
+    filter: brightness(1.1);
+}
+
+.bg_folder_tile_cover {
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background-size: cover;
+    background-position: center;
+    border-radius: inherit;
+}
+
+.bg_folder_tile_overlay {
+    position: absolute;
+    bottom: 0;
+    left: 0;
+    right: 0;
+    background: linear-gradient(transparent, rgba(0, 0, 0, 0.85));
+    color: var(--SmartThemeBodyColor);
+    padding: 6px 8px 4px;
+    display: flex;
+    align-items: center;
+    gap: 5px;
+    font-size: 0.85em;
+    font-weight: 600;
+    pointer-events: none;
+    border-radius: 0 0 8px 8px;
+}
+
+.bg_folder_tile_overlay i {
+    font-size: 0.9em;
+    opacity: 0.8;
+}
+
+.bg_folder_tile_name {
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+/* Folder tile action menu */
+.bg_folder_tile .bg_folder_tile_menu {
+    display: flex;
+    position: absolute;
+    top: 2px;
+    right: 2px;
+    background-color: rgba(0, 0, 0, 0.5);
+    border-radius: 5px;
+    padding: 3px;
+    z-index: 3;
+    backdrop-filter: blur(4px);
+    border: 1px solid var(--SmartThemeBorderColor);
+    align-items: center;
+
+    opacity: 0;
+    visibility: hidden;
+    transform: scale(0.9);
+    transform-origin: center;
+    transition: opacity var(--animation-duration) ease-out, visibility var(--animation-duration) ease-out, transform var(--animation-duration) ease-out;
+}
+
+.bg_folder_tile:hover .bg_folder_tile_menu,
+.bg_folder_tile:focus-within .bg_folder_tile_menu {
+    opacity: 1;
+    visibility: visible;
+    transform: scale(1);
+}
+
+.bg_folder_tile .jg-button {
+    display: flex;
+    width: 24px;
+    height: 24px;
+    align-items: center;
+    justify-content: center;
+    color: white;
+    padding: 5px;
+    font-size: 1.1em;
+    border-radius: 5px;
+    transition: background-color var(--animation-duration) ease;
+}
+
+.bg_folder_tile .jg-button:hover {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+/* New Folder placeholder tile */
+.bg_new_folder_tile {
+    border: 2px dashed var(--SmartThemeBorderColor);
+    outline: none;
+    color: var(--SmartThemeBodyColor);
+    opacity: 0.6;
+    gap: 6px;
+    font-size: 0.85em;
+    font-weight: 600;
+}
+
+.bg_new_folder_tile:hover {
+    opacity: 1;
+    transform: scale(1.03);
+}
+
+/* Breadcrumb bar */
+.bg_folder_breadcrumb {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 5px 0;
+    margin-bottom: 5px;
+}
+
+.bg_current_folder_name {
+    font-weight: 600;
+    font-size: 1em;
+    color: var(--SmartThemeBodyColor);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+#Backgrounds:not(.in-folder-view) .jg-set-cover {
+    display: none !important;
+}
+
+#Backgrounds.in-folder-view .jg-set-cover {
+    display: flex !important;
+}
+
+/* Hide folder actions on custom (chat-specific) backgrounds */
+.bg_example[custom="true"] .jg-folder,
+.bg_example[custom="true"] .jg-set-cover {
+    display: none !important;
+}

package/public/css/loader.css

@@ -29,3 +29,60 @@
     align-items: center;
     justify-content: center;
 }
+
+/* Action loader toast styles */
+.action-loader-toast {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    width: 100%;
+}
+
+.action-loader-message {
+    flex: 1;
+}
+
+.action-loader-stop {
+    cursor: pointer;
+    font-size: 1.2em;
+    opacity: 0.8;
+    transition: opacity 0.15s ease, color 0.15s ease;
+}
+
+.action-loader-stop:hover {
+    opacity: 1;
+    color: color-mix(in srgb, currentColor 40%, #e74c3c 60%);
+}
+
+/* Splash screen styles for branded loading */
+#loader.splash-screen {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 4rem;
+    width: 100%;
+    height: 100%;
+    transition: all var(--animation-duration-2x) ease-out;
+}
+
+#loader.splash-screen #load-spinner {
+    position: static;
+    top: unset;
+    left: unset;
+}
+
+.splash-logo {
+    /* max original px, or 50% on mobile */
+    width: min(150px, 50%);
+    height: auto;
+    filter: drop-shadow(0 4px 8px rgba(0, 0, 0, 0.3));
+}
+
+.splash-message {
+    margin: 0;
+    font-size: 1.25rem;
+    font-weight: 500;
+    opacity: 0.9;
+    letter-spacing: 0.02em;
+}