sillytavern 1.13.5 → 1.16.0

package/.dockerignore

@@ -1,17 +1,61 @@
+# --- Git & CI ---
 .git
 .github
-.vscode
-node_modules
-npm-debug.log
-readme*
-Start.bat
-/dist
+.gitignore
+
+# --- Docker ---
+/Dockerfile
+/.dockerignore
+/docker/docker-compose.yml
+/docker/config
+/docker/extensions
+/docker/data
+/docker/plugins
+/public/scripts/extensions/third-party
+
+# --- Plugins (keep only package files) ---
+/plugins/*
+!/plugins/package.json
+!/plugins/package-lock.json
+
+# --- The Folders ---
 /backups
-cloudflared.exe
-access.log
-/data
 /cache
-.DS_Store
-/public/scripts/extensions/third-party
 /colab
+/data
+/dist
+/node_modules
+/tests
+
+# --- Sensitive Info ---
+**/.env*
+**/*.pem
+**/certs
+
+# --- Documentation ---
+readme*
+*.md
+Update-Instructions.txt
+
+# --- OS & System Junk ---
+**/.DS_Store
+*.bat
+*.cmd
+*.exe
+start.sh
+
+# --- Dev Config ---
+.editorconfig
+.eslintrc.cjs
+.eslintrc*
+.vscode
+**/jsconfig.json
+.npmignore
 .gemini
+replit.nix
+.replit
+.nomedia
+
+# -- Logs & Temp ---
+*.log
+**/tmp

package/.eslintrc.cjs

