${runCmd}?
`;
area.classList.add('visible');
const allowBtn = document.getElementById('cmd-confirm-allow');
const denyBtn = document.getElementById('cmd-confirm-deny');
const onAllow = () => { area.classList.remove('visible'); area.innerHTML = ''; this.executeCommand(runCmd); };
const onDeny = () => { area.classList.remove('visible'); area.innerHTML = ''; this.print('Dismissed.', 'text-muted'); };
allowBtn.addEventListener('click', onAllow);
denyBtn.addEventListener('click', onDeny);
allowBtn.__allow = onAllow;
denyBtn.__deny = onDeny;
}
showConfirmationBar(desc) {
const area = document.getElementById('ai-confirm-area');
if (!area) {
this.print('Confirmation UI unavailable — command blocked.', 'error');
return;
}
this._pendingCommandDesc = desc;
area.innerHTML = `
⚠️ ${desc}
Type: cmd-allow or cmd-deny
`;
area.classList.add('visible');
const allowBtn = document.getElementById('cmd-confirm-allow');
const denyBtn = document.getElementById('cmd-confirm-deny');
const onAllow = () => {
this._resolveCmdConfirm(true);
};
const onDeny = () => {
this._resolveCmdConfirm(false);
};
allowBtn.addEventListener('click', onAllow);
denyBtn.addEventListener('click', onDeny);
allowBtn.__allow = onAllow;
denyBtn.__deny = onDeny;
}
_resolveCmdConfirm(approved) {
const area = document.getElementById('ai-confirm-area');
if (area) {
area.classList.remove('visible');
area.innerHTML = '';
}
if (approved) {
this.print(`Allowed: ${this._pendingCommandDesc || 'command'}`, 'success');
if (this._pendingCommand) {
const fn = this._pendingCommand;
this._pendingCommand = null;
this._pendingCommandDesc = null;
fn();
}
} else {
this.print(`Denied: ${this._pendingCommandDesc || 'command'}`, 'warning');
this._pendingCommand = null;
this._pendingCommandDesc = null;
}
}
_loadHistory() {
try {
const saved = localStorage.getItem('webx11_terminal_output');
if (!saved) return;
const entries = JSON.parse(saved);
if (!Array.isArray(entries)) return;
this._historyBuffer = entries.slice(-this._historyMaxLines);
// Check localStorage quota warning
let quotaWarned = false;
try {
const testKey = '_quota_test_' + Date.now();
localStorage.setItem(testKey, 'x'.repeat(1024));
localStorage.removeItem(testKey);
} catch (e) {
quotaWarned = true;
}
// Lazy-load history: render first 20 immediately, batch the rest
const batchSize = 20;
const toRender = entries.slice(-this._historyMaxLines);
const initial = toRender.slice(0, batchSize);
for (const entry of initial) {
const line = document.createElement('div');
line.className = `output-line ${entry.t || ''}`;
line.textContent = entry.l || '';
this.outputContainer.appendChild(line);
}
if (toRender.length > batchSize) {
const remaining = toRender.slice(batchSize);
const MAX_BATCHES = 50;
const doBatch = (index, batchCount) => {
if (index >= remaining.length || batchCount >= MAX_BATCHES) {
this.scrollToBottom();
return;
}
requestAnimationFrame(() => {
const end = Math.min(index + batchSize, remaining.length);
for (let i = index; i < end; i++) {
const line = document.createElement('div');
line.className = `output-line ${remaining[i].t || ''}`;
line.textContent = remaining[i].l || '';
this.outputContainer.appendChild(line);
}
doBatch(end, (batchCount || 0) + 1);
});
};
doBatch(0, 0);
} else {
this.scrollToBottom();
}
if (quotaWarned) {
const warnLine = document.createElement('div');
warnLine.className = 'output-line warning';
warnLine.textContent = '⚠ localStorage is near quota — history may be incomplete';
this.outputContainer.appendChild(warnLine);
}
} catch (e) {
// Silently ignore corrupt history data
}
}
_saveHistory() {
if (this._historySaveTimer) clearTimeout(this._historySaveTimer);
this._historySaveTimer = setTimeout(() => {
this._historySaveTimer = null;
try {
const slice = this._historyBuffer.slice(-this._historyMaxLines);
localStorage.setItem('webx11_terminal_output', JSON.stringify(slice));
} catch (e) {
// Silently ignore storage errors (e.g. quota exceeded)
}
}, 3000);
}
_saveCommandHistory() {
try {
localStorage.setItem('webx11_command_history', JSON.stringify(this.history));
} catch (e) {
// Silently ignore storage errors
}
}
_trimOutput() {
const container = this.outputContainer;
while (container.children.length > this.MAX_OUTPUT_LINES) {
container.removeChild(container.firstChild);
}
}
toggleExpand() {
const container = document.getElementById('terminal-container');
if (!container) return;
container.classList.toggle('terminal-expanded');
const on = container.classList.contains('terminal-expanded');
this.print(on ? 'Terminal expanded' : 'Terminal compact', 'text-muted');
}
toggleSystemMessages(arg) {
let desired;
if (arg === 'on') desired = true;
else if (arg === 'off') desired = false;
else desired = !this._showSystemMessages;
this._showSystemMessages = desired;
this._saveTerminalConfig();
this.print('System messages ' + (desired ? 'on' : 'off'), 'text-muted');
}
clearOutput() {
if (this.outputContainer) {
this.outputContainer.innerHTML = '';
}
this._historyBuffer = [];
if (this._historySaveTimer) {
clearTimeout(this._historySaveTimer);
this._historySaveTimer = null;
}
try { localStorage.removeItem('webx11_terminal_output'); } catch (e) {}
}
markDirty() {
this._dirty = true;
}
_initAutoSave() {
if (this._autoSaveTimer) return;
this._autoSaveTimer = setInterval(() => {
// Auto-trim on memory pressure
try {
if (performance.memory && performance.memory.usedJSHeapSize > 80 * 1048576) {
const oldMax = this.MAX_OUTPUT_LINES;
this.MAX_OUTPUT_LINES = performance.memory.usedJSHeapSize > 120 * 1048576 ? 50 : 100;
this._trimOutput();
this.MAX_OUTPUT_LINES = oldMax;
this.print('🧹 Terminal trimmed (memory: ' + (performance.memory.usedJSHeapSize / 1048576).toFixed(0) + ' MB)', 'text-muted');
}
} catch (e) {}
if (!this._dirty) return;
this._autoSaveSession();
this._dirty = false;
}, 180000);
window.addEventListener('beforeunload', () => {
// Flush session before tab closes — avoids losing up to 3min of output on crash/close
try { this._autoSaveSession(); } catch (e) {}
if (this._autoSaveTimer) {
clearInterval(this._autoSaveTimer);
this._autoSaveTimer = null;
}
});
}
_autoSaveSession() {
try {
this.fs.mkdirRecursive('_sessions');
const snapshot = {
type: 'session',
version: 2,
savedAt: new Date().toISOString(),
currentPath: this.fs.currentPath,
terminalLines: this._historyBuffer.slice(-50)
};
const snapshotJson = JSON.stringify(snapshot);
this.fs.writeFile('_sessions/_auto.json', snapshotJson);
try {
const ctx = localStorage.getItem('webx11_ai_context');
if (ctx) this.fs.writeFile('_sessions/_auto-context.json', ctx);
} catch (e) {}
} catch (e) {
// Silently handle auto-save failures
}
}
_autoRestoreSession() {
try {
const lastReset = parseInt(localStorage.getItem('webx11_last_reset') || '0', 10);
this.fs.mkdirRecursive('_sessions');
const autoSession = this.fs.readFile('_sessions/_auto.json');
if (autoSession) {
const data = JSON.parse(autoSession);
const savedAt = data.savedAt || 0;
// v4.5.47: skip restoring backups created before the last reset
if (lastReset && savedAt && savedAt < lastReset) {
this.fs.deleteFile('_sessions/_auto.json');
this.fs.deleteFile('_sessions/_auto-context.json');
this.print('↻ Skipped stale auto-session backup (older than last reset)', 'info');
return;
}
if (data.version === 2) {
// v2: metadata-only restore (VFS is persisted independently in localStorage)
this.fs.currentPath = data.currentPath || [];
this.fs.saveToStorage();
this.updatePrompt();
this.print('↻ Auto-restored session from ' + (data.savedAt ? new Date(data.savedAt).toLocaleTimeString() : 'recent'), 'success');
// Optionally re-render last few terminal lines
if (data.terminalLines && Array.isArray(data.terminalLines)) {
data.terminalLines.slice(-10).forEach(line => {
const text = typeof line === 'string' ? line : (line.l || '');
this.print(text, typeof line === 'object' ? (line.t || '') : '');
});
}
try {
const aiCtx = this.fs.readFile('_sessions/_auto-context.json');
if (aiCtx) {
localStorage.setItem('webx11_ai_context', aiCtx);
}
} catch (e) {}
this.fs.deleteFile('_sessions/_auto.json');
this.fs.deleteFile('_sessions/_auto-context.json');
} else if (data && data.fsRoot) {
// v1: full VFS restore (legacy)
this.fs.root = data.fsRoot;
this.fs.currentPath = data.currentPath || [];
this.fs.saveToStorage();
this.updatePrompt();
this.print('↻ Auto-restored session from ' + (data.savedAt ? new Date(data.savedAt).toLocaleTimeString() : 'recent'), 'success');
try {
const aiCtx = this.fs.readFile('_sessions/_auto-context.json');
if (aiCtx) {
localStorage.setItem('webx11_ai_context', aiCtx);
}
} catch (e) {}
this.fs.deleteFile('_sessions/_auto.json');
this.fs.deleteFile('_sessions/_auto-context.json');
}
}
} catch (e) {
// Silent on first boot — no auto-session yet
}
}
scrollToBottom() {
this.outputContainer.scrollTop = this.outputContainer.scrollHeight;
}
_getPathSuggestions(partial, type) {
// type: 'dir' = dirs only, 'file' = files + dirs (dirs get trailing /), 'session' = _sessions/*.json
if (type === 'session') {
this.fs.mkdirRecursive('_sessions');
const all = this.fs.ls('_sessions');
const names = all
.filter(e => e.type === 'file' && e.name.endsWith('.json'))
.map(e => e.name.replace('.json', ''));
return partial
? names.filter(n => n.startsWith(partial)).map(n => n)
: names;
}
// Resolve the partial path to determine which directory to list
let dirPath = '';
let filterPrefix = '';
let entries = [];
let prefix = '';
if (partial.includes('/')) {
// "dir1/dir2" or "dir1/dir2/" or "dir1/"
const lastSlash = partial.lastIndexOf('/');
const beforeSlash = partial.slice(0, lastSlash); // dir1
filterPrefix = partial.slice(lastSlash + 1); // dir2 (or '' if ends with /)
// Resolve "dir1" relative to current path
const resolvedDir = this.fs._resolveDir(beforeSlash || '.');
if (!resolvedDir) return [];
entries = Object.keys(resolvedDir.content).map(name => ({
name,
type: resolvedDir.content[name].type,
size: resolvedDir.content[name].content ? resolvedDir.content[name].content.length : 0
}));
prefix = beforeSlash + '/';
} else {
// No slash — list current dir
entries = this.fs.ls();
filterPrefix = partial;
prefix = '';
}
if (type === 'dir') {
return entries
.filter(e => e.type === 'dir' && e.name.startsWith(filterPrefix))
.map(e => prefix + e.name + '/');
}
// 'file' — show files + dirs (dirs with trailing /)
return entries
.filter(e => e.name.startsWith(filterPrefix))
.map(e => e.type === 'dir' ? prefix + e.name + '/' : prefix + e.name);
}
// ── Enum autocomplete from commandsMeta ──
_tryEnumAutocomplete(cmdName) {
this.suggestions = [];
for (const modName in this.moduleManager.modules) {
const mod = this.moduleManager.modules[modName];
const meta = mod.commandsMeta && mod.commandsMeta[cmdName];
if (meta && meta.argType === 'enum' && meta.enumFn && typeof mod[meta.enumFn] === 'function') {
const values = mod[meta.enumFn]();
if (Array.isArray(values) && values.length > 0) {
this.suggestions.push(...values);
return true;
}
}
}
return false;
}
showAutocomplete() {
if (!this.moduleManager || !this.security) return;
const input = this.inputField.value;
// Always clear dropdown innerHTML at the start — prevents stale state from prior input
this.dropdown.innerHTML = '';
this.suggestions = [];
this.selectedSuggestion = -1;
this._isCdAutocomplete = false;
const trimmed = input.trim();
const commands = this.moduleManager.getAllCommands() || {};
// Merge built-in internals into autocomplete (they're handled via if-chain, not module commands)
for (const c of this.security.commandMeta.keys()) {
if (!(c in commands)) commands[c] = 'builtin';
}
if (input.trim().length === 0) {
this.hideAutocomplete();
return;
}
const parts = input.split(' ');
const cmdPart = parts[0].toLowerCase();
const lowerInput = input.toLowerCase();
// Expanded command lists for autocomplete (fallback when commandsMeta lacks argType)
// NOTE: Commands with argType:'enum' in their commandsMeta are handled by _tryEnumAutocomplete
// and should NOT be in these hardcoded lists (the enum check is called BEFORE these).
const fileArgCommands = ['cat', 'preview', 'rm', 'rmdir', 'edit', 'view', 'cp', 'mv', 'touch', 'put', 'run', 'chmod', 'gzip', 'gunzip', 'encrypt', 'decrypt', 'download', 'webdav-backup', 'webdav-restore', 'webdav-upload', 'webdav-download', 'webdav-list', 'trash', 'ls-trash', 'upload', 'vfs-export', 'vfs-import', 'files', 'preview', 'skill-view', 'skill-create', 'skill-patch', 'skill-delete', 'skill-sync', 'webdav-ls', 'webdav-push', 'webdav-pull', 'webdav-rm', 'webdav-mkdir', 'webdav-rename', 'webdav-move', 'webdav-config', 'nvfs-index', 'nvfs-resolve', 'nvfs-tree'];
const dirArgCommands = ['ls', 'cd', 'mkdir', 'rmdir', 'upload', 'webdav-ls', 'webdav-mkdir', 'vfs-export', 'vfs-import', 'skill-create'];
const sessionArgCommands = ['session-load', 'session-delete', 'session-export', 'session-save', 'session-list', 'session-import', 'session-new'];
const pathArgCommands = ['cat', 'preview', 'rm', 'edit', 'view', 'cp', 'mv', 'touch', 'put', 'run', 'chmod', 'gzip', 'gunzip', 'encrypt', 'decrypt', 'download', 'webdav-backup', 'webdav-restore', 'webdav-upload', 'webdav-download', 'webdav-list', 'ls', 'cd', 'mkdir', 'rmdir', 'cat', 'preview'];
// Collect commands that take arguments from ext module metadata
const extFileCmds = new Set();
const extDirCmds = new Set();
for (const modName in this.moduleManager.modules) {
const mod = this.moduleManager.modules[modName];
if (mod.commandsMeta) {
for (const [c, meta] of Object.entries(mod.commandsMeta)) {
if (meta.argType === 'file' || meta.argType === 'path') extFileCmds.add(c);
if (meta.argType === 'dir') extDirCmds.add(c);
}
}
}
// If we have more than one word, we're past the command name — autocomplete file/dir/session names
if (parts.length > 1 && parts[1].length > 0) {
const partial = parts.slice(1).join(' ');
const partialTrimmed = partial.trim();
if (partialTrimmed === '..') {
this.hideAutocomplete();
return;
}
if (this._tryEnumAutocomplete(cmdPart)) {
this.suggestions = this.suggestions.filter(s => s.startsWith(partialTrimmed));
} else if (sessionArgCommands.includes(cmdPart)) {
this.suggestions = this._getPathSuggestions(partialTrimmed, 'session');
} else if (dirArgCommands.includes(cmdPart) || extDirCmds.has(cmdPart)) {
this.suggestions = this._getPathSuggestions(partialTrimmed, 'dir');
this._isCdAutocomplete = true;
} else if (fileArgCommands.includes(cmdPart) || extFileCmds.has(cmdPart)) {
this.suggestions = this._getPathSuggestions(partialTrimmed, 'file');
} else {
// Fallback: show files anyway
this.suggestions = this._getPathSuggestions(partialTrimmed, 'file');
}
this._autocompletePrefix = cmdPart + ' ';
if (this.suggestions.length > 0) {
this.renderAutocomplete();
} else {
this.hideAutocomplete();
}
return;
}
// Just typed a space after command — show all matching entries
if (parts.length > 1) {
if (this._tryEnumAutocomplete(cmdPart)) {
// suggestions already populated
} else if (sessionArgCommands.includes(cmdPart)) {
this.suggestions = this._getPathSuggestions('', 'session');
} else if (dirArgCommands.includes(cmdPart) || extDirCmds.has(cmdPart)) {
this.suggestions = this._getPathSuggestions('', 'dir');
this._isCdAutocomplete = true;
} else if (fileArgCommands.includes(cmdPart) || extFileCmds.has(cmdPart)) {
this.suggestions = this._getPathSuggestions('', 'file');
} else {
// Fallback: show files
this.suggestions = this._getPathSuggestions('', 'file');
}
this._autocompletePrefix = cmdPart + ' ';
if (this.suggestions.length > 0) {
this.renderAutocomplete();
} else {
this.hideAutocomplete();
}
return;
}
// Directory autocomplete for bare 'cd ' (no partial yet)
if (lowerInput.startsWith('cd ')) {
this.suggestions = this._getPathSuggestions('', 'dir');
if (this.suggestions.length > 0) {
this._isCdAutocomplete = true;
this.renderAutocomplete();
} else {
this.hideAutocomplete();
}
return;
}
// Command name autocomplete (first word only) — also clears any stale prefix
this._autocompletePrefix = '';
for (const cmd in commands) {
if (cmd.startsWith(cmdPart) && cmd !== cmdPart) {
this.suggestions.push(cmd);
}
}
if (this.suggestions.length > 0) {
this.renderAutocomplete();
} else {
this.hideAutocomplete();
}
}
renderAutocomplete() {
this.dropdown.innerHTML = '';
this.suggestions.forEach((item, index) => {
const div = document.createElement('div');
div.className = `autocomplete-item ${index === this.selectedSuggestion ? 'selected' : ''}`;
div.innerHTML = this._isCdAutocomplete
? `${item}`
: `${item}`;
div.onclick = () => {
if (this._autocompletePrefix) {
this.inputField.value = this._autocompletePrefix + item;
} else if (this._isCdAutocomplete) {
this.inputField.value = 'cd ' + item;
} else {
this.inputField.value = item + ' ';
}
this.hideAutocomplete();
this.inputField.focus();
};
this.dropdown.appendChild(div);
});
this.dropdown.style.display = 'block';
}
updateAutocompleteDisplay() {
const items = this.dropdown.querySelectorAll('.autocomplete-item');
items.forEach((item, index) => {
item.classList.toggle('selected', index === this.selectedSuggestion);
});
if (this.selectedSuggestion >= 0 && this.suggestions[this.selectedSuggestion]) {
if (this._autocompletePrefix) {
this.inputField.value = this._autocompletePrefix + this.suggestions[this.selectedSuggestion];
} else if (this._isCdAutocomplete) {
this.inputField.value = 'cd ' + this.suggestions[this.selectedSuggestion];
} else {
this.inputField.value = this.suggestions[this.selectedSuggestion] + ' ';
}
}
}
hideAutocomplete() {
this.dropdown.style.display = 'none';
this.suggestions = [];
this.selectedSuggestion = -1;
this._isCdAutocomplete = false;
this._autocompletePrefix = '';
}
loadBuiltInModules() {
this._safeRegister('SystemModule', 'system');
this._safeRegister('FileSystemModule', 'filesystem');
this._safeRegister('ModuleManagerModule', 'module manager');
this._safeRegister('OllamaModule', 'ollama');
this._safeRegister('BillingModule', 'billing');
this._safeRegister('SearXNGModule', 'searxng search');
this._safeRegister('ConfigManagerModule', 'config');
this._safeRegister('WebX11AIAssistantModule', 'AI assistant');
this._safeRegister('WebFetcherModule', 'web fetcher');
this._safeRegister('WebXAIAliasModule', 'AI alias');
this._safeRegister('SecretVault', 'secret vault');
this.reloadPersistedModules();
this._safeRegister('ChatStudioModule', 'chat studio');
this._safeRegister('AgentRegistryModule', 'agent registry');
this._safeRegister('LeaseModule', 'lease system');
this._safeRegister('OrchestratorModule', 'orchestrator');
this._safeRegister('NeuralVFSModule', 'neural VFS');
this._safeRegister('SandboxModule', 'sandbox');
this._safeRegister('MemoryGraphModule', 'memory graph');
this._safeRegister('PredictorModule', 'predictor');
this._safeRegister('WorldModelModule', 'world model');
this._safeRegister('ServerMonitorModule', 'server monitor');
this._safeRegister('SmartContextModule', 'smart context');
this._safeRegister('SimpleGUIModule', 'simple GUI builder');
this._safeRegister('DebugSupervisorModule', 'debug supervisor');
// 2026-11-12 — UI shell re-enabled BEHIND AN OPT-IN FLAG (plan Task 9, v4.6.162).
// v4.6.157 had disabled it outright after crash reports; the crash itself was never
// reproduced (F2) and the two defects the investigation did find (F3 413, F4 arg
// coercion) were fixed instead. So the six modes come back, but only for a visitor
// who asks for them: `?ui=1` on the URL or localStorage['webx11_ui_experimental']=1.
// Without the flag nothing changes: the shell is not registered, no mode can mount
// (the ui-*.js files begin with `if (!terminal.uiShell) return;`), no first-run
// picker appears, and `ui` does not exist. Guard: admin/scripts/verify-newos4-ui-gate.py
// (cron ui-gate-guard) fails if the gate is lost or the bare call returns.
const _uiExp = (function () {
try {
// ANY `?ui=