Macros 2.0 (v0.3) - Replacing the existing Macro System with a new Macro Engine (#4820) * Chevrotain lib and env setup * First draft of the macro lexer * fix ESLint types loading for chevrotain * Cleaner lexer modes * Readme link to Chevrotain & license * Add jsconfig to tests folder - Add jsconfig.json to tests folder, to prevent IDE errors on dynamic imports inside the page.evaluate execution. * Slight improvements on lexer & first tests * Add more lexer tests * More edge cases tests * Reorder tests * Add macro execution modifiers + more tests - Added macro flags (execution modifiers) to lexer - Fixed some lexing issues - Expanded lexer tests - Treat lexer errors as failed test * enable eslint for tests and run it * Fix lexing unknown flags - treat as error * Rewrote lexer modes/tokes to capture errors better * Add lexing for output modifiers * Clearer names for lexer tokens * Increase tests default timeout * Restructure lexer error testcases * Allow legacy underscores in macro identifiers * Test case for legacy single-colon syntax * Improve lexer, removing warnings * Basic setup for MacroParser + initial tests * Make parser errors testable * Add macros stuff to SillyTavern.getContext * macros test case naming + lint * Parser consumes basic macros - Fix lexer mode names - Add basic macro parsing (identifier, and arguments) - Tests: basic macro parsing tests - Tests: simplifyCstNode supports ignoring nodes, or flattening nodes to just plaintext * Improve macro argument parsing to allow colons in values Enhances separator handling by fixing separator type detection and enabling colon characters within argument values Updates validation to require at least one argument component and adds error cases for empty arguments Includes expanded test coverage for mixed separator scenarios and edge cases * More nested macro tests Add error case tests to enforce macro start position requirements Include nested macro parsing scenarios and invalid syntax checks Ensures parser correctly handles edge cases with embedded macros * Unvendor chevrotain * Add document rule * Implement visitor, switch built-ins to new type * Puppeteer -> playwright * Revert "Implement visitor, switch built-ins to new type" This reverts commit 706a94b4de62129df6bd6c25e2c6dec692d12226. * Converted puppeteeer tests * File rename * chore: reduce Playwright worker count to 4 for performance/stability * test: add comprehensive legacy macro parser test suite - Added 13 test cases covering legacy macro formats (roll, reverse, comment, datetime, time_UTC, banned, setvar) - Documented parser limitations with TODO comments for whitespace separators, special characters, and empty arguments - Tests validate parsing of various separator styles (space, colon, +/-) and argument formats (quoted, numeric, empty) * fix: handle legacy macro syntax with colon or whitespace separator - Modified arguments rule to support both double-colon (::) and single-colon (:) separators - Made single-colon separator optional to allow whitespace-separated legacy macros - Removed TODO comments as parser now correctly handles legacy macro formats * feat: support space-separated quoted arguments in macro parser - Added parsing support for equals signs and quotes as valid argument tokens - Removed TODO comments for legacy macro parsing with quoted arguments * fix: improves macro argument parsing with colon handling Enhances parser to correctly handle double colons within legacy single-colon arguments Introduces separate parsing rules for arguments with different colon constraints Adds test coverage for arguments containing double colons in legacy format * fix: allow empty macro arguments after double-colon separator - Changed argument rule from AT_LEAST_ONE to MANY to permit zero-length arguments - Updated tests to verify empty argument parsing (e.g., `{{something::}}`) - Enhanced simplifyCstNode helper with default flatten/ignore keys and improved null handling * refactor: improve test documentation with inline macro display - Added inline comments showing the actual macro syntax being tested for better readability - Removed duplicate comment in error test case - Cleaned up extra whitespace in legacy macro tests * feat: add legacy macro preprocessing for time offset format - Implemented preProcessFixLegacyMacros method to convert {{time_UTC±N}} to {{time::UTC±N}} format - Updated tests to use new preprocessing step for legacy time macro parsing - Added runPreProcessFix option to test helper functions for controlled legacy macro handling * feat: add support for comment macros with double-slash syntax - Added `DoubleSlash` token to lexer to recognize `//` as a valid macro identifier - Updated parser to accept either `//` or standard identifiers as macro names - Enhanced test suite with comprehensive comment macro test cases including multiline support * feat: implement macro evaluation engine with CST walking and registry integration (I'm tired, let's just throw this in right now) - Added CST walker and macro registry to engine initialization - Enhanced parseDocument to handle empty input, legacy macro preprocessing, and error collection - Implemented async evaluate method with full macro resolution pipeline - Added resolveMacro callback to handle unknown macros and registry execution - Integrated lexing/parsing error handling with console warnings - Added support for preserving unknown macro * refactor: improve type safety and code clarity in macro evaluation system - Simplified typedef imports to use correct Chevrotain types (CstNode, IToken) - Added TokenRange typedef for consistent offset handling - Enhanced error messages with context-specific prefixes - Replaced verbose type casts with inline JSDoc annotations - Condensed singleton pattern declarations to single lines - Improved null safety with optional chaining and nullish coalescing - Extracted resolveMacro logic into private root function * fix test macro whitespace arguments onls accepting one argument * Fix OpenRouter embeddings URL #4736 * Fix: Prevent data loss on bulk regex move to scoped scripts (#4760) * Fix: Prevent data loss in regex bulk move * prevents moving to scoped scripts with group selected for bulkedit * Refactor: make whitelist validation a bit more robust (#4757) * refactor: extract IP whitelist validation into helper function - Added isIPInWhitelist helper with error handling for individual whitelist entry checks - Replaced inline whitelist matching logic with reusable function calls - Added JSDoc type annotations and error logging for failed IP matching attempts * refactor: simplify whitelist validation with upfront filtering - Moved IP validation to startup time instead of per-request checking - Extracted validateWhitelist function to filter invalid entries once at initialization - Simplified isIPInWhitelist by removing redundant error handling after validation * fix: correct IP whitelist matching to use parsed CIDR notation * Feat: Improve multiline input handling in popups (#4756) * feat: improve multiline input handling in popups - Added Ctrl+Enter requirement for submission in multiline input popups to prevent accidental sends - Exported PopupUtils class for external use * refactor: remove redundant higher/different rows from input popups - Removed rows: 2 from callGenericPopup calls where default behavior is sufficient - Increased rows from 2 to 4 in caption extension for better multiline input experience * Fix npm audit * feat: add max-height and scrolling to world entry key input fields (#4769) - Added 160px max-height to select2 multiple selection, primary key, and secondary key text areas in world entries - Enabled vertical scrolling with hidden horizontal overflow for better UX with long content * Bump anti-troll tags limit Closes #4763 * OpenAI: Add Sora 2 API (#4748) * OpenAI: Add Sora 2 API * Add duration control * Support client generation abort * Reduce poll log amount * Simplify selector * Simplify model-specific control handling * Gemini: Pass non-success response content to frontend * Vertex: Add Vertex AI-specific safety setting (#4770) Closes #4455 * Feature: allows sorting tags by most used (#4768) * add sorting tags by most used * Fix whitespaces * Code review updates * Remove commented code * Fix capitalization in comment * Apply review suggestion * Simplify template init * Reformat * Add documentation for appendViewTagToList and printViewTagList functions * Reprint renamed tags regardless of sorting mode --------- Co-authored-by: Cohee <18619528+Cohee1207@users.noreply.github.com> * Move img.swipe notice block up * Preserve media playback state when running appendMediaToMessage (#4771) * Preserve media playback state when running appendMediaToMessage * Better selector specificity * Fix local variable name * Move typedef to global.d.ts * Check for readyState on save/restore * Only check for currentSrc on restoration callback * gpt-5.1 * A 500 billion dollar startup can’t filter API payload fields * Refactor macro argument validation to use requiredArgs and list pattern - Replace minArgs/maxArgs/enforceArity with requiredArgs and list specification - Add MacroListSpec typedef for flexible list argument constraints (min/max) - Rename enforceArity to strictArgs with inverted default behavior - Update validation logic to separately track required vs. list arguments - Add requiredArgs and list arrays to MacroExecutionContext for easier access - Improve error messages to clearly distinguish between required and list * Refactor MacroRegistry.registerMacro to use options object pattern - Move handler function into options object as required property - Improve validation with detailed error messages for all option fields - Add explicit type checking for requiredArgs, list, strictArgs, and description - Consolidate name normalization and validation logic - Simplify list option parsing with clearer conditional structure - Update all builtin macro registrations to use new signature * Add e2e tests for macro arity validation errors - Test ping macro rejects calls with unexpected arguments - Test upper macro rejects calls without required arguments - Verify macros remain unresolved and log warnings on arity violations * re-implement core macros as registered macros - Create shallow frozen copy of env object before passing to macro handlers - Add comprehensive MacroEnv typedef with nested types for names, character, system, and extra fields - Update MacroDefinitionOptions typedef to clarify default values and mark handler as required - Export variable manipulation functions for external use - Fix whitespace in ifCallback JSDoc comment * Defer slash command autocomplete initialization to firstLoadInit - Move slash command autocomplete setup from module-level to initSlashCommandAutoComplete function - Add null check for sendTextarea.value before accessing first character - Import and call initSlashCommandAutoComplete in firstLoadInit sequence - Export registerCoreMacros, registerInstructMacros, and registerVariableMacros using named export syntax - Call registerCoreMacros from initMacros with * Add variable manipulation functions to SillyTavern context API - Import deleteGlobalVariable, deleteLocalVariable, addGlobalVariable, addLocalVariable, incrementGlobalVariable, incrementLocalVariable, decrementGlobalVariable, and decrementLocalVariable from variables.js - Expose del, add, inc, and dec methods on both context.variables.local and context.variables.global objects - Provide consistent API for variable deletion, addition, increment, and decrement operations * Extract test setup utilities and fix trailing comma in core-macros.js - Add testSetup utility object with goST and awaitST helper functions for Playwright tests - Replace duplicated beforeEach setup code in MacroLexer, MacroParser, and MacroRegistry tests with testSetup.goST - Add explanatory comments indicating tests currently run without ST context - Fix missing trailing comma in input macro handler registration * Refactor MacroEngine e2e tests to use real core macros instead of prototypes - Replace prototype macros (ping, echo, upper, wrap, first) with actual core macros (newline, reverse, setvar, getvar, addvar, roll) - Use testSetup.awaitST helper from utils.js for beforeEach setup - Increase test timeout from 10s to 20s due to additional setup requirements - Remove registerPrototypeMacros import and registration logic from evaluateWithEngine - Add page.waitForTimeout(1000) to ensure macros are fully initialize - Remove now obsolete MacroBuiltins.js * Fix audit in tests * Rename frontend test utils file to frontent-test-utils.js and update imports - Rename tests/frontend/utils.js to tests/frontend/frontent-test-utils.js - Update testSetup imports across MacroEngine, MacroLexer, MacroParser, and MacroRegistry e2e tests * Refactor MacroRegistry for improved readability and consistency - Reorder MacroDefinition typedef fields to match registration order (handler moved to end) - Add inline JSDoc comments to MacroDefinitionOptions properties for clarity - Simplify name validation logic in unregisterMacro, hasMacro, and getMacro methods using early returns - Extract argument validation logic into dedicated isArgsValid helper function - Refactor executeMacro to be async and use Promise.resolve for consistent promise handling * Add returns field to MacroDefinitionOptions for documenting macro return values - Add returns property to MacroDefinitionOptions typedef with string type and null default - Include returns field in MacroDefinition typedef - Store returns value in macro definition object for documentation purposes * Add error handling to macro execution and refactor core macro handlers - Add catch handler in MacroRegistry.executeMacro to log errors and return empty string on handler failures - Update macro descriptions to use "index" instead of "ID" for message position macros - Simplify reverse macro description and remove redundant null coalescing - Add strictArgs: false to comment macro to ensure it's always removed - Enhance time macro description with UTC offset examples - Remove unnecessary null check * Refactor instruct-macros.js for consistency and reduce code duplication - Rename enabled helper to instEnabled and add sysEnabled helper for clarity - Consolidate defaultSystemPrompt, instructSystem, and instructSystemPrompt into single registerSimple call - Simplify systemPrompt handler by removing unnecessary null coalescing and intermediate variables - Convert chatSeparator and chatStart macros to use registerSimple helper - Fix JSDoc comment formatting for registerSimple helper function * Add normalize helper to MacroExecutionContext and refactor variable macros for consistency - Add normalizeMacroResult method to MacroEngine for converting macro results to strings - Include normalize function in MacroExecutionContext for handler use - Update normalizeMacroResult to handle arrays explicitly alongside objects - Add returns field to variable macros that produce side-effects only - Refactor variable macro handlers to use destructuring and normalize helper - Remove redundant null checks an * chore: Remove duplicate getglobalvar macro registration from variable-macros.js - Remove redundant getglobalvar macro definition (already registered earlier in the file) - Import MacroEngine in MacroRegistry for normalizeMacroResult access - Add fallback binding for normalize in MacroExecutionContext when not provided by caller - Update executeMacro to use executionContext.normalize instead of standalone normalizeMacroResult - Remove normalizeMacroResult helper function from MacroRegistry (now handled by MacroEngine) * Add core environment macros for names, character fields, system info, and deterministic pick - Add lastGenerationType tracking with event listeners for GENERATION_STARTED and CHAT_CHANGED - Add ensureLastGenerationTypeTracking helper to initialize event listeners once - Register name macros: user, char, group, groupNotMuted, notChar, charIfNotGroup - Register character card field macros: charPrompt, charInstruction, description, personality, scenario, persona, mesExamplesRaw, charDepthPrompt, cre * Refactor core macros into separate modules by category (env, state, chat, time) - Move name and character card field macros to new env-macros.js module - Move system/device/runtime state macros to new state-macros.js module - Move chat inspection macros (lastMessage, lastMessageId, etc.) to new chat-macros.js module - Move time/date macros (time, date, weekday, isotime, etc.) to new time-macros.js module - Remove lastGenerationType tracking logic and helper functions from core-macros.js (moved to state * Reorganize macro system into engine and definitions directories - Move macro engine components (MacroEngine, MacroRegistry, MacroLexer, MacroParser, MacroCstWalker) to macros/engine/ subdirectory - Move macro definition modules (core-macros, env-macros, state-macros, chat-macros, time-macros, variable-macros, instruct-macros) to macros/definitions/ subdirectory - Create macro-system.js as central entry point that exports engine singletons and initRegisterMacros function - Refactor variable-macros.js to use S * Export getGeneratingModel function and add MacroEnvBuilder to macro system exports - Export getGeneratingModel function from script.js for external use - Import MacroEnvBuilder in macro-system.js - Add envBuilder singleton to macros export object alongside existing engine components * Extract MacroEnv typedefs into separate MacroEnv.types.js file - Create MacroEnv.types.js with MacroEnv, MacroEnvNames, MacroEnvCharacter, and MacroEnvSystem typedefs - Remove MacroEnv typedef definitions from MacroRegistry.js - Update MacroRegistry.js, MacroEngine.js, MacroEnvBuilder.js, and env-macros.js to import MacroEnv from MacroEnv.types.js - Change MacroEngine.evaluate env parameter type from any to optional MacroEnv * Add comprehensive e2e tests for MacroEnvBuilder - Create MacroEnvBuilder.e2e.js with 13 test cases validating environment construction - Test name override precedence (overrides vs global fallback) - Test character field population based on replaceCharacterCard flag - Test original value one-shot helper function behavior - Test group override string propagation to group/group * Add substituteParamsAsync function with experimental macro engine support - Create substituteParamsAsync function in script.js as async alternative to substituteParams - Use object destructuring pattern for function parameters following RO-RO convention - Add experimental_macro_engine flag to power_user settings for feature gating - Add MacroEnvFunctions typedef with original and postProcess function types to MacroEnv.types.js - Add functions property to MacroEnv typedef for one-shot helpers an * Add dynamic macro support to MacroEngine with environment-based override and postProcess execution - Add defOverride parameter to MacroRegistry.executeMacro for temporary macro definitions - Check env.dynamicMacros in MacroEngine#resolveMacro and create temporary macro definition when found - Set strictArgs to true for dynamic macros to fail if called with arguments - Execute env.functions.postProcess on macro results in MacroEngine#resolveMacro with error handling - Update MacroEnv typedef to make * Refactor macro handlers to assume non-null env and remove optional chaining - Remove optional chaining (?.) from env property access in env-macros.js and instruct-macros.js - Change MacroExecutionContext env property from optional to required in MacroRegistry.js - Update executeMacro context parameter from optional to required - Simplify original macro handler to call env.functions.original() directly without try-catch - Update MacroHandler typedef to use arrow function syntax for consistency - Remove redundant null checks an * Refactor MacroRegistry.executeMacro to accept MacroCall object and make MacroExecutionContext properties non-optional - Change executeMacro to accept MacroCall object instead of separate name and context parameters - Move normalize function from context parameter to options object in executeMacro - Construct MacroExecutionContext from MacroCall properties within executeMacro - Set namedArgs to null in executionContext (currently unused) - Update MacroEngine.resolveMacro to pass MacroCall directly * Remove normalize parameter from MacroRegistry.executeMacro and bind normalizeMacroResult directly in execution context - Remove normalize parameter from executeMacro options object in MacroRegistry.js - Bind MacroEngine.normalizeMacroResult directly in executionContext instead of accepting override - Remove normalize option from MacroEngine.resolveMacro call to executeMacro - Add missing name fields (group, groupNotMuted, notChar) to MacroEnvBuilder default env object * Make MacroEnvRawContext properties optional and change original function from required to optional in MacroEnvFunctions - Change MacroEnvRawContext properties from required to optional with null defaults - Change original function from required to optional in MacroEnvFunctions typedef - Remove original function from default env object in MacroEnvBuilder (only include when provided) * Refactor MacroEnvBuilder tests to use optional properties and add macro arity validation tests - Remove explicit undefined/false assignments from MacroEnvRawContext test objects (now optional with defaults) - Rename additionalMacro to dynamicMacros in MacroEnvBuilder tests and update property access from env.extra to env.dynamicMacros - Move original function from env.extra to env.functions in test assertions - Remove test for additionalMacro overriding original helper (no longer applicable with * Improve macro error handling with dedicated diagnostics and runtime error propagation - Import and use logMacroInternalError and logMacroRuntimeWarning from MacroDiagnostics in MacroEngine - Wrap MacroRegistry.executeMacro call in try-catch to distinguish runtime vs internal errors - Nest postProcess execution in inner try-catch with dedicated error logging - Return raw macro syntax on execution failure instead of empty string - Replace console.warn with logMacroRuntimeWarning for argument count * Add macro argument type validation with positional argument definitions and runtime type checking - Add MacroArgType and MacroPositionalArgDef typedefs for argument metadata - Change requiredArgs option to accept number or MacroPositionalArgDef[] array - Add requiredArgDefs property to MacroDefinition to store normalized argument definitions - Validate requiredArgs array elements during macro registration (name, description, type fields) - Generate default argument definitions when requiredArgs is a * Add e2e tests for macro type validation and dynamic macro strict arity enforcement - Add test verifying strict typed macros fail resolution when argument type is invalid - Add test verifying non-strict typed macros execute with invalid types but log warnings - Add test verifying dynamic macros reject arguments due to strictArgs enforcement - Capture and assert runtime warning messages for type validation and arity violations - Register test macros with integer type requirements and varying strict * Add mesExamples macro with instruct mode formatting support - Register mesExamples macro in env-macros.js to format dialogue examples - Import parseMesExamples, main_api, power_user, and formatInstructModeExamples - Check instruct mode enabled state and main_api to determine formatting path - Parse raw examples using parseMesExamples with instruct mode flag - Return empty string when raw examples are missing or parsed result is empty - Format examples using formatInstructModeExamples when instruct mode is active * Add URL navigation wait in test setup and increase Playwright worker count to 4 - Add waitForURL check after user selection in awaitST to ensure navigation completes before preloader check - Increase Playwright workers from 1 to 4 for parallel test execution * Add e2e tests for multi-line macro arguments and comment macro functionality - Add test verifying reverse macro handles multi-line arguments with newline characters - Add test verifying comment macro removes single-line comments with simple body - Add test verifying comment macro accepts non-word characters immediately after // - Add test verifying comment macro ignores additional // sequences inside comment body - Add test verifying comment macro supports multi-line comment bodies * Standardize JSDoc type annotations to use explicit null defaults and union types instead of nullable shorthand * Remove individual test timeout configurations from frontend macro test files * Add positional argument definitions with sample values and descriptions to core, env, and time macros - Add sampleValue field to MacroPositionalArgDef typedef (optional string) - Replace numeric requiredArgs with positional argument definition arrays in roll, banned, outlet, datetimeformat, and timeDiff macros - Include name, sampleValue, description, and type fields for each positional argument - Update timeDiff description to clarify absolute difference calculation - Remove unnecessary blank lines in * Remove async/await from macro engine evaluation and convert all macro handlers to synchronous execution Makes me sad, but such is life * Refactor substituteParams to use options object signature with backward compatibility for legacy positional arguments - Rename original substituteParams to substituteParamsLegacy with unchanged positional argument signature - Rename substituteParamsNew to substituteParams as the new primary function - Add automatic detection and routing of legacy positional argument calls to substituteParamsLegacy - Update substituteParamsExtended to use new options object signature and mark as deprecated * forgor * fix missing import, and package-lock, finally. Maybe. * Add experimental macro engine toggle to UI settings - Add experimental_macro_engine setting to default settings.json - Move experimental_macro_engine property to correct position in power_user object (with other experimental settings) - Add checkbox UI control in settings panel with flask icon and tooltip explaining nested macro resolution and logical replacement order - Wire up checkbox event handler to save experimental_macro_engine setting - Load experimental_macro_engine state on settings initialization * Refactor macro pre/post-processing from parser to engine and improve error handling - Move legacy macro pre-processing (time_UTC format) from MacroParser to MacroEngine #runPreProcessors - Move trim macro post-processing to MacroEngine #runPostProcessors to handle cross-boundary behavior - Remove MacroLexer import from MacroEngine (now handled by MacroParser.parseDocument) - Update MacroParser.parseDocument to return separate lexingErrors and parserErrors arrays * Add {{trim}} macro placeholder that defers to post-processing for cross-boundary whitespace handling * Add eslint-plugin-playwright * Add logMacroSyntaxWarning function for structured lexer/parser error reporting with compact human-readable payload * Small code review fixes - import event types from events.js - Add chained fallback to {{input}}, just to be safe - switched variables.js to export-per-method - minor text adjustments in registered macro docs * fix lexer not capturing linebreaks correctly & simplify plaintext token - Replace alternation-based pattern with negated character class approach - Use `(?:[^{]|\{(?!\{))+` to match non-brace chars or single braces not followed by another brace - Add unicode flag for consistency - Update comment to clarify intent: consume anything that is not the start of a macro '{{' * Skip macro processing on char/group fields for env build (performance) - Add returnRaw parameter to getCharacterCardFields to optionally return raw values without baseChatReplace - Add returnRaw parameter to getGroupCharacterCards for consistent raw value handling - Replace direct baseChatReplace calls with conditional transform function based on returnRaw flag - Apply collapseNewlines when returnRaw is true and collapse_newlines setting is enabled - Update MacroEnvBuilder to use the returnRaw as true * Fix lexer failing to handle literal '{' before macro openers - Add PlaintextOpenBrace token to lexer with pattern `/\{(?=\{\{)/` to match single '{' immediately before '{{' - Update lexer mode definition to consume PlaintextOpenBrace before attempting macro start - Update parser document rule to handle PlaintextOpenBrace as alternative to Plaintext - Update MacroCstWalker to collect both Plaintext and Plaintext.OpenBrace tokens when building document items * Add legacy non-curly marker pre-processing (<USER>, <BOT>, <CHAR>, <GROUP>, <CHARIFNOTGROUP>) - Add pre-processing step in MacroEngine to rewrite legacy angle-bracket markers into their curly-brace macro equivalents - Map <USER> → {{user}}, <BOT> → {{char}}, <CHAR> → {{char}}, <GROUP> → {{group}}, <CHARIFNOTGROUP> → {{charIfNotGroup}} - Add e2e tests verifying legacy marker resolution through the engine pipeline - Tests cover <USER>, <BOT>/<CHAR>, and <GROUP>/<CHARIFNOTGROUP> markers * Add env.content to MacroEnv and use it for deterministic {{pick}} hashing - Add content property to MacroEnv type definition and MacroEnvBuilder to expose the full original input string - Update {{pick}} macro handler to use env.content hash instead of rawListString hash for seed generation - Ensures deterministic behavior when the same prompt position contains different list items across evaluations - Prevents {{pick}} from returning different values when nested macros resolve to different intermediate * add e2e tests for env.content exposure and deterministic {{pick}} behavior - Rename getChatIdHashCore → getChatIdHash in core-macros.js for consistency - Add e2e test verifying env.content is exposed to macro handlers - Add e2e test confirming {{pick}} returns stable results for same chat and content - Tests verify deterministic behavior by comparing multiple evaluations with fixed chat_id_hash * Rename chat macro helper functions to remove 'Core' suffix for consistency * Add MacrosParser deprecation warnings and bridge to new macro engine when experimental flag enabled - Import macroSystem and power_user for experimental macro engine integration - Add @deprecated JSDoc tag to MacrosParser class - Add #logDeprecated helper to warn about deprecated MacrosParser methods - Add #registerMacroInNewEngine to bridge legacy macro registrations into new engine - Add #unregisterMacroInNewEngine to bridge legacy macro unregistrations - Log deprecation warnings in get, has, register * Fix lint in tests * Add comprehensive bracket handling tests and improve macro lexer/parser resilience to invalid syntax - Add logMacroGeneralError function for non-macro-specific error logging - Add CST validation check in MacroEngine to return original input if parser produces invalid CST - Wrap MacroCstWalker.evaluateDocument in try-catch to gracefully handle evaluation failures - Update MacroLexer Unknown token pattern to capture single closing braces not followed by another closing brace - Add fallback mode exit * Add error recovery for incomplete macros by flattening them to plaintext while preserving nested complete macros - Enable Chevrotain error recovery in MacroParser constructor - Add #isRecoveryToken helper to detect tokens inserted during error recovery - Add #flattenIncompleteMacro to recursively convert incomplete macro nodes into plaintext items - Update #collectDocumentItems to detect recovery-inserted Macro.End tokens and flatten incomplete macros - Simplify plaintext token collection to use * Add e2e test verifying nested macros resolve even when outer macro has invalid argument count * Remove unused macro CST node caching mechanism from MacroCstWalker * Add JSDoc type re-exports and register shorthand to macro-system.js for improved DX - Re-export commonly used JSDoc types from MacroRegistry and MacroEnv modules for easier consumption by external code - Add macros.register shorthand function bound to MacroRegistry.registerMacro for convenient macro registration - Includes MacroDefinitionOptions, MacroHandler, MacroEnv, and related type definitions * Migrate legacy macro registrations to new macro system API across multiple modules - Replace MacrosParser.registerMacro calls with macros.register using object-based configuration - Update imports from './macros.js' to './macros/macro-system.js' - Extract macro registration into dedicated registerAuthorsNoteMacros function in authors-note.js - Add descriptions to all macro registrations for better documentation - Update MacrosParser iterator to yield from new registry when experimental engine is enabled * Add MacroCategory to all macro registrations across codebase for improved organization and discoverability - Import MacroCategory from macro-system.js in authors-note.js, memory/index.js, stable-diffusion/index.js, and macros.js - Add category property to all macro registrations using appropriate MacroCategory values - Assign 'legacy' category to MacrosParser auto-registered macros - Categorize macros across chat, character, prompts, utility, random, state, time, and names categories * fix lint * Add MacroBrowser UI component and integrate macro help system into chat interface - Add implementation of MacroBrowser - Add macros.css stylesheet link to index.html - Update core-macros.js ban macro to return empty string instead of 'Empty string' description - Add sampleValue property to positional argument definitions in MacroRegistry - Generate default sampleValue for numeric requiredArgs using 'arg{n}' pattern - Set default description to '<no description>' and returns to '<empty string>' when empty * Reorder JSDoc typedef declarations in MacroRegistry.js to have the most relevant first * fix missing category in legacy initMacros * Add displayOverride and exampleUsage properties to macro registration system - Add displayOverride property to MacroDefinitionOptions for custom signature display - Add exampleUsage property to MacroDefinitionOptions for documentation examples - Update MacroRegistry.registerMacro to validate and process displayOverride and exampleUsage - Add logMacroRegisterWarning function to MacroDiagnostics for registration-time warnings - Auto-wrap displayOverride and exampleUsage in curly braces if missing * Add error handling to MacroRegistry.registerMacro and logMacroRegisterError diagnostic function - Add logMacroRegisterError function to MacroDiagnostics for registration failures - Wrap MacroRegistry.registerMacro body in try-catch to handle registration errors gracefully - Change registerMacro return type from MacroDefinition to MacroDefinition|null - Log registration errors and return null instead of throwing, preventing macro registration failures from breaking the application * Optimize character card field access with lazy evaluation to improve macro execution performance * Add brace unescaping to MacroEngine post-processing to support literal curly braces in macro output - Add regex replacement to unescape \{ and \} to { and } after macro execution - Allows users to output literal braces by escaping them with backslashes - Escaped sequences like \{\{ don't match MacroStart pattern and pass through as plain text * Add alias system to macro registry with UI support for displaying and navigating macro aliases - Add `aliases` property to MacroDefinitionOptions for defining alternative macro names - Add `aliasOf` and `aliasVisible` properties to MacroDefinition to track alias relationships - Update MacroRegistry.registerMacro to create alias entries pointing to primary definitions - Add `getPrimaryMacro` method to retrieve primary definition from alias names - Add filtering options to `getAllMacros` to exclude aliases * Strip curly braces from MacroBrowser search query to match macro name format in search definitions * Add enhanced macro autocomplete with argument hints and context-aware suggestions - Add comprehensive CSS styling for enhanced macro autocomplete items with flex layout - Add argument hint banner styling with gradient background and border - Add current argument highlighting in details panel - Export formatMacroSignature, createSourceIndicator, createAliasIndicator, and createTypeBadge from MacroBrowser for reuse * Fix macro autocomplete not showing details/arguments because of trailing colons * Change macro details CSS selectors from `.macroBrowser` to `.macro-details` for better reusability and update autocomplete to use macro enum icon - Replace all `.macroBrowser` selectors with `.macro-details` in macros.css to allow macro details panel styling to work outside MacroBrowser context - Change autocomplete option icon from hardcoded '{}' to `enumIcons.macro` for consistency - Remove redundant `showCategory: false` option from renderMacroDetails call in autocomplete (now handled by default * Add MacroArgType enum to replace string literal type union for macro argument types - Add MacroArgType enum with STRING, INTEGER, NUMBER, and BOOLEAN values - Replace MacroArgType typedef string literal union with enum reference - Export MacroArgType from macro-system.js alongside MacroCategory - Remove MacroArgType typedef re-export (now an enum, not a type) * Add support for multiple argument types in macro definitions - Update createTypeBadge to handle both single type and array of types, displaying as "type1 | type2" with tooltip - Add JSDoc comments to MacroArgType enum values explaining each type - Update MacroArgDefinition typedef to allow type property to be single MacroArgType or array - Update MacroRegistry.registerMacro to validate array of types and default empty arrays to 'string' - Update validateArgTypes to check if argument value matches * Add returnType property to macro definitions with automatic type badge display in macro details panel - Rename MacroArgType enum to MacroValueType to reflect dual use for arguments and return types - Add returnType property to MacroDefinitionOptions (defaults to MacroValueType.STRING) - Add returnType validation in MacroRegistry.registerMacro to ensure valid type values - Update renderMacroDetails to always show Returns section with type badge - Add macro-returns-content CSS class with flex layout for type * Add detailed argument definitions, return types, and example usage to all variable macros - Replace numeric requiredArgs with detailed argument definition objects including name, type, and description - Add returnType property to all macros that return values (inc/dec/get variants) - Add returns property descriptions to all macros - Add exampleUsage arrays demonstrating typical usage patterns for each macro - Apply changes consistently * Add returns descriptions and return types to core macro definitions with improved documentation * Add returns descriptions, display overrides, and example usage to time macros with improved documentation * fix lint * Add returns descriptions and return types to chat, environment, instruct, and state macros with improved documentation * Add missing properties to dynamic macro definition override to match MacroDefinitionOptions structure * Replace console logging with MacroDiagnostics logging in MacroEnvBuilder and MacroRegistry * Add support for array-based argument types in macro autocomplete with union type display and tooltip * Rename requiredArgs to unnamedArgs and add support for optional unnamed arguments with bracket notation in macro signatures and hints * Add optional offset argument definition to time macro with type, sample value, and description * Simplify example usage for random and pick macros by removing surrounding context text * Add default value display for optional macro arguments in autocomplete and browser documentation * Fix macro args defaultValue not being converted into the normalized values for register and display * Allow STscript macro auto completion to still show up when typing closing braces * Add space macro with optional count argument for inserting multiple spaces * Add optional count argument to newline macro for inserting multiple newlines with default value of 1 * Remove MutationObserver and CTRL+F keyboard event handling from MacroBrowser * fix lint * Register `{{summary}}` macro for both old and new macro engines based on experimental flag * Register `{{charPrefix}}` and `{{charNegativePrefix}}` macros for both old and new macro engines based on experimental flag * Update hidden alias badge text to indicate deprecation status * Simplify macro name validation and error handling in MacroRegistry Remove redundant `macroName` variable by normalizing `name` parameter early and reusing it throughout the registration flow. Consolidate trim checks in validation condition. * Remove exp macro engine flag checks from auto complete and help, and remove legacy macro template Move macro registration to always use new engine regardless of experimental flag. Remove conditional logic for `experimental_macro_engine` in MacroBrowser, system messages, and slash command parser. Delete legacy `macros.html` template and associated static macro help generation. Always use MacroBrowser for macro documentation display. * Rename macros to camelCase and add backward-compatible aliases Rename `description`, `personality`, `scenario`, `creatorNotes` to `charDescription`, `charPersonality`, `charScenario`, `charCreatorNotes` respectively. Rename `idle_duration` to `idleDuration`. Add old names as aliases for backward compatibility. Add `comment` as visible alias for `//` macro. Mark `idle_duration` alias as hidden. * fix `random` and `pick` macros by using list parameter directly instead of raw string Remove `raw` parameter from `random` and `pick` macro handlers. Simplify legacy comma-separated list handling by using `list[0]` directly instead of `rawListString`. Rename `items` variable to `list` in `pick` macro for consistency. * fix `random` and `pick` not handling all colon-separated lists as before Extract `readSingleArgsRandomList` helper function to handle legacy comma-separated and double-colon list parsing. Reuse this helper in both `random` and `pick` macro handlers to eliminate duplicated list parsing logic. --------- Co-authored-by: Cohee <18619528+Cohee1207@users.noreply.github.com> Co-authored-by: bmen25124 <bmen25124@gmail.com>