@@ -98,7 +98,7 @@ module.exports = {
         'no-cond-assign': 'error',
         'no-unneeded-ternary': 'error',
         'no-irregular-whitespace': ['error', { skipStrings: true, skipTemplates: true }],
-
+        'dot-notation': ['error', { 'allowPattern': '[A-Z]\\w*$' }],
         // These rules should eventually be enabled.
         'no-async-promise-executor': 'off',
         'no-inner-declarations': 'off',

package/CONTRIBUTING.md

@@ -12,30 +12,63 @@
 2. Fork this repository under your account.
 3. Clone the fork onto your machine.
 4. Open the cloned repository in the code editor.
-5. Create a git branch (recommended).
+5. Create a git branch (recommended), review the [git book](https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control) if you haven't.
 6. Make your changes and test them locally.
 7. Commit the changes and push the branch to the remote repo.
-8. Go to GitHub, and open a pull request, targeting the upstream branch.
+8. Go to GitHub, and open a pull request, targeting the appropriate upstream branch.
 
 ## Contribution guidelines
 
-1. Our standards are pretty low, but make sure the code is not too ugly:
-  - Run VS Code's autoformat when you're done.
-  - Check with ESLint by running `npm run lint`, then fix the errors.
-  - Use common sense and follow existing naming conventions.
-2. Create pull requests for the staging branch, 99% of contributions should go there. That way people could test your code before the next stable release.
-3. You can still send a pull request for release in the following scenarios:
-  - Updating README.
-  - Updating GitHub Actions.
-  - Hotfixing a critical bug.
-4. Project maintainers will test and can change your code before merging.
-5. To make sure that your contribution remains testable and reviewable, try not to exceed a soft limit of **200 lines of code** (both additions and deletions) per pull request. If you have more to contribute, split it into multiple pull requests. We can also consider creating a separate feature branch for more substantial changes, but please discuss it with the maintainers first.
-6. Write at least somewhat meaningful PR descriptions and commit messages. There's no "right" way to do it, but the following may help with outlining a general structure:
-  - What is the reason for a change?
-  - What did you do to achieve this?
-  - How would a reviewer test the change?
-7. English is the primary language of communication in this project. Please use only English when writing commit messages, PR descriptions, comments and other text. This does not apply to contributions to localization files.
-8. Mind the license. Your contributions will be licensed under the GNU Affero General Public License. If you don't know what that implies, consult your lawyer.
+### Maintain code quality
+
+Our standards are pretty low, but make sure the code is not too ugly:
+
+- Run VS Code's autoformat when you're done.
+- Check with ESLint by running `npm run lint`, then fix the errors.
+- Use common sense and follow existing naming conventions.
+
+### Use the correct target branch
+
+Create pull requests for the `staging` branch, 99% of contributions should go there. That way people could test your code before the next stable release.
+
+You can still send a pull request for `release` in the following scenarios:
+
+- Updating README.
+- Updating GitHub Actions.
+- Hotfixing a critical bug.
+
+Project maintainers will test and can change your code before merging. To keep our workflow smooth, please ensure the following:
+
+- The "Allow edits from maintainers" option is checked.
+- Avoid force-pushing your branch once the PR is out of draft state.
+
+### Make contributions small and testable
+
+To make sure that your contribution remains testable and reviewable, try not to exceed a soft limit of **200 lines of code** (both additions and deletions) per pull request. If you have more to contribute, split it into multiple pull requests.
+
+We can also consider creating a separate feature branch for more substantial changes, but please discuss it with the maintainers first. For example:
+
+- Leave the main larger PR as a draft so it can be used to discuss the implementation.
+- Split each group of functions or features into a ~200 line PR so it can be properly reviewed and merged to staging or a feature branch.
+- If there are large codependent changes that cannot be split, start with the most utilized dependencies and stub dependent functions.
+- Each will be reviewed and tested one by one, merging into the feature branch as they're ready.
+- Do not create all branches in advance, as subsequent changes made in previous commits as a result of test/review may create a lot of merge conflicts.
+
+### Provide clear descriptions of your changes
+
+Write at least somewhat meaningful PR descriptions and commit messages. There's no "right" way to do it, but the following may help with outlining a general structure:
+
+- What is the reason for a change?
+- What did you do to achieve this?
+- How would a reviewer test the change?
+
+### We (likely) don't speak your language
+
+English is the primary language of communication in this project. Please use only English when writing commit messages, PR descriptions, comments and other text. This does not apply to contributions to localization files.
+
+### Legal stuff
+
+Mind the license. Your contributions will be licensed under the GNU Affero General Public License. If you don't know what that implies, consult your lawyer.
 
 ## Use of AI coding assistance tools ("Vibe Coding")
 

package/Dockerfile

@@ -1,44 +1,48 @@
-FROM node:lts-alpine3.22
+FROM node:lts-alpine3.23
 
 # Arguments
 ARG APP_HOME=/home/node/app
 
 # Install system dependencies
-RUN apk add --no-cache gcompat tini git git-lfs
+# "Don't rely on the base image for tools; if you call it, you install it." ;)
+RUN apk add --no-cache gcompat tini git git-lfs su-exec shadow dos2unix
 
-# Create app directory
+# Create app directory and set ownership
 WORKDIR ${APP_HOME}
+RUN chown node:node ${APP_HOME}
 
 # Set NODE_ENV to production
 ENV NODE_ENV=production
 
-# Bundle app source
-COPY . ./
+# Bundle app source and set ownership
+COPY --chown=node:node . ./
 
 RUN \
   echo "*** Install npm packages ***" && \
-  npm i --no-audit --no-fund --loglevel=error --no-progress --omit=dev && npm cache clean --force
+  npm ci --no-audit --no-fund --loglevel=error --no-progress --omit=dev && npm cache clean --force
 
-# Create config directory and link config.yaml
+# Create config directory and link config.yaml. Added hardcoded dirs(constants.js?)
+# that must be present for Non-Root Mode and volumeless docker runs.
 RUN \
   rm -f "config.yaml" || true && \
-  ln -s "./config/config.yaml" "config.yaml" || true && \
-  mkdir "config" || true
+  mkdir -p config data plugins public/scripts/extensions/third-party backups && \
+  chown -R node:node config data plugins public/scripts/extensions/third-party backups && \
+  ln -s "./config/config.yaml" "config.yaml"
 
 # Pre-compile public libraries
 RUN \
   echo "*** Run Webpack ***" && \
   node "./docker/build-lib.js"
 
-# Set the entrypoint script
+# Set the entrypoint script and cleanup
 RUN \
   echo "*** Cleanup ***" && \
   mv "./docker/docker-entrypoint.sh" "./" && \
-  rm -rf "./docker" && \
   echo "*** Make docker-entrypoint.sh executable ***" && \
   chmod +x "./docker-entrypoint.sh" && \
   echo "*** Convert line endings to Unix format ***" && \
-  dos2unix "./docker-entrypoint.sh"
+  dos2unix "./docker-entrypoint.sh" && \
+  rm -rf "./docker"
 
 # Fix extension repos permissions
 RUN git config --global --add safe.directory "*"

package/Start.bat

@@ -1,7 +1,7 @@
 @echo off
 pushd %~dp0
 set NODE_ENV=production
-call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
+call npm install --no-save --no-audit --no-fund --loglevel=error --no-progress --omit=dev
 node server.js %*
 pause
 popd

package/UpdateAndStart.bat

@@ -20,7 +20,7 @@ if %errorlevel% neq 0 (
     )
 )
 set NODE_ENV=production
-call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
+call npm install --no-save --no-audit --no-fund --loglevel=error --no-progress --omit=dev
 node server.js %*
 :end
 pause

package/UpdateForkAndStart.bat

