Forked from crunch3r/ai-toolbox
Forked from crunch3r/ai-toolbox
src / locales / en.ts
src / locales / en.ts
/**
* English translations for AI Toolbox plugin
*/
import type { FullTranslationSet } from './types';
export const enTranslations: FullTranslationSet = {
fileSystem: {
categoryTitle: '๐ File System Tools',
tools: [
{ toolName: 'list_directory', description: 'List files and folders in workspace', parameters: ['path (optional)'] },
{ toolName: 'read_file', description: 'Read text file content', parameters: ['file_name'] },
{ toolName: 'save_file', description: 'Create or overwrite file', parameters: ['file_name, content'] },
{ toolName: 'replace_text_in_file', description: 'Replace exact string in file (USE THIS FOR COMPLEX INSERTIONS/REPLACEMENTS โ NEVER use line_operations for this)', parameters: ['file_name, old_string, new_string'] },
{ toolName: 'insert_at_line', description: 'โ ๏ธ Single inserts only โ avoid for multi-step structural changes (use save_file/replace_text_in_file instead). Insert text at specific line number.', parameters: ['file_name, line_number, content'] },
{ toolName: 'append_file', description: 'Append content to end of file', parameters: ['file_name, content'] },
{ toolName: 'delete_lines_in_file', description: 'Delete specific lines from file', parameters: ['file_name, start_line, end_line (optional)'] },
{ toolName: 'line_operations', description: 'Insert/delete/reorder lines awk-style without shell dependencies; three-layer guardrails (pattern anchoring, line fingerprinting, bounds validation) + MD5 post-write integrity check', parameters: ['file_name, operation, target_line or pattern anchors (+ options)'] },
{ toolName: 'make_directory', description: 'Create new directory', parameters: ['directory_name'] },
{ toolName: 'move_file', description: 'Move or rename file/directory', parameters: ['source, destination'] },
{ toolName: 'copy_file', description: 'Copy file to new location', parameters: ['source, destination'] },
{ toolName: 'delete_path', description: 'Delete file or directory (destructive)', parameters: ['path'] },
{ toolName: 'delete_files_by_pattern', description: 'Delete files matching regex pattern', parameters: ['pattern (regex)'] },
{ toolName: 'find_files', description: 'Find files by name pattern recursively', parameters: ['pattern, max_depth (optional)'] },
{ toolName: 'fuzzy_find_local_files', description: 'Fuzzy search files by name/path similarity', parameters: ['query, path (optional), max_results (optional)'] },
{ toolName: 'get_file_metadata', description: 'Get file size, dates, type info', parameters: ['path'] },
{ toolName: 'change_directory', description: 'Change working directory', parameters: ['directory'] },
{ toolName: 'read_document', description: 'Read PDF or DOCX documents', parameters: ['file_path'] },
{ toolName: 'analyze_project', description: 'Run project-wide linting analysis', parameters: [] },
{ toolName: 'read_file_chunked', description: 'Read files in structured chunks to bypass character limits, returning start/end indices for streaming control on huge files', parameters: ['file_name, chunk_size/max_chunks (optional)'] },
{ toolName: 'ripgrep', description: 'Recursive content search via worker-isolated ripgrep โ the whole scan runs off the host thread (3s watchdog terminates wedged workers); case-insensitive by default (-i); invalid Rust regexes auto-retry as literal, surfaced via pattern_mode; node_modules excluded by default', parameters: ['pattern, path, mode, case_insensitive, include_glob, exclude_globs, max_depth'] },
{ toolName: 'find_replace_all', description: 'Regex search & replace across multiple files with dry-run preview, .bak backups and extension filters โ depth-capped hang prevention built in', parameters: ['pattern, replacement (optional), directory/dry_run/confirm (+ filters)'] },
{ toolName: 'pattern_scan', description: 'Recursive content search returning matching lines as {file, line, content}; unsafe regex auto-demotes to literal; 256 KB / 10k-line per-file caps with skip records; 3 s wall-clock cap aborts mid-scan โ PARTIAL results with the aborted flag set', parameters: ['pattern (+ root/mode/caps options)'] },
{ toolName: 'directory_tree', description: 'Visualize directory structure in tree format with max depth, optional file sizes and automatic large-directory exclusion', parameters: ['path/max_depth/show_size (optional)'] },
{ toolName: 'file_diff', description: 'Compare two files and return a unified diff with +/โ markers and line numbers', parameters: ['file_a, file_b'] },
{ toolName: 'apply_patch', description: 'Apply unified-diff or binary byte-anchor patches fully in-process (no shell): per-line add/replace/context hunks with verification', parameters: ['file_path, patch_content (+ mode)'] },
],
},
webSearch: {
categoryTitle: '๐ Web & Research Tools',
tools: [
{ toolName: 'web_search', description: 'Search DuckDuckGo/Google/Bing with fallback chain', parameters: ['query, providers (optional)'] },
{ toolName: 'wikipedia_search', description: 'Search Wikipedia for page summaries', parameters: ['query, lang (optional)'] },
{ toolName: 'fetch_web_content', description: 'Fetch webpage clean text content', parameters: ['url'] },
{ toolName: 'rag_web_content', description: 'RAG-based semantic web search', parameters: ['url, query'] },
{ toolName: 'browser_session_control', description: 'Control browser actions (click, type, etc.)', parameters: ['actions array, read_page flag'] },
],
},
browserAutomation: {
categoryTitle: '๐ Browser Automation Tools',
tools: [
{ toolName: 'browser_open_page', description: 'One-shot page render with Puppeteer', parameters: ['url, screenshot_path (optional), actions (optional)'] },
{ toolName: 'browser_session_close', description: 'Gracefully close a persistent browser session, preventing orphaned Chromium processes', parameters: [] },
{ toolName: 'preview_html', description: 'Render raw HTML or an existing .html file in the default system browser', parameters: ['source (HTML string or path)'] },
{ toolName: 'open_file', description: 'Open files/URLs in the system default application (Windows start / macOS open / Linux xdg-open)', parameters: ['target'] },
],
},
gitOperations: {
categoryTitle: '๐ Git & GitHub Tools',
tools: [
{ toolName: 'git_status', description: 'View modified files in repository', parameters: [] },
{ toolName: 'git_diff', description: 'See changes in detail', parameters: ['file_path (optional), cached (optional)'] },
{ toolName: 'git_commit', description: 'Commit staged changes', parameters: ['message'] },
{ toolName: 'git_log', description: 'View commit history', parameters: ['max_count (optional)'] },
{ toolName: 'git_add', description: 'Stage specific files or all changes', parameters: ['paths (optional)'] },
{ toolName: 'git_checkout', description: 'Switch to existing or create new branch', parameters: ['branch_name, create_new (optional)'] },
{ toolName: 'gh_create_issue', description: 'Create new GitHub issue', parameters: ['title, body (optional), labels (optional)'] },
{ toolName: 'gh_list_issues', description: 'List issues in repository', parameters: ['state (optional), labels (optional), limit (optional)'] },
{ toolName: 'gh_view_comments', description: 'View comments on issue or PR', parameters: ['number, type (optional)'] },
{ toolName: 'gh_create_pr', description: 'Create pull request', parameters: ['title, body, head_branch, base_branch (optional)'] },
{ toolName: 'gh_list_prs', description: 'List pull requests in repository', parameters: ['state (optional), limit (optional)'] },
{ toolName: 'gh_view_pr_diff', description: 'Fetch PR diff/patch', parameters: ['number'] },
{ toolName: 'gh_push', description: 'Push commits to remote repository', parameters: ['branch (optional)'] },
{ toolName: 'git_stash', description: 'Manage uncommitted changes: save, pop, drop and list stashes (native Git CLI โ isomorphic-git has no stash support)', parameters: ['operation (+ options)'] },
{ toolName: 'git_blame', description: 'Per-line commit history showing author, timestamp and hash; path validation prevents traversal attacks', parameters: ['file_path (+ options)'] },
],
},
databaseQueries: {
categoryTitle: '๐พ Database Query Tools',
tools: [
{ toolName: 'query_database', description: 'Run read-only SQLite queries', parameters: ['query (SQL string)'] },
],
},
documentParsing: {
categoryTitle: '๐ Document Parsing Tools',
tools: [
{ toolName: 'read_document', description: 'Read PDF or DOCX documents', parameters: ['file_path'] },
],
},
backgroundCommands: {
categoryTitle: 'โฑ๏ธ Background Command Tools',
tools: [
{ toolName: 'run_background_command', description: 'Start long-running process in background', parameters: ['command, timeout_hours (mandatory), name (mandatory)'] },
{ toolName: 'check_background_command', description: 'Check status and output of running command', parameters: ['id'] },
{ toolName: 'cancel_background_command', description: 'Kill a running background command', parameters: ['id'] },
],
},
codeRefactoring: {
categoryTitle: '๐งฌ Code Refactoring Tools',
tools: [
{ toolName: 'refactor_code', description: 'AST-based refactoring (Babel): rename identifiers, move functions across files, extract functions, dead-import cleanup โ syntax-safe with .bak backup and auto-rollback on failure; dry-run diffs supported', parameters: ['file_path, operation, per-operation fields, dry_run (optional)'] },
],
},
execution: {
categoryTitle: 'โก Execution Tools',
tools: [
{ toolName: 'run_javascript', description: 'Execute JavaScript in an isolated Node VM context; eval/require/child_process blocked, default timeout 5 s', parameters: ['javascript, timeout_seconds (optional)'] },
{ toolName: 'run_python', description: 'Execute Python in a controlled sandbox; os/subprocess/sys imports blocked, default timeout 10 s', parameters: ['python, timeout_seconds (optional)'] },
{ toolName: 'execute_command', description: 'โ ๏ธ Run shell commands with multi-layer sanitization and pipe limits โ disabled by default', parameters: ['command (+ options)'] },
{ toolName: 'run_in_terminal', description: 'Launch an OS-native terminal window (cmd/PowerShell/zsh/bash) with env vars and visibility options', parameters: [] },
{ toolName: 'run_tests', description: 'Auto-detect the test framework from package.json (Jest/Mocha/Vitest) and run the project suite, returning results', parameters: [] },
],
},
textProcessing: {
categoryTitle: '๐ Text Processing Tools',
tools: [
{ toolName: 'text_transform', description: 'Regex-based text substitution with capture groups ($1/$2), line ranges and global/case-insensitive modes โ safer than shell sed', parameters: ['file_name, pattern, replacement (optional), flags (optional)'] },
{ toolName: 'text_extract', description: 'Structured field extraction from delimited text (CSV/TSV/custom) using zero-based field indices', parameters: ['file_name, fields, delimiter (optional), output_format (optional)'] },
{ toolName: 'markdown_table_gen', description: 'Generate a valid Markdown table from an array of objects with headers, alignment and truncation', parameters: ['data, headers (optional)'] },
],
},
taskPlanning: {
categoryTitle: '๐ Task Planning Tools',
tools: [
{ toolName: 'create_plan', description: 'Create a multi-step execution plan (1โ30 steps); replaces any active plan and returns planId + stepCount', parameters: ['goal, steps'] },
{ toolName: 'get_plan', description: 'Return the active plan with step statuses, completion percentage and elapsed time; null if no plan exists', parameters: [] },
{ toolName: 'update_plan_step', description: 'Update one plan step through the state machine (pendingโin_progressโdone; anyโblocked; blockedโpending) โ note required when blocking', parameters: ['planId, index, status, note (required if blocked)'] },
{ toolName: 'remove_plan', description: 'Remove a persisted plan from the working-state store; dry-run preview unless confirm=true โ for UNFINISHED plans only, completed ones are auto-removed by update_plan_step at final done', parameters: ['planId, confirm (required to remove)'] },
],
},
contextManagement: {
categoryTitle: '๐ง Context & Memory Tools',
tools: [
{ toolName: 'auto_summarize_context', description: 'Analyze recent session activity for patterns, frequent tool usage and decisions worth remembering; saves to persistent memory with global scope', parameters: ['session_events (+ config_changes)'] },
{ toolName: 'get_context_memory', description: 'Retrieve past context entries filtered by type (decision/pattern/configuration/file_change/error/summary); recencyรfrequency scoring surfaces recent, frequently accessed entries first', parameters: ['type (optional), limit (optional)'] },
{ toolName: 'search_context', description: 'Fuzzy text search across context entry titles, bodies and tags; expired session entries pruned before search (24 h TTL)', parameters: ['query, max_results (optional)'] },
{ toolName: 'context_summary', description: 'Statistical overview of persistent memory: total entries, type breakdowns and recent activity counts', parameters: [] },
{ toolName: 'delete_context_entry', description: 'Remove a specific context entry by unique ID without clearing the rest of the history', parameters: ['entry_id'] },
{ toolName: 'clear_context_memory', description: 'Clear all auto-saved context entries (โ ๏ธ irreversible; requires confirm=true)', parameters: ['confirm'] },
{ toolName: 'track_important_event', description: 'Manually record an event, decision or milestone with custom tags for categorized retrieval', parameters: ['title, content, tags (optional)'] },
{ toolName: 'save_session_summary', description: 'Save a structured session summary (accomplishments, pending tasks, decisions) compressed to bypass the 10k SDK limit', parameters: ['task_description (+ optional sections)'] },
{ toolName: 'get_session_summary', description: 'Retrieve the latest saved session summary with backward-compatible fallback for legacy data', parameters: [] },
{ toolName: 'save_memory', description: 'Persist a fact to .ai_toolbox_memory.msgpack for cross-session continuity (RAM + atomic disk copy)', parameters: ['fact'] },
{ toolName: 'get_memory', description: 'Retrieve all saved memory entries; local project file checked first, then persistent store', parameters: [] },
{ toolName: 'delete_memory', description: 'Remove a specific memory entry by its unique key (returned during save)', parameters: ['entry_id'] },
{ toolName: 'list_sessions', description: 'Browse saved session summaries with pagination and limit controls', parameters: ['limit (optional), offset (optional)'] },
{ toolName: 'search_sessions', description: 'Keyword search across stored session summaries, newest first', parameters: ['query, max_results (optional)'] },
{ toolName: 'clear_session_index', description: 'Remove all lightweight session index entries only โ summaries untouched (requires confirm=true)', parameters: ['confirm'] },
{ toolName: 'manage_projects', description: 'Manage the cross-project registry โ mutations AND reads: register / unregister / update / clear_all + info / list / search (single tool for ALL project-registry operations; destructive actions require confirm=true)', parameters: ['action (register|unregister|update|clear_all|info|list|search), project_name, working_dir_path (required for register/unregister/update/info), source_dirs (optional), query + max_results (for search), confirm (required for destructive actions)'] },
{ toolName: 'register_project', description: '[DEPRECATED alias of manage_projects(action="register")] Register or update a project in the cross-project registry by name + working-dir path (+ optional source dirs)', parameters: ['project_name, working_dir_path, source_dirs (optional)'] },
{ toolName: 'get_project_info', description: '[DEPRECATED alias of manage_projects(action="info")] Retrieve details of one registered project by its working directory path', parameters: ['working_dir_path'] },
{ toolName: 'list_projects', description: '[DEPRECATED alias of manage_projects(action="list")] List all registered projects with paths, last-accessed times and session counts', parameters: [] },
{ toolName: 'search_projects', description: '[DEPRECATED alias of manage_projects(action="search")] Search registered projects by name or path substring; lazy registry sync auto-registers projects found in session memory', parameters: ['query, max_results (optional)'] },
{ toolName: 'switch_context', description: 'Switch context storage to another project\'s working directory for memory/session recall (confirm-first per Step 0.7 banner)', parameters: ['target_working_dir_path'] },
{ toolName: 'restore_session_context', description: 'Restore EVERYTHING persisted from previous sessions of the current project in ONE read-only call: latest session summary + persisted plans + context entries (auto-checkpoints collapsed) + memory facts + recent-sessions index โ the single "read session mem" entry point', parameters: ['include_sessions_index, max_chars (both optional)'] },
{ toolName: 'memory_recall', description: 'ID-first READ-ONLY recall over the memory layer: mode=index lists compact id/title/date rows across context entries + memory facts + sessions; mode=fetch returns full records for up to 10 ids with self-describing miss reasons (summary_never_persisted is expected by design)', parameters: ['mode (index|fetch), kind, limit (index only) / ids โค10, per_item_chars (fetch only)'] },
],
},
vectorRag: {
categoryTitle: '๐ Vector RAG Tools',
tools: [
{ toolName: 'rag_index_files', description: 'Index a directory of TS/JS/MD/JSON/YAML/text files for semantic search with batch processing', parameters: ['directoryPath, filePattern (optional), batchSize (optional)'] },
{ toolName: 'rag_index_pdf', description: 'Index a PDF by page-bounded chunks (~300 words each) with page_number provenance โ OOM-safe bounded reads', parameters: ['filePath, chunkSize/overlap (optional)'] },
{ toolName: 'rag_index_docx', description: 'Extract DOCX text via mammoth into word-bounded chunks through the same embedding pipeline as PDF', parameters: ['filePath, chunkSize/overlap (optional)'] },
{ toolName: 'rag_index_xlsx', description: 'Index all sheets of a spreadsheet as row arrays with optional sheet-name prefix for traceability', parameters: ['filePath, chunkSize (optional), includeSheetNames (optional)'] },
{ toolName: 'rag_query_vector', description: 'Cosine-similarity query over the vector index returning top-k chunks with content and scores', parameters: ['query, topK (optional)'] },
{ toolName: 'rag_clear_index', description: 'Clear the entire vector index (requires confirm=true); useful before full reindexing', parameters: ['confirm'] },
{ toolName: 'rag_web_content', description: 'Fetch a URL and return only the text chunks relevant to the query โ bounded, deduplicated extraction', parameters: ['url, query'] },
],
},
uiGeneration: {
categoryTitle: '๐จ UI Generation Tools',
tools: [
{ toolName: 'generate_ui_component', description: 'Create interactive HTML/CSS/JS components (buttons, forms, tables) from a user description', parameters: [] },
{ toolName: 'render_and_preview_ui', description: 'Render components in-browser with live preview for rapid prototyping', parameters: [] },
{ toolName: 'extract_ui_data', description: 'Extract structured data from pages via CSS selectors/XPath returning tabular output back into the chat', parameters: [] },
],
},
httpClient: {
categoryTitle: '๐ก HTTP Client Tools',
tools: [
{ toolName: 'http_request', description: 'Generic GET/POST/PUT/DELETE/PATCH client with retry logic, timeout configuration and multipart upload โ SSRF-guarded (โ ๏ธ disabled by default)', parameters: ['url, method (+ options)'] },
{ toolName: 'http_get_json', description: 'GET requests expecting JSON responses with automatic parsing and optional schema validation', parameters: ['url (+ headers/options)'] },
{ toolName: 'http_post_json', description: 'POST requests with JSON payload, content-type auto-handling and auth token support; returns status code', parameters: ['url, body (+ options)'] },
],
},
utilities: {
categoryTitle: '๐ง Utility Tools',
tools: [
{ toolName: 'markdown_preview', description: 'Render a Markdown file to HTML and open it in the default browser', parameters: ['file_path'] },
{ toolName: 'get_repeat_tool_advice', description: 'Returns current repeat-tool reminder state and any active nudges; use to check if the model is in a repetition loop', parameters: ['toolName, args (optional)'] },
{ toolName: 'get_update_info', description: 'Read the current AI Toolbox update status without changing anything: installed version, whether a strictly-newer published version is known (24h-cached check against the hub .VERSION file), and its marketplace page URL when available - render it as a clickable link in chat', parameters: [] },
{ toolName: 'dismiss_update_reminder', description: 'Records "not now" for an update-reminder version so it stops re-notifying on every turn; that version stays quiet forever, strictly-newer releases still notify', parameters: ['version'] },
],
},
imageProcessing: {
categoryTitle: '๐ผ๏ธ Image Processing & Analysis Tools',
tools: [
{ toolName: 'image_to_text', description: 'OCR text extraction via Tesseract.js with confidence scores and language detection (50 MB max)', parameters: ['imagePath, language (optional)'] },
{ toolName: 'describe_image', description: 'Get image metadata: dimensions, format, size and timestamps for PNG/JPG/BMP/GIF/WebP/TIFF', parameters: ['imagePath'] },
{ toolName: 'screenshot_desktop', description: 'Capture a desktop screenshot cross-platform (GDI+/screencapture/ImageMagick)', parameters: ['outputPath/format/quality (optional)'] },
{ toolName: 'compare_images', description: 'Byte-level and dimension comparison of two images; exact-match status for identical encodings', parameters: ['image1Path, image2Path'] },
],
},
backupRestore: {
categoryTitle: '๐พ Backup & Restore Tools',
tools: [
{ toolName: 'create_backup', description: 'Create a compressed ZIP snapshot of the entire working directory in .ai_toolbox_backups/ (requires confirm=true)', parameters: ['confirm, destination/targetDirectory (optional)'] },
{ toolName: 'list_backups', description: 'List backups sorted by date or size with filename, path, size and creation timestamp', parameters: ['sortBy/limit (optional)'] },
{ toolName: 'restore_backup', description: 'Restore the working directory from a backup archive (โ ๏ธ overwrites all files; requires confirm=true)', parameters: ['backupFile, confirm'] },
{ toolName: 'delete_backup', description: 'Remove one specific backup file (โ ๏ธ irreversible; validates existence first)', parameters: ['backupFile, confirm'] },
{ toolName: 'cleanup_backups', description: 'List and optionally delete .bak edit backups โ dry-run by default, confirm required to delete', parameters: ['confirm (optional)'] },
{ toolName: 'restore_from_bak', description: 'Restore a file from its .bak backup created by file-modifying tools (replace_text_in_file, insert_at_line, append_file, delete_lines_in_file)', parameters: ['file_name'] },
{ toolName: 'list_available_bak_backups', description: 'Scan the current working directory for all .bak backup files created by file-modifying tools; use before restoring to see what is available', parameters: [] },
],
},
dataVisualization: {
categoryTitle: '๐ Data Visualization Tools',
tools: [
{ toolName: 'generate_chart', description: 'Render bar/line/pie/doughnut/scatter/radar charts to a PNG image from raw data; HTML fallback when the renderer is unavailable', parameters: ['type, data (+ title/colors/output_path optional)'] },
],
},
// โโ UNIFIED LANGUAGE v2 (26.10): runtime prompt texts โ values BYTE-IDENTICAL to the pre-v2 hardcoded
// literals in promptPreprocessor.ts / autoTracker.ts / documentTools.ts so 'en' output never drifts. โโ
runtimeTexts: {
workingDirDetected: 'โ ๏ธ WORKING DIRECTORY DETECTED',
workingDirMentionedLine: 'The user mentioned a directory path in their message:',
workingDirConfirmAsk: 'Please ask the user for confirmation before changing the working directory.',
workingDirExampleLabel: 'Example response:',
// Trailing spaces after ". " and "? " are deliberate โ they mirror the pre-v2 template byte-for-byte.
workingDirExampleText: "I noticed you mentioned the directory '{path}'. \nWould you like me to set this as your working directory? \nAll subsequent file operations will use this directory as the base.",
workingDirReplyHint: "Reply '{yes}' to confirm, or '{no}' to decline.",
workingDirOriginalMessageLabel: 'User\'s original message:',
projectDetectedTitle: 'โ ๏ธ REGISTERED PROJECT DETECTED',
projectFoundLead: 'I found a registered project matching your message:',
projectNameLabel: 'Project: "{name}"',
projectPathLabel: 'Path: {path}',
projectSwitchQuestion: 'Would you like me to switch your working directory to this project?',
sessionMemoryLoadedTitle: '๐ SESSION MEMORY LOADED',
previousSessionLabel: 'Previous session summary:',
checkpointWarningHeader: 'TOKEN LIMIT WARNING โ ACKNOWLEDGE BEFORE RESPONDING:',
checkpointActionRequiredLead: 'ACTION REQUIRED: Before responding to the user\'s message, explicitly acknowledge this token limit warning.',
checkpointIfConfirmedLine: 'If the user replied with one of the confirmation options shown in the warning above โ trigger the context management save tool now.',
checkpointIfDeclinedLine: 'If the user declined or did NOT give a confirmation reply โ ask them if they want to proceed with a context save.',
checkpointDoNotProceedLine: 'Do not proceed with normal conversation until this warning has been addressed.',
sessionWarningHead: 'โ ๏ธ SESSION WARNING: You have reached {pct}% of your token limit. It is highly recommended to save session memory before continuing.',
bufferedEventsLine: 'Auto-tracked events in buffer (will be saved with checkpoint): {count}',
contextSaveQuestion: "Do you want to proceed with a context save? Reply '{yes}' to trigger the session memory save, or '{no}' to continue.",
attachedFilesTitle: '๐ ATTACHED FILES AVAILABLE:',
attachedFilesLead: 'You have access to the following attached files. You can read them using the read_document tool by filename:',
attachmentErrorCrossRef: "Note: If this is an attached file, use the exact filename from the \"ATTACHED FILES AVAILABLE\" list.",
ragContextHeader: '--- RELEVANT DOCUMENT CONTEXT ---',
// v2 NEW (not present pre-v2): one-line per-turn answer-language instruction.
answerLanguageLine: 'Respond to the user in {language}.',
},
// โโ UNIFIED LANGUAGE v2 (26.10): settings-panel labels โ values copied from config.ts schematics;
// baked at boot time from the resolved language (step 4/5), reload-consistent via state file. โโ
uiLabels: {
languageRow: {
displayName: '๐ Language',
options: { auto: 'Automatic (follows LM Studio)', en: 'English', de: 'Deutsch (German)', es: 'Espaรฑol', zhCN: 'Simplified Chinese', zhTW: 'Traditional Chinese' },
},
godMode: { displayName: 'โกโ ๏ธ GOD MODE - Enable ALL Tools โ ๏ธโก', subtitle: 'WARNING: Activates every tool category instantly. Use with caution.', hint: 'When enabled, ALL individual toggles are bypassed and every tool is activated regardless of settings.' },
fileSystem: { displayName: '๐ File System Tools', hint: 'Enable file read/write/search operations' },
webSearch: { displayName: '๐ Web & Research Tools', hint: 'Enable DuckDuckGo/Wikipedia search' },
packageManage: { displayName: 'Package Management Tools', subtitle: 'npm/pip/cargo operations', hint: 'Enable package manager tools. Disabled by default for security.' },
gitOperations: { displayName: '๐ Git & GitHub Tools', subtitle: 'Version Control & API', hint: 'Enable git operations and GitHub API access.' },
gitAutoCommit: { displayName: '๐พ Git Auto-Commit', subtitle: 'โ๏ธ Part of Git & GitHub Tools', hint: 'Automatically commit changes after operations' },
defaultBranch: { displayName: '๐ฟ Default Branch', subtitle: 'โ๏ธ Part of Git & GitHub Tools', hint: 'Branch name for new repositories and git operations' },
databaseQueries: { displayName: '๐๏ธ Database Queries', hint: 'Enable read-only SQLite queries' },
documentParsing: { displayName: '๐ Document Parsing', hint: 'Enable PDF/DOCX document reading' },
backgroundCommands: { displayName: 'โณ Background Commands', hint: 'Enable long-running process tracking' },
imageProcessing: { displayName: '๐ผ๏ธ Image Processing Tools', subtitle: 'OCR, Screenshots & Comparison', hint: 'Enable image OCR (Tesseract.js), screenshot capture, and image comparison tools.' },
httpClient: { displayName: '๐ HTTP Client Tools', subtitle: 'Generic REST API Client', hint: 'Enable generic HTTP client for making requests to any REST API (GET, POST, PUT, DELETE).' },
vectorRag: { displayName: '๐ Vector RAG / Semantic Search', subtitle: 'Semantic Document Search', hint: 'Enable semantic search with vector embeddings for intelligent document retrieval.' },
uiGeneration: { displayName: '๐จ Interactive UI Generation Tools', subtitle: 'Generate and render interactive UI components', hint: 'Enable tools for generating HTML/CSS/JS components (buttons, forms, charts, dashboards) and rendering them in the browser.' },
contextManagement: { displayName: '๐ง Auto-Context Management Tools', subtitle: 'Automatic session tracking and memory management', hint: 'Enable tools for automatically saving important decisions, patterns, and configurations to persistent memory.' },
documentRAG: { displayName: '๐ Document RAG / Chat with Files', subtitle: 'Enable file indexing and semantic search for chat', hint: 'Attach documents to your chat messages. The plugin will automatically retrieve relevant content from attached files using semantic search.' },
textProcessing: { displayName: '๐ Text Processing Tools (sed/awk equivalents)', subtitle: 'Regex-based text transformations and field extraction', hint: 'Enable tools for bulk text replacement, pattern matching, and structured data extraction without shell dependencies.' },
refactorCode: { displayName: '๐ง AST Code Refactoring Tools', subtitle: 'Rename, move, extract functions & clean unused imports', hint: 'Enable AST-based code refactoring tools (rename_identifier, move_function, extract_function, unused_import_cleanup).' },
utility: { displayName: '๐ ๏ธ Utility & Maintenance Tools', subtitle: 'Backup, chart generation, markdown preview, line operations', hint: 'Enable utility tools (create_backup, list_backups, restore_backup, delete_backup, cleanup_backups, generate_chart, markdown_preview).' },
taskPlanning: { displayName: '๐ Task Planning Tools', subtitle: 'Structured multi-step workflow tools', hint: 'Enable create_plan, update_plan_step, and get_plan tools for structured task execution.' },
clusterAwareToolOrder: { displayName: '๐งญ Cluster-Aware Tool Ordering', subtitle: 'Sort exposed tools by priority tier + module centrality instead of alphabetically.', hint: 'Uses the static ARCHITECTURE.md dependency graph (no fs I/O). Disable to restore legacy alphabetical order.' },
retrievalLimit: { displayName: '๐ข Retrieval Limit', subtitle: 'Max chunks to return per query', hint: 'Maximum number of relevant document chunks to retrieve for each query.' },
retrievalAffinityThreshold: { displayName: '๐ฏ Retrieval Affinity Threshold', subtitle: 'Minimum relevance score (0-1)', hint: 'Chunks below this similarity score will be filtered out. Lower = more results but potentially less relevant.' },
executionJavaScript: { displayName: 'โก Allow JavaScript Execution', subtitle: "Enables the 'run_javascript' tool", hint: 'WARNING: code runs on your machine.' },
executionPython: { displayName: '๐ Allow Python Execution', subtitle: "Enables the 'run_python' tool", hint: 'WARNING: code runs on your machine.' },
executionTerminal: { displayName: '๐ป Allow Terminal Execution', subtitle: "Enables the 'run_in_terminal' tool", hint: 'Opens real terminal windows.' },
executionShell: { displayName: '๐ง Allow Shell Command Execution', subtitle: "Enables the 'execute_command' tool", hint: 'WARNING: commands run on your machine.' },
executionTests: { displayName: '๐งช Allow Test Execution', subtitle: "Enables the 'run_tests' tool", hint: 'WARNING: runs npm jest / pytest / go test โ can install packages and execute code.' },
searchFallbackChain: { displayName: '๐ Search Fallback Chain', hint: 'Primary search engine. Auto-falls back to others if unavailable.' },
safesearch: { displayName: '๐ก๏ธ Safe Search', options: { off: 'Off', moderate: 'Moderate', strict: 'Strict' } },
browserAutomation: { displayName: '๐ฅ๏ธ Browser Automation Tools', subtitle: 'Headless browser control & automation', hint: 'Enable Puppeteer-based headless browser automation for web scraping, testing, and UI interaction.' },
browserTimeout: { displayName: 'โฑ๏ธ Browser Timeout', subtitle: 'โ๏ธ Part of Browser Automation Tools', hint: 'Maximum time (ms) to wait for browser operations before timing out.' },
headlessMode: { displayName: '๐ป Headless Mode', subtitle: 'โ๏ธ Part of Browser Automation Tools', hint: 'Run browser without GUI (recommended for automation).' },
pathValidationEnabled: { displayName: '๐ Path Validation', hint: 'Prevent directory traversal attacks' },
binaryFileDetection: { displayName: '๐ Binary File Detection', hint: 'Detect binary files via null byte check' },
regexReDoSProtection: { displayName: '๐ก๏ธ ReDoS Protection', hint: 'Protect against regex denial-of-service' },
statePersistenceEnabled: { displayName: '๐ฝ State Persistence', hint: 'Persist tool execution state between sessions' },
notificationsEnabled: { displayName: '๐ Desktop Notifications', hint: 'Show system notifications' },
updateCheckEnabled: { displayName: '๐ Plugin Update Check', subtitle: 'Quiet LM Studio hub .VERSION check โ no new tools, no OS permissions', hint: "Once per day the plugin quietly checks the published LM Studio hub .VERSION file for a strictly-newer release. If one exists it notifies via desktop toast (Desktop Notifications ON) or a single in-chat line (OFF). Silent when you are up to date or on a dismissed version; state survives reinstalls." },
temporalAwareness: { displayName: 'โฐ Temporal Awareness', subtitle: 'Injects current date/time into every message', hint: 'Enables the AI to know the current time.' },
dateFormatStyle: { displayName: '๐
Date Format Style', options: { standard: 'Standard ([Zeit: ...])', heuteIst: 'HEUTE IST Mode (Prominent)' } },
contextGuardEnabled: { displayName: '๐ง ContextGuard Token Management', subtitle: 'Automatic history compression & smart reading', hint: 'Automatically compresses chat history when token limit is reached. Enables smart file reading and terminal output filtering.' },
contextGuardCompressionPercent: { displayName: '๐ Compression Trigger (% of Context Window)', subtitle: 'โ๏ธ ContextGuard Setting', hint: "History compression triggers when context usage reaches this percentage of the active model's context window. If LM Studio reports the model's real window it is used; otherwise a built-in 30k fallback applies." },
contextGuardAgenticDensity: { displayName: '๐ข Agentic Chars-per-Token Density', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Chars per token used to estimate tokens from character length (agentic mix of prose + tool output; live-measured band ~3.2-3.4 โ default 3.6 is owner-set above that band). Higher = denser content = fewer estimated tokens; lower estimates more and triggers compaction earlier.' },
contextGuardForceSummaryOnCompress: { displayName: '๐พ Force Session-Memory Save Before Compression', subtitle: 'โ๏ธ ContextGuard Setting', hint: "When context reaches your Compression Trigger, a structured session summary (task description, accomplishments, pending tasks) is generated with the Summary Model and persisted BEFORE history is compressed. Non-fatal: on any failure the previous telemetry checkpoint still runs." },
contextGuardSmartReading: { displayName: '๐ Smart File Reading', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Extracts keywords from user queries to read only relevant portions of files. Saves tokens and speeds up responses.' },
contextGuardSummaryModel: { displayName: '๐ค Summary Model Name', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'LM Studio model name used for history summarization. Leave empty to use your current chat model.' },
contextGuardTerminalFilterEnabled: { displayName: '๐ Terminal Output Filtering', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Automatically truncates long terminal outputs to save tokens.' },
contextGuardTerminalFilterLength: { displayName: '๐ Max Terminal Output Length', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Maximum characters before terminal output is truncated and summarized.' },
compactionEnabled: { displayName: 'โ๏ธ Compaction Pre-Summarization Pruning', subtitle: 'โ๏ธ C Compaction Family', hint: 'Before history is summarized, tool payloads above the byte budget are replaced by a head/tail preview plus an opaque locator; the full result stays stored verbatim in .ai_toolbox/compaction/.' },
compactionMaxResultBytes: { displayName: '๐ Max Tool Result Before Pruning (bytes)', subtitle: 'โ๏ธ C Compaction Family', hint: 'Byte budget per tool-result payload in chat history. Results above this are pruned to preview + locator before summarization (verbatim copy stored on disk).' },
contextUsageFooter: { displayName: '๐ Context Usage Footer in Tool Results', subtitle: 'โ๏ธ LLM-side Limit Awareness', hint: "Once projected context usage crosses half of the model's window, every tool result gains a short footer like [ctx ~48.3k/64k = 76%] โ appended to string results and added as an additive ctx_footer field on plain-object results (every registered tool returns one) โ so the model always sees current token usage. At >=90% a near-limit advisory is added." },
autoTrackingEnabled: { displayName: '๐ค Auto-Tracking Enabled', subtitle: 'Automatically remember important events', hint: 'Silently tracks decisions, completions, and bug fixes in the background. Enabled by default.' },
autoTrackTokenThreshold: { displayName: 'Auto-Track Token Threshold', subtitle: 'Auto-Tracking Setting', hint: 'Trigger session memory save when token usage reaches this percentage (default: 75%). Helps prevent context overflow.' },
autoTrackDecisions: { displayName: '๐ Track Decisions Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "I decided", "conclusion", "going with".' },
autoTrackCompletions: { displayName: 'โ
Track Completions Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "successfully completed", "finished implementing".' },
autoTrackErrors: { displayName: '๐ Track Bug Fixes Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "fixed the bug", "resolved the issue".' },
autoSummaryInterval: { displayName: '๐ Session Summary Interval', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Number of messages between automatic session summaries. Higher = less frequent.' },
// Budget-Guard-Arc i18n (06.11, owner rule "alle Tool-Beschreibungen IMMER รผbersetzt"): values below are byte-pinned to the config.ts fallback literals.
budgetGuardEnabled: { displayName: '๐ก๏ธ Budget Guard (context-limit protection)', hint: 'Master switch for the deterministic context budget guard โ M1 pre-call read gate, M2 budget-aware spill cap, M3 auto-persist at 85% edge. ON by default (06.11); turn OFF to restore byte-identical legacy behavior.' },
budgetGuardAdvisoryThresholdPct: { displayName: '๐ข Budget Guard Advisory Threshold (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M1 pre-call read gate: above this % of the context limit, read tools return a self-describing budget advisory instead of the full payload.' },
budgetGuardSpillThresholdPct: { displayName: 'โ๏ธ Budget Guard Spill Threshold (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M2 spill cap: tool results are spilled to disk beyond this % of the limit (the stricter of absolute vs budget-relative bound wins).' },
budgetGuardAutopauseThresholdPct: { displayName: '๐พ Budget Guard Auto-Persist Edge (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M3: automatic session-memory persist at this % edge, max once per session.' },
budgetGuardSafetyMarginPct: { displayName: '๐งฎ Budget Guard Safety Margin (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'Reserve kept out of the context limit for M2 budget math โ limit ร (1 โ margin/100); default 8 โ spill at 92 %.' },
},
general: {
pluginName: 'AI Toolbox Plugin',
enabledTools: 'Enabled Tools:',
disabledTools: 'Disabled Tools:',
errorPrefix: 'Error:',
successPrefix: 'Success:',
yesWord: 'YES',
noWord: 'NO',
},
};/**
* English translations for AI Toolbox plugin
*/
import type { FullTranslationSet } from './types';
export const enTranslations: FullTranslationSet = {
fileSystem: {
categoryTitle: '๐ File System Tools',
tools: [
{ toolName: 'list_directory', description: 'List files and folders in workspace', parameters: ['path (optional)'] },
{ toolName: 'read_file', description: 'Read text file content', parameters: ['file_name'] },
{ toolName: 'save_file', description: 'Create or overwrite file', parameters: ['file_name, content'] },
{ toolName: 'replace_text_in_file', description: 'Replace exact string in file (USE THIS FOR COMPLEX INSERTIONS/REPLACEMENTS โ NEVER use line_operations for this)', parameters: ['file_name, old_string, new_string'] },
{ toolName: 'insert_at_line', description: 'โ ๏ธ Single inserts only โ avoid for multi-step structural changes (use save_file/replace_text_in_file instead). Insert text at specific line number.', parameters: ['file_name, line_number, content'] },
{ toolName: 'append_file', description: 'Append content to end of file', parameters: ['file_name, content'] },
{ toolName: 'delete_lines_in_file', description: 'Delete specific lines from file', parameters: ['file_name, start_line, end_line (optional)'] },
{ toolName: 'line_operations', description: 'Insert/delete/reorder lines awk-style without shell dependencies; three-layer guardrails (pattern anchoring, line fingerprinting, bounds validation) + MD5 post-write integrity check', parameters: ['file_name, operation, target_line or pattern anchors (+ options)'] },
{ toolName: 'make_directory', description: 'Create new directory', parameters: ['directory_name'] },
{ toolName: 'move_file', description: 'Move or rename file/directory', parameters: ['source, destination'] },
{ toolName: 'copy_file', description: 'Copy file to new location', parameters: ['source, destination'] },
{ toolName: 'delete_path', description: 'Delete file or directory (destructive)', parameters: ['path'] },
{ toolName: 'delete_files_by_pattern', description: 'Delete files matching regex pattern', parameters: ['pattern (regex)'] },
{ toolName: 'find_files', description: 'Find files by name pattern recursively', parameters: ['pattern, max_depth (optional)'] },
{ toolName: 'fuzzy_find_local_files', description: 'Fuzzy search files by name/path similarity', parameters: ['query, path (optional), max_results (optional)'] },
{ toolName: 'get_file_metadata', description: 'Get file size, dates, type info', parameters: ['path'] },
{ toolName: 'change_directory', description: 'Change working directory', parameters: ['directory'] },
{ toolName: 'read_document', description: 'Read PDF or DOCX documents', parameters: ['file_path'] },
{ toolName: 'analyze_project', description: 'Run project-wide linting analysis', parameters: [] },
{ toolName: 'read_file_chunked', description: 'Read files in structured chunks to bypass character limits, returning start/end indices for streaming control on huge files', parameters: ['file_name, chunk_size/max_chunks (optional)'] },
{ toolName: 'ripgrep', description: 'Recursive content search via worker-isolated ripgrep โ the whole scan runs off the host thread (3s watchdog terminates wedged workers); case-insensitive by default (-i); invalid Rust regexes auto-retry as literal, surfaced via pattern_mode; node_modules excluded by default', parameters: ['pattern, path, mode, case_insensitive, include_glob, exclude_globs, max_depth'] },
{ toolName: 'find_replace_all', description: 'Regex search & replace across multiple files with dry-run preview, .bak backups and extension filters โ depth-capped hang prevention built in', parameters: ['pattern, replacement (optional), directory/dry_run/confirm (+ filters)'] },
{ toolName: 'pattern_scan', description: 'Recursive content search returning matching lines as {file, line, content}; unsafe regex auto-demotes to literal; 256 KB / 10k-line per-file caps with skip records; 3 s wall-clock cap aborts mid-scan โ PARTIAL results with the aborted flag set', parameters: ['pattern (+ root/mode/caps options)'] },
{ toolName: 'directory_tree', description: 'Visualize directory structure in tree format with max depth, optional file sizes and automatic large-directory exclusion', parameters: ['path/max_depth/show_size (optional)'] },
{ toolName: 'file_diff', description: 'Compare two files and return a unified diff with +/โ markers and line numbers', parameters: ['file_a, file_b'] },
{ toolName: 'apply_patch', description: 'Apply unified-diff or binary byte-anchor patches fully in-process (no shell): per-line add/replace/context hunks with verification', parameters: ['file_path, patch_content (+ mode)'] },
],
},
webSearch: {
categoryTitle: '๐ Web & Research Tools',
tools: [
{ toolName: 'web_search', description: 'Search DuckDuckGo/Google/Bing with fallback chain', parameters: ['query, providers (optional)'] },
{ toolName: 'wikipedia_search', description: 'Search Wikipedia for page summaries', parameters: ['query, lang (optional)'] },
{ toolName: 'fetch_web_content', description: 'Fetch webpage clean text content', parameters: ['url'] },
{ toolName: 'rag_web_content', description: 'RAG-based semantic web search', parameters: ['url, query'] },
{ toolName: 'browser_session_control', description: 'Control browser actions (click, type, etc.)', parameters: ['actions array, read_page flag'] },
],
},
browserAutomation: {
categoryTitle: '๐ Browser Automation Tools',
tools: [
{ toolName: 'browser_open_page', description: 'One-shot page render with Puppeteer', parameters: ['url, screenshot_path (optional), actions (optional)'] },
{ toolName: 'browser_session_close', description: 'Gracefully close a persistent browser session, preventing orphaned Chromium processes', parameters: [] },
{ toolName: 'preview_html', description: 'Render raw HTML or an existing .html file in the default system browser', parameters: ['source (HTML string or path)'] },
{ toolName: 'open_file', description: 'Open files/URLs in the system default application (Windows start / macOS open / Linux xdg-open)', parameters: ['target'] },
],
},
gitOperations: {
categoryTitle: '๐ Git & GitHub Tools',
tools: [
{ toolName: 'git_status', description: 'View modified files in repository', parameters: [] },
{ toolName: 'git_diff', description: 'See changes in detail', parameters: ['file_path (optional), cached (optional)'] },
{ toolName: 'git_commit', description: 'Commit staged changes', parameters: ['message'] },
{ toolName: 'git_log', description: 'View commit history', parameters: ['max_count (optional)'] },
{ toolName: 'git_add', description: 'Stage specific files or all changes', parameters: ['paths (optional)'] },
{ toolName: 'git_checkout', description: 'Switch to existing or create new branch', parameters: ['branch_name, create_new (optional)'] },
{ toolName: 'gh_create_issue', description: 'Create new GitHub issue', parameters: ['title, body (optional), labels (optional)'] },
{ toolName: 'gh_list_issues', description: 'List issues in repository', parameters: ['state (optional), labels (optional), limit (optional)'] },
{ toolName: 'gh_view_comments', description: 'View comments on issue or PR', parameters: ['number, type (optional)'] },
{ toolName: 'gh_create_pr', description: 'Create pull request', parameters: ['title, body, head_branch, base_branch (optional)'] },
{ toolName: 'gh_list_prs', description: 'List pull requests in repository', parameters: ['state (optional), limit (optional)'] },
{ toolName: 'gh_view_pr_diff', description: 'Fetch PR diff/patch', parameters: ['number'] },
{ toolName: 'gh_push', description: 'Push commits to remote repository', parameters: ['branch (optional)'] },
{ toolName: 'git_stash', description: 'Manage uncommitted changes: save, pop, drop and list stashes (native Git CLI โ isomorphic-git has no stash support)', parameters: ['operation (+ options)'] },
{ toolName: 'git_blame', description: 'Per-line commit history showing author, timestamp and hash; path validation prevents traversal attacks', parameters: ['file_path (+ options)'] },
],
},
databaseQueries: {
categoryTitle: '๐พ Database Query Tools',
tools: [
{ toolName: 'query_database', description: 'Run read-only SQLite queries', parameters: ['query (SQL string)'] },
],
},
documentParsing: {
categoryTitle: '๐ Document Parsing Tools',
tools: [
{ toolName: 'read_document', description: 'Read PDF or DOCX documents', parameters: ['file_path'] },
],
},
backgroundCommands: {
categoryTitle: 'โฑ๏ธ Background Command Tools',
tools: [
{ toolName: 'run_background_command', description: 'Start long-running process in background', parameters: ['command, timeout_hours (mandatory), name (mandatory)'] },
{ toolName: 'check_background_command', description: 'Check status and output of running command', parameters: ['id'] },
{ toolName: 'cancel_background_command', description: 'Kill a running background command', parameters: ['id'] },
],
},
codeRefactoring: {
categoryTitle: '๐งฌ Code Refactoring Tools',
tools: [
{ toolName: 'refactor_code', description: 'AST-based refactoring (Babel): rename identifiers, move functions across files, extract functions, dead-import cleanup โ syntax-safe with .bak backup and auto-rollback on failure; dry-run diffs supported', parameters: ['file_path, operation, per-operation fields, dry_run (optional)'] },
],
},
execution: {
categoryTitle: 'โก Execution Tools',
tools: [
{ toolName: 'run_javascript', description: 'Execute JavaScript in an isolated Node VM context; eval/require/child_process blocked, default timeout 5 s', parameters: ['javascript, timeout_seconds (optional)'] },
{ toolName: 'run_python', description: 'Execute Python in a controlled sandbox; os/subprocess/sys imports blocked, default timeout 10 s', parameters: ['python, timeout_seconds (optional)'] },
{ toolName: 'execute_command', description: 'โ ๏ธ Run shell commands with multi-layer sanitization and pipe limits โ disabled by default', parameters: ['command (+ options)'] },
{ toolName: 'run_in_terminal', description: 'Launch an OS-native terminal window (cmd/PowerShell/zsh/bash) with env vars and visibility options', parameters: [] },
{ toolName: 'run_tests', description: 'Auto-detect the test framework from package.json (Jest/Mocha/Vitest) and run the project suite, returning results', parameters: [] },
],
},
textProcessing: {
categoryTitle: '๐ Text Processing Tools',
tools: [
{ toolName: 'text_transform', description: 'Regex-based text substitution with capture groups ($1/$2), line ranges and global/case-insensitive modes โ safer than shell sed', parameters: ['file_name, pattern, replacement (optional), flags (optional)'] },
{ toolName: 'text_extract', description: 'Structured field extraction from delimited text (CSV/TSV/custom) using zero-based field indices', parameters: ['file_name, fields, delimiter (optional), output_format (optional)'] },
{ toolName: 'markdown_table_gen', description: 'Generate a valid Markdown table from an array of objects with headers, alignment and truncation', parameters: ['data, headers (optional)'] },
],
},
taskPlanning: {
categoryTitle: '๐ Task Planning Tools',
tools: [
{ toolName: 'create_plan', description: 'Create a multi-step execution plan (1โ30 steps); replaces any active plan and returns planId + stepCount', parameters: ['goal, steps'] },
{ toolName: 'get_plan', description: 'Return the active plan with step statuses, completion percentage and elapsed time; null if no plan exists', parameters: [] },
{ toolName: 'update_plan_step', description: 'Update one plan step through the state machine (pendingโin_progressโdone; anyโblocked; blockedโpending) โ note required when blocking', parameters: ['planId, index, status, note (required if blocked)'] },
{ toolName: 'remove_plan', description: 'Remove a persisted plan from the working-state store; dry-run preview unless confirm=true โ for UNFINISHED plans only, completed ones are auto-removed by update_plan_step at final done', parameters: ['planId, confirm (required to remove)'] },
],
},
contextManagement: {
categoryTitle: '๐ง Context & Memory Tools',
tools: [
{ toolName: 'auto_summarize_context', description: 'Analyze recent session activity for patterns, frequent tool usage and decisions worth remembering; saves to persistent memory with global scope', parameters: ['session_events (+ config_changes)'] },
{ toolName: 'get_context_memory', description: 'Retrieve past context entries filtered by type (decision/pattern/configuration/file_change/error/summary); recencyรfrequency scoring surfaces recent, frequently accessed entries first', parameters: ['type (optional), limit (optional)'] },
{ toolName: 'search_context', description: 'Fuzzy text search across context entry titles, bodies and tags; expired session entries pruned before search (24 h TTL)', parameters: ['query, max_results (optional)'] },
{ toolName: 'context_summary', description: 'Statistical overview of persistent memory: total entries, type breakdowns and recent activity counts', parameters: [] },
{ toolName: 'delete_context_entry', description: 'Remove a specific context entry by unique ID without clearing the rest of the history', parameters: ['entry_id'] },
{ toolName: 'clear_context_memory', description: 'Clear all auto-saved context entries (โ ๏ธ irreversible; requires confirm=true)', parameters: ['confirm'] },
{ toolName: 'track_important_event', description: 'Manually record an event, decision or milestone with custom tags for categorized retrieval', parameters: ['title, content, tags (optional)'] },
{ toolName: 'save_session_summary', description: 'Save a structured session summary (accomplishments, pending tasks, decisions) compressed to bypass the 10k SDK limit', parameters: ['task_description (+ optional sections)'] },
{ toolName: 'get_session_summary', description: 'Retrieve the latest saved session summary with backward-compatible fallback for legacy data', parameters: [] },
{ toolName: 'save_memory', description: 'Persist a fact to .ai_toolbox_memory.msgpack for cross-session continuity (RAM + atomic disk copy)', parameters: ['fact'] },
{ toolName: 'get_memory', description: 'Retrieve all saved memory entries; local project file checked first, then persistent store', parameters: [] },
{ toolName: 'delete_memory', description: 'Remove a specific memory entry by its unique key (returned during save)', parameters: ['entry_id'] },
{ toolName: 'list_sessions', description: 'Browse saved session summaries with pagination and limit controls', parameters: ['limit (optional), offset (optional)'] },
{ toolName: 'search_sessions', description: 'Keyword search across stored session summaries, newest first', parameters: ['query, max_results (optional)'] },
{ toolName: 'clear_session_index', description: 'Remove all lightweight session index entries only โ summaries untouched (requires confirm=true)', parameters: ['confirm'] },
{ toolName: 'manage_projects', description: 'Manage the cross-project registry โ mutations AND reads: register / unregister / update / clear_all + info / list / search (single tool for ALL project-registry operations; destructive actions require confirm=true)', parameters: ['action (register|unregister|update|clear_all|info|list|search), project_name, working_dir_path (required for register/unregister/update/info), source_dirs (optional), query + max_results (for search), confirm (required for destructive actions)'] },
{ toolName: 'register_project', description: '[DEPRECATED alias of manage_projects(action="register")] Register or update a project in the cross-project registry by name + working-dir path (+ optional source dirs)', parameters: ['project_name, working_dir_path, source_dirs (optional)'] },
{ toolName: 'get_project_info', description: '[DEPRECATED alias of manage_projects(action="info")] Retrieve details of one registered project by its working directory path', parameters: ['working_dir_path'] },
{ toolName: 'list_projects', description: '[DEPRECATED alias of manage_projects(action="list")] List all registered projects with paths, last-accessed times and session counts', parameters: [] },
{ toolName: 'search_projects', description: '[DEPRECATED alias of manage_projects(action="search")] Search registered projects by name or path substring; lazy registry sync auto-registers projects found in session memory', parameters: ['query, max_results (optional)'] },
{ toolName: 'switch_context', description: 'Switch context storage to another project\'s working directory for memory/session recall (confirm-first per Step 0.7 banner)', parameters: ['target_working_dir_path'] },
{ toolName: 'restore_session_context', description: 'Restore EVERYTHING persisted from previous sessions of the current project in ONE read-only call: latest session summary + persisted plans + context entries (auto-checkpoints collapsed) + memory facts + recent-sessions index โ the single "read session mem" entry point', parameters: ['include_sessions_index, max_chars (both optional)'] },
{ toolName: 'memory_recall', description: 'ID-first READ-ONLY recall over the memory layer: mode=index lists compact id/title/date rows across context entries + memory facts + sessions; mode=fetch returns full records for up to 10 ids with self-describing miss reasons (summary_never_persisted is expected by design)', parameters: ['mode (index|fetch), kind, limit (index only) / ids โค10, per_item_chars (fetch only)'] },
],
},
vectorRag: {
categoryTitle: '๐ Vector RAG Tools',
tools: [
{ toolName: 'rag_index_files', description: 'Index a directory of TS/JS/MD/JSON/YAML/text files for semantic search with batch processing', parameters: ['directoryPath, filePattern (optional), batchSize (optional)'] },
{ toolName: 'rag_index_pdf', description: 'Index a PDF by page-bounded chunks (~300 words each) with page_number provenance โ OOM-safe bounded reads', parameters: ['filePath, chunkSize/overlap (optional)'] },
{ toolName: 'rag_index_docx', description: 'Extract DOCX text via mammoth into word-bounded chunks through the same embedding pipeline as PDF', parameters: ['filePath, chunkSize/overlap (optional)'] },
{ toolName: 'rag_index_xlsx', description: 'Index all sheets of a spreadsheet as row arrays with optional sheet-name prefix for traceability', parameters: ['filePath, chunkSize (optional), includeSheetNames (optional)'] },
{ toolName: 'rag_query_vector', description: 'Cosine-similarity query over the vector index returning top-k chunks with content and scores', parameters: ['query, topK (optional)'] },
{ toolName: 'rag_clear_index', description: 'Clear the entire vector index (requires confirm=true); useful before full reindexing', parameters: ['confirm'] },
{ toolName: 'rag_web_content', description: 'Fetch a URL and return only the text chunks relevant to the query โ bounded, deduplicated extraction', parameters: ['url, query'] },
],
},
uiGeneration: {
categoryTitle: '๐จ UI Generation Tools',
tools: [
{ toolName: 'generate_ui_component', description: 'Create interactive HTML/CSS/JS components (buttons, forms, tables) from a user description', parameters: [] },
{ toolName: 'render_and_preview_ui', description: 'Render components in-browser with live preview for rapid prototyping', parameters: [] },
{ toolName: 'extract_ui_data', description: 'Extract structured data from pages via CSS selectors/XPath returning tabular output back into the chat', parameters: [] },
],
},
httpClient: {
categoryTitle: '๐ก HTTP Client Tools',
tools: [
{ toolName: 'http_request', description: 'Generic GET/POST/PUT/DELETE/PATCH client with retry logic, timeout configuration and multipart upload โ SSRF-guarded (โ ๏ธ disabled by default)', parameters: ['url, method (+ options)'] },
{ toolName: 'http_get_json', description: 'GET requests expecting JSON responses with automatic parsing and optional schema validation', parameters: ['url (+ headers/options)'] },
{ toolName: 'http_post_json', description: 'POST requests with JSON payload, content-type auto-handling and auth token support; returns status code', parameters: ['url, body (+ options)'] },
],
},
utilities: {
categoryTitle: '๐ง Utility Tools',
tools: [
{ toolName: 'markdown_preview', description: 'Render a Markdown file to HTML and open it in the default browser', parameters: ['file_path'] },
{ toolName: 'get_repeat_tool_advice', description: 'Returns current repeat-tool reminder state and any active nudges; use to check if the model is in a repetition loop', parameters: ['toolName, args (optional)'] },
{ toolName: 'get_update_info', description: 'Read the current AI Toolbox update status without changing anything: installed version, whether a strictly-newer published version is known (24h-cached check against the hub .VERSION file), and its marketplace page URL when available - render it as a clickable link in chat', parameters: [] },
{ toolName: 'dismiss_update_reminder', description: 'Records "not now" for an update-reminder version so it stops re-notifying on every turn; that version stays quiet forever, strictly-newer releases still notify', parameters: ['version'] },
],
},
imageProcessing: {
categoryTitle: '๐ผ๏ธ Image Processing & Analysis Tools',
tools: [
{ toolName: 'image_to_text', description: 'OCR text extraction via Tesseract.js with confidence scores and language detection (50 MB max)', parameters: ['imagePath, language (optional)'] },
{ toolName: 'describe_image', description: 'Get image metadata: dimensions, format, size and timestamps for PNG/JPG/BMP/GIF/WebP/TIFF', parameters: ['imagePath'] },
{ toolName: 'screenshot_desktop', description: 'Capture a desktop screenshot cross-platform (GDI+/screencapture/ImageMagick)', parameters: ['outputPath/format/quality (optional)'] },
{ toolName: 'compare_images', description: 'Byte-level and dimension comparison of two images; exact-match status for identical encodings', parameters: ['image1Path, image2Path'] },
],
},
backupRestore: {
categoryTitle: '๐พ Backup & Restore Tools',
tools: [
{ toolName: 'create_backup', description: 'Create a compressed ZIP snapshot of the entire working directory in .ai_toolbox_backups/ (requires confirm=true)', parameters: ['confirm, destination/targetDirectory (optional)'] },
{ toolName: 'list_backups', description: 'List backups sorted by date or size with filename, path, size and creation timestamp', parameters: ['sortBy/limit (optional)'] },
{ toolName: 'restore_backup', description: 'Restore the working directory from a backup archive (โ ๏ธ overwrites all files; requires confirm=true)', parameters: ['backupFile, confirm'] },
{ toolName: 'delete_backup', description: 'Remove one specific backup file (โ ๏ธ irreversible; validates existence first)', parameters: ['backupFile, confirm'] },
{ toolName: 'cleanup_backups', description: 'List and optionally delete .bak edit backups โ dry-run by default, confirm required to delete', parameters: ['confirm (optional)'] },
{ toolName: 'restore_from_bak', description: 'Restore a file from its .bak backup created by file-modifying tools (replace_text_in_file, insert_at_line, append_file, delete_lines_in_file)', parameters: ['file_name'] },
{ toolName: 'list_available_bak_backups', description: 'Scan the current working directory for all .bak backup files created by file-modifying tools; use before restoring to see what is available', parameters: [] },
],
},
dataVisualization: {
categoryTitle: '๐ Data Visualization Tools',
tools: [
{ toolName: 'generate_chart', description: 'Render bar/line/pie/doughnut/scatter/radar charts to a PNG image from raw data; HTML fallback when the renderer is unavailable', parameters: ['type, data (+ title/colors/output_path optional)'] },
],
},
// โโ UNIFIED LANGUAGE v2 (26.10): runtime prompt texts โ values BYTE-IDENTICAL to the pre-v2 hardcoded
// literals in promptPreprocessor.ts / autoTracker.ts / documentTools.ts so 'en' output never drifts. โโ
runtimeTexts: {
workingDirDetected: 'โ ๏ธ WORKING DIRECTORY DETECTED',
workingDirMentionedLine: 'The user mentioned a directory path in their message:',
workingDirConfirmAsk: 'Please ask the user for confirmation before changing the working directory.',
workingDirExampleLabel: 'Example response:',
// Trailing spaces after ". " and "? " are deliberate โ they mirror the pre-v2 template byte-for-byte.
workingDirExampleText: "I noticed you mentioned the directory '{path}'. \nWould you like me to set this as your working directory? \nAll subsequent file operations will use this directory as the base.",
workingDirReplyHint: "Reply '{yes}' to confirm, or '{no}' to decline.",
workingDirOriginalMessageLabel: 'User\'s original message:',
projectDetectedTitle: 'โ ๏ธ REGISTERED PROJECT DETECTED',
projectFoundLead: 'I found a registered project matching your message:',
projectNameLabel: 'Project: "{name}"',
projectPathLabel: 'Path: {path}',
projectSwitchQuestion: 'Would you like me to switch your working directory to this project?',
sessionMemoryLoadedTitle: '๐ SESSION MEMORY LOADED',
previousSessionLabel: 'Previous session summary:',
checkpointWarningHeader: 'TOKEN LIMIT WARNING โ ACKNOWLEDGE BEFORE RESPONDING:',
checkpointActionRequiredLead: 'ACTION REQUIRED: Before responding to the user\'s message, explicitly acknowledge this token limit warning.',
checkpointIfConfirmedLine: 'If the user replied with one of the confirmation options shown in the warning above โ trigger the context management save tool now.',
checkpointIfDeclinedLine: 'If the user declined or did NOT give a confirmation reply โ ask them if they want to proceed with a context save.',
checkpointDoNotProceedLine: 'Do not proceed with normal conversation until this warning has been addressed.',
sessionWarningHead: 'โ ๏ธ SESSION WARNING: You have reached {pct}% of your token limit. It is highly recommended to save session memory before continuing.',
bufferedEventsLine: 'Auto-tracked events in buffer (will be saved with checkpoint): {count}',
contextSaveQuestion: "Do you want to proceed with a context save? Reply '{yes}' to trigger the session memory save, or '{no}' to continue.",
attachedFilesTitle: '๐ ATTACHED FILES AVAILABLE:',
attachedFilesLead: 'You have access to the following attached files. You can read them using the read_document tool by filename:',
attachmentErrorCrossRef: "Note: If this is an attached file, use the exact filename from the \"ATTACHED FILES AVAILABLE\" list.",
ragContextHeader: '--- RELEVANT DOCUMENT CONTEXT ---',
// v2 NEW (not present pre-v2): one-line per-turn answer-language instruction.
answerLanguageLine: 'Respond to the user in {language}.',
},
// โโ UNIFIED LANGUAGE v2 (26.10): settings-panel labels โ values copied from config.ts schematics;
// baked at boot time from the resolved language (step 4/5), reload-consistent via state file. โโ
uiLabels: {
languageRow: {
displayName: '๐ Language',
options: { auto: 'Automatic (follows LM Studio)', en: 'English', de: 'Deutsch (German)', es: 'Espaรฑol', zhCN: 'Simplified Chinese', zhTW: 'Traditional Chinese' },
},
godMode: { displayName: 'โกโ ๏ธ GOD MODE - Enable ALL Tools โ ๏ธโก', subtitle: 'WARNING: Activates every tool category instantly. Use with caution.', hint: 'When enabled, ALL individual toggles are bypassed and every tool is activated regardless of settings.' },
fileSystem: { displayName: '๐ File System Tools', hint: 'Enable file read/write/search operations' },
webSearch: { displayName: '๐ Web & Research Tools', hint: 'Enable DuckDuckGo/Wikipedia search' },
packageManage: { displayName: 'Package Management Tools', subtitle: 'npm/pip/cargo operations', hint: 'Enable package manager tools. Disabled by default for security.' },
gitOperations: { displayName: '๐ Git & GitHub Tools', subtitle: 'Version Control & API', hint: 'Enable git operations and GitHub API access.' },
gitAutoCommit: { displayName: '๐พ Git Auto-Commit', subtitle: 'โ๏ธ Part of Git & GitHub Tools', hint: 'Automatically commit changes after operations' },
defaultBranch: { displayName: '๐ฟ Default Branch', subtitle: 'โ๏ธ Part of Git & GitHub Tools', hint: 'Branch name for new repositories and git operations' },
databaseQueries: { displayName: '๐๏ธ Database Queries', hint: 'Enable read-only SQLite queries' },
documentParsing: { displayName: '๐ Document Parsing', hint: 'Enable PDF/DOCX document reading' },
backgroundCommands: { displayName: 'โณ Background Commands', hint: 'Enable long-running process tracking' },
imageProcessing: { displayName: '๐ผ๏ธ Image Processing Tools', subtitle: 'OCR, Screenshots & Comparison', hint: 'Enable image OCR (Tesseract.js), screenshot capture, and image comparison tools.' },
httpClient: { displayName: '๐ HTTP Client Tools', subtitle: 'Generic REST API Client', hint: 'Enable generic HTTP client for making requests to any REST API (GET, POST, PUT, DELETE).' },
vectorRag: { displayName: '๐ Vector RAG / Semantic Search', subtitle: 'Semantic Document Search', hint: 'Enable semantic search with vector embeddings for intelligent document retrieval.' },
uiGeneration: { displayName: '๐จ Interactive UI Generation Tools', subtitle: 'Generate and render interactive UI components', hint: 'Enable tools for generating HTML/CSS/JS components (buttons, forms, charts, dashboards) and rendering them in the browser.' },
contextManagement: { displayName: '๐ง Auto-Context Management Tools', subtitle: 'Automatic session tracking and memory management', hint: 'Enable tools for automatically saving important decisions, patterns, and configurations to persistent memory.' },
documentRAG: { displayName: '๐ Document RAG / Chat with Files', subtitle: 'Enable file indexing and semantic search for chat', hint: 'Attach documents to your chat messages. The plugin will automatically retrieve relevant content from attached files using semantic search.' },
textProcessing: { displayName: '๐ Text Processing Tools (sed/awk equivalents)', subtitle: 'Regex-based text transformations and field extraction', hint: 'Enable tools for bulk text replacement, pattern matching, and structured data extraction without shell dependencies.' },
refactorCode: { displayName: '๐ง AST Code Refactoring Tools', subtitle: 'Rename, move, extract functions & clean unused imports', hint: 'Enable AST-based code refactoring tools (rename_identifier, move_function, extract_function, unused_import_cleanup).' },
utility: { displayName: '๐ ๏ธ Utility & Maintenance Tools', subtitle: 'Backup, chart generation, markdown preview, line operations', hint: 'Enable utility tools (create_backup, list_backups, restore_backup, delete_backup, cleanup_backups, generate_chart, markdown_preview).' },
taskPlanning: { displayName: '๐ Task Planning Tools', subtitle: 'Structured multi-step workflow tools', hint: 'Enable create_plan, update_plan_step, and get_plan tools for structured task execution.' },
clusterAwareToolOrder: { displayName: '๐งญ Cluster-Aware Tool Ordering', subtitle: 'Sort exposed tools by priority tier + module centrality instead of alphabetically.', hint: 'Uses the static ARCHITECTURE.md dependency graph (no fs I/O). Disable to restore legacy alphabetical order.' },
retrievalLimit: { displayName: '๐ข Retrieval Limit', subtitle: 'Max chunks to return per query', hint: 'Maximum number of relevant document chunks to retrieve for each query.' },
retrievalAffinityThreshold: { displayName: '๐ฏ Retrieval Affinity Threshold', subtitle: 'Minimum relevance score (0-1)', hint: 'Chunks below this similarity score will be filtered out. Lower = more results but potentially less relevant.' },
executionJavaScript: { displayName: 'โก Allow JavaScript Execution', subtitle: "Enables the 'run_javascript' tool", hint: 'WARNING: code runs on your machine.' },
executionPython: { displayName: '๐ Allow Python Execution', subtitle: "Enables the 'run_python' tool", hint: 'WARNING: code runs on your machine.' },
executionTerminal: { displayName: '๐ป Allow Terminal Execution', subtitle: "Enables the 'run_in_terminal' tool", hint: 'Opens real terminal windows.' },
executionShell: { displayName: '๐ง Allow Shell Command Execution', subtitle: "Enables the 'execute_command' tool", hint: 'WARNING: commands run on your machine.' },
executionTests: { displayName: '๐งช Allow Test Execution', subtitle: "Enables the 'run_tests' tool", hint: 'WARNING: runs npm jest / pytest / go test โ can install packages and execute code.' },
searchFallbackChain: { displayName: '๐ Search Fallback Chain', hint: 'Primary search engine. Auto-falls back to others if unavailable.' },
safesearch: { displayName: '๐ก๏ธ Safe Search', options: { off: 'Off', moderate: 'Moderate', strict: 'Strict' } },
browserAutomation: { displayName: '๐ฅ๏ธ Browser Automation Tools', subtitle: 'Headless browser control & automation', hint: 'Enable Puppeteer-based headless browser automation for web scraping, testing, and UI interaction.' },
browserTimeout: { displayName: 'โฑ๏ธ Browser Timeout', subtitle: 'โ๏ธ Part of Browser Automation Tools', hint: 'Maximum time (ms) to wait for browser operations before timing out.' },
headlessMode: { displayName: '๐ป Headless Mode', subtitle: 'โ๏ธ Part of Browser Automation Tools', hint: 'Run browser without GUI (recommended for automation).' },
pathValidationEnabled: { displayName: '๐ Path Validation', hint: 'Prevent directory traversal attacks' },
binaryFileDetection: { displayName: '๐ Binary File Detection', hint: 'Detect binary files via null byte check' },
regexReDoSProtection: { displayName: '๐ก๏ธ ReDoS Protection', hint: 'Protect against regex denial-of-service' },
statePersistenceEnabled: { displayName: '๐ฝ State Persistence', hint: 'Persist tool execution state between sessions' },
notificationsEnabled: { displayName: '๐ Desktop Notifications', hint: 'Show system notifications' },
updateCheckEnabled: { displayName: '๐ Plugin Update Check', subtitle: 'Quiet LM Studio hub .VERSION check โ no new tools, no OS permissions', hint: "Once per day the plugin quietly checks the published LM Studio hub .VERSION file for a strictly-newer release. If one exists it notifies via desktop toast (Desktop Notifications ON) or a single in-chat line (OFF). Silent when you are up to date or on a dismissed version; state survives reinstalls." },
temporalAwareness: { displayName: 'โฐ Temporal Awareness', subtitle: 'Injects current date/time into every message', hint: 'Enables the AI to know the current time.' },
dateFormatStyle: { displayName: '๐
Date Format Style', options: { standard: 'Standard ([Zeit: ...])', heuteIst: 'HEUTE IST Mode (Prominent)' } },
contextGuardEnabled: { displayName: '๐ง ContextGuard Token Management', subtitle: 'Automatic history compression & smart reading', hint: 'Automatically compresses chat history when token limit is reached. Enables smart file reading and terminal output filtering.' },
contextGuardCompressionPercent: { displayName: '๐ Compression Trigger (% of Context Window)', subtitle: 'โ๏ธ ContextGuard Setting', hint: "History compression triggers when context usage reaches this percentage of the active model's context window. If LM Studio reports the model's real window it is used; otherwise a built-in 30k fallback applies." },
contextGuardAgenticDensity: { displayName: '๐ข Agentic Chars-per-Token Density', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Chars per token used to estimate tokens from character length (agentic mix of prose + tool output; live-measured band ~3.2-3.4 โ default 3.6 is owner-set above that band). Higher = denser content = fewer estimated tokens; lower estimates more and triggers compaction earlier.' },
contextGuardForceSummaryOnCompress: { displayName: '๐พ Force Session-Memory Save Before Compression', subtitle: 'โ๏ธ ContextGuard Setting', hint: "When context reaches your Compression Trigger, a structured session summary (task description, accomplishments, pending tasks) is generated with the Summary Model and persisted BEFORE history is compressed. Non-fatal: on any failure the previous telemetry checkpoint still runs." },
contextGuardSmartReading: { displayName: '๐ Smart File Reading', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Extracts keywords from user queries to read only relevant portions of files. Saves tokens and speeds up responses.' },
contextGuardSummaryModel: { displayName: '๐ค Summary Model Name', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'LM Studio model name used for history summarization. Leave empty to use your current chat model.' },
contextGuardTerminalFilterEnabled: { displayName: '๐ Terminal Output Filtering', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Automatically truncates long terminal outputs to save tokens.' },
contextGuardTerminalFilterLength: { displayName: '๐ Max Terminal Output Length', subtitle: 'โ๏ธ ContextGuard Setting', hint: 'Maximum characters before terminal output is truncated and summarized.' },
compactionEnabled: { displayName: 'โ๏ธ Compaction Pre-Summarization Pruning', subtitle: 'โ๏ธ C Compaction Family', hint: 'Before history is summarized, tool payloads above the byte budget are replaced by a head/tail preview plus an opaque locator; the full result stays stored verbatim in .ai_toolbox/compaction/.' },
compactionMaxResultBytes: { displayName: '๐ Max Tool Result Before Pruning (bytes)', subtitle: 'โ๏ธ C Compaction Family', hint: 'Byte budget per tool-result payload in chat history. Results above this are pruned to preview + locator before summarization (verbatim copy stored on disk).' },
contextUsageFooter: { displayName: '๐ Context Usage Footer in Tool Results', subtitle: 'โ๏ธ LLM-side Limit Awareness', hint: "Once projected context usage crosses half of the model's window, every tool result gains a short footer like [ctx ~48.3k/64k = 76%] โ appended to string results and added as an additive ctx_footer field on plain-object results (every registered tool returns one) โ so the model always sees current token usage. At >=90% a near-limit advisory is added." },
autoTrackingEnabled: { displayName: '๐ค Auto-Tracking Enabled', subtitle: 'Automatically remember important events', hint: 'Silently tracks decisions, completions, and bug fixes in the background. Enabled by default.' },
autoTrackTokenThreshold: { displayName: 'Auto-Track Token Threshold', subtitle: 'Auto-Tracking Setting', hint: 'Trigger session memory save when token usage reaches this percentage (default: 75%). Helps prevent context overflow.' },
autoTrackDecisions: { displayName: '๐ Track Decisions Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "I decided", "conclusion", "going with".' },
autoTrackCompletions: { displayName: 'โ
Track Completions Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "successfully completed", "finished implementing".' },
autoTrackErrors: { displayName: '๐ Track Bug Fixes Automatically', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Detects phrases like "fixed the bug", "resolved the issue".' },
autoSummaryInterval: { displayName: '๐ Session Summary Interval', subtitle: 'โ๏ธ Auto-Tracking Setting', hint: 'Number of messages between automatic session summaries. Higher = less frequent.' },
// Budget-Guard-Arc i18n (06.11, owner rule "alle Tool-Beschreibungen IMMER รผbersetzt"): values below are byte-pinned to the config.ts fallback literals.
budgetGuardEnabled: { displayName: '๐ก๏ธ Budget Guard (context-limit protection)', hint: 'Master switch for the deterministic context budget guard โ M1 pre-call read gate, M2 budget-aware spill cap, M3 auto-persist at 85% edge. ON by default (06.11); turn OFF to restore byte-identical legacy behavior.' },
budgetGuardAdvisoryThresholdPct: { displayName: '๐ข Budget Guard Advisory Threshold (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M1 pre-call read gate: above this % of the context limit, read tools return a self-describing budget advisory instead of the full payload.' },
budgetGuardSpillThresholdPct: { displayName: 'โ๏ธ Budget Guard Spill Threshold (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M2 spill cap: tool results are spilled to disk beyond this % of the limit (the stricter of absolute vs budget-relative bound wins).' },
budgetGuardAutopauseThresholdPct: { displayName: '๐พ Budget Guard Auto-Persist Edge (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'M3: automatic session-memory persist at this % edge, max once per session.' },
budgetGuardSafetyMarginPct: { displayName: '๐งฎ Budget Guard Safety Margin (%)', subtitle: 'โ๏ธ Budget Guard Setting', hint: 'Reserve kept out of the context limit for M2 budget math โ limit ร (1 โ margin/100); default 8 โ spill at 92 %.' },
},
general: {
pluginName: 'AI Toolbox Plugin',
enabledTools: 'Enabled Tools:',
disabledTools: 'Disabled Tools:',
errorPrefix: 'Error:',
successPrefix: 'Success:',
yesWord: 'YES',
noWord: 'NO',
},
};