@@ -102,7 +102,7 @@ if %errorlevel% neq 0 (
 
 echo Installing npm packages and starting server
 set NODE_ENV=production
-call npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev
+call npm install --no-save --no-audit --no-fund --loglevel=error --no-progress --omit=dev
 node server.js %*
 
 :end

package/config.yaml

@@ -38,6 +38,9 @@ browserLaunch:
   avoidLocalhost: false
 # Server port
 port: 8000
+# Interval in seconds to write a heartbeat file. Set to 0 to disable.
+# This is used primarily for Docker healthchecks.
+heartbeatInterval: 0
 # -- SSL options --
 ssl:
   # Enable SSL/TLS encryption
@@ -68,6 +71,25 @@ basicAuthUser:
   password: "password"
 # Enables CORS proxy middleware
 enableCorsProxy: false
+# CORS settings (applied to all routes)
+cors:
+  # Enable or disable CORS middleware
+  enabled: true
+  # Allowed origins. Use "null" to match the default browser file origin.
+  # You can set "*" to allow any origin, or a list of allowed origins.
+  origin:
+    - "null"
+  # Allowed methods
+  methods:
+    - "OPTIONS"
+  # Allowed request headers (optional)
+  allowedHeaders: []
+  # Exposed response headers (optional)
+  exposedHeaders: []
+  # Allow credentials (cookies, authorization headers)
+  credentials: false
+  # Preflight cache max age in seconds (optional)
+  maxAge: null
 # -- REQUEST PROXY CONFIGURATION --
 requestProxy:
   # If a proxy is enabled, all outgoing HTTP/HTTPS requests will be routed through it.
@@ -200,7 +222,6 @@ 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:
@@ -265,7 +286,7 @@ ollama:
 # -- ANTHROPIC CLAUDE API CONFIGURATION --
 claude:
   # Enables caching of the system prompt (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 only when the prompt before the chat history is static and doesn't change between requests
   # (e.g {{random}} macro or lorebooks not as in-chat injections).
@@ -287,6 +308,18 @@ claude:
 gemini:
   # API endpoint version ("v1beta" or "v1alpha")
   apiVersion: 'v1beta'
+  # Adds thought signatures to requests (if available). Only for Gemini 3 and above.
+  thoughtSignatures: true
+  # Enables caching of the system prompt (if supported). Only for OpenRouter.
+  # -- IMPORTANT! --
+  # Use only when the prompt before the chat history is static and doesn't change between requests
+  # (e.g {{random}} macro or lorebooks not as in-chat injections).
+  # Otherwise, you'll just waste money on cache misses.
+  enableSystemPromptCache: false
+  # https://ai.google.dev/gemini-api/docs/imagen#imagen-configuration
+  image:
+    # Leave empty to use the API-default value.
+    personGeneration: 'allow_adult'
 # -- SERVER PLUGIN CONFIGURATION --
 enableServerPlugins: false
 # Attempt to automatically update server plugins on startup

package/default/config.yaml

@@ -38,6 +38,9 @@ browserLaunch:
   avoidLocalhost: false
 # Server port
 port: 8000
+# Interval in seconds to write a heartbeat file. Set to 0 to disable.
+# This is used primarily for Docker healthchecks.
+heartbeatInterval: 0
 # -- SSL options --
 ssl:
   # Enable SSL/TLS encryption
@@ -68,6 +71,25 @@ basicAuthUser:
   password: "password"
 # Enables CORS proxy middleware
 enableCorsProxy: false
+# CORS settings (applied to all routes)
+cors:
+  # Enable or disable CORS middleware
+  enabled: true
+  # Allowed origins. Use "null" to match the default browser file origin.
+  # You can set "*" to allow any origin, or a list of allowed origins.
+  origin:
+    - "null"
+  # Allowed methods
+  methods:
+    - "OPTIONS"
+  # Allowed request headers (optional)
+  allowedHeaders: []
+  # Exposed response headers (optional)
+  exposedHeaders: []
+  # Allow credentials (cookies, authorization headers)
+  credentials: false
+  # Preflight cache max age in seconds (optional)
+  maxAge: null
 # -- REQUEST PROXY CONFIGURATION --
 requestProxy:
   # If a proxy is enabled, all outgoing HTTP/HTTPS requests will be routed through it.
@@ -200,7 +222,6 @@ 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:
@@ -265,7 +286,7 @@ ollama:
 # -- ANTHROPIC CLAUDE API CONFIGURATION --
 claude:
   # Enables caching of the system prompt (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 only when the prompt before the chat history is static and doesn't change between requests
   # (e.g {{random}} macro or lorebooks not as in-chat injections).
@@ -287,6 +308,18 @@ claude:
 gemini:
   # API endpoint version ("v1beta" or "v1alpha")
   apiVersion: 'v1beta'
+  # Adds thought signatures to requests (if available). Only for Gemini 3 and above.
+  thoughtSignatures: true
+  # Enables caching of the system prompt (if supported). Only for OpenRouter.
+  # -- IMPORTANT! --
+  # Use only when the prompt before the chat history is static and doesn't change between requests
+  # (e.g {{random}} macro or lorebooks not as in-chat injections).
+  # Otherwise, you'll just waste money on cache misses.
+  enableSystemPromptCache: false
+  # https://ai.google.dev/gemini-api/docs/imagen#imagen-configuration
+  image:
+    # Leave empty to use the API-default value.
+    personGeneration: 'allow_adult'
 # -- SERVER PLUGIN CONFIGURATION --
 enableServerPlugins: false
 # Attempt to automatically update server plugins on startup

package/default/content/index.json

@@ -139,98 +139,18 @@
         "filename": "Char_Avatar_Comfy_Workflow.json",
         "type": "workflow"
     },
-    {
-        "filename": "presets/kobold/Ace of Spades.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Basic Coherence.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Best Guess.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Coherent Creativity.json",
-        "type": "kobold_preset"
-    },
     {
         "filename": "presets/kobold/Deterministic.json",
         "type": "kobold_preset"
     },
     {
-        "filename": "presets/kobold/Genesis.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Godlike.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Good Winds.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Liminal Drift.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Low Rider.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Luna Moth.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Mayday.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Miro Bronze.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Miro Gold.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Miro Silver.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Ouroboros.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Pleasing Results.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Pro Writer.json",
+        "filename": "presets/kobold/Neutral.json",
         "type": "kobold_preset"
     },
     {
         "filename": "presets/kobold/RecoveredRuins.json",
         "type": "kobold_preset"
     },
-    {
-        "filename": "presets/kobold/Space Alien.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Storywriter.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/TFS-with-Top-A.json",
-        "type": "kobold_preset"
-    },
-    {
-        "filename": "presets/kobold/Titanic.json",
-        "type": "kobold_preset"
-    },
     {
         "filename": "presets/kobold/Universal-Creative.json",
         "type": "kobold_preset"
@@ -243,10 +163,6 @@
         "filename": "presets/kobold/Universal-Super-Creative.json",
         "type": "kobold_preset"
     },
-    {
-        "filename": "presets/kobold/simple-proxy-for-tavern.json",
-        "type": "kobold_preset"
-    },
     {
         "filename": "presets/novel/Asper-Kayra.json",
         "type": "novel_preset"
@@ -343,22 +259,6 @@
         "filename": "presets/novel/Erato-Zany Scribe.json",
         "type": "novel_preset"
     },
-    {
-        "filename": "presets/textgen/Asterism.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Beam Search.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Big O.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Contrastive Search.json",
-        "type": "textgen_preset"
-    },
     {
         "filename": "presets/textgen/Default.json",
         "type": "textgen_preset"
@@ -368,99 +268,7 @@
         "type": "textgen_preset"
     },
     {
-        "filename": "presets/textgen/Divine Intellect.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Kobold (Godlike).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Kobold (Liminal Drift).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/LLaMa-Precise.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Midnight Enigma.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Miro Bronze.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Miro Gold.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Miro Silver.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Mirostat.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Naive.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Best Guess).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Decadence).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Genesis).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Lycaenidae).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Ouroboros).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Pleasing Results).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Sphinx Moth).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/NovelAI (Storywriter).json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Shortwave.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Simple-1.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Space Alien.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/StarChat.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/TFS-with-Top-A.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/Titanic.json",
+        "filename": "presets/textgen/Neutral.json",
         "type": "textgen_preset"
     },
     {
@@ -475,14 +283,6 @@
         "filename": "presets/textgen/Universal-Super-Creative.json",
         "type": "textgen_preset"
     },
-    {
-        "filename": "presets/textgen/Yara.json",
-        "type": "textgen_preset"
-    },
-    {
-        "filename": "presets/textgen/simple-proxy-for-tavern.json",
-        "type": "textgen_preset"
-    },
     {
         "filename": "presets/openai/Default.json",
         "type": "openai_preset"
@@ -507,14 +307,6 @@
         "filename": "presets/context/Default.json",
         "type": "context"
     },
-    {
-        "filename": "presets/context/DreamGen Role-Play V1 ChatML.json",
-        "type": "context"
-    },
-    {
-        "filename": "presets/context/DreamGen Role-Play V1 Llama3.json",
-        "type": "context"
-    },
     {
         "filename": "presets/context/Libra-32B.json",
         "type": "context"
@@ -587,14 +379,6 @@
         "filename": "presets/instruct/ChatML.json",
         "type": "instruct"
     },
-    {
-        "filename": "presets/instruct/DreamGen Role-Play V1 ChatML.json",
-        "type": "instruct"
-    },
-    {
-        "filename": "presets/instruct/DreamGen Role-Play V1 Llama3.json",
-        "type": "instruct"
-    },
     {
         "filename": "presets/instruct/Koala.json",
         "type": "instruct"