sapper-iq 1.3.2 → 1.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapper-iq",
-  "version": "1.3.2",
+  "version": "1.4.1",
   "description": "AI-powered development assistant that executes commands and builds projects",
   "main": "sapper.mjs",
   "bin": {

package/sapper-ui.mjs

@@ -313,6 +313,12 @@ function buildHTML() {
   #indexPanel .chip .cp { max-width: 160px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   #indexPanel .chip .cx { cursor: pointer; opacity: .55; padding: 0 3px; font-size: 12px; }
   #indexPanel .chip .cx:hover { opacity: 1; color: var(--red); }
+  #indexPanel .chip .cdeep { cursor: pointer; font-size: 9px; line-height: 1;
+    padding: 1px 5px; border-radius: 7px; border: 1px solid var(--border2);
+    background: rgba(255,255,255,.04); color: var(--muted); text-transform: uppercase;
+    letter-spacing: .04em; user-select: none; }
+  #indexPanel .chip .cdeep:hover { color: var(--fg); border-color: var(--accent); }
+  #indexPanel .chip .cdeep.on { color: #fff; background: var(--accent); border-color: var(--accent); }
   #indexPanel .empty { padding: 8px 10px; color: var(--dim); font-style: italic; }
   #indexPanel .icmt { display: block; margin: 4px 10px 8px; width: calc(100% - 20px);
     box-sizing: border-box; background: var(--panel); color: var(--fg);
@@ -389,6 +395,32 @@ function buildHTML() {
   .modal .actions button.primary:hover { filter: brightness(1.1); }
   .modal .actions button.danger { background: var(--red); color: #fff; border-color: var(--red); }
 
+  /* ─── Terminal Settings modal ─── */
+  #tsModal .modal { width: 520px; max-height: 92vh; overflow-y: auto; }
+  .ts-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 0 18px; }
+  .ts-full { grid-column: 1 / -1; }
+  .ts-row { display: flex; align-items: center; gap: 8px; margin: 2px 0 6px; }
+  .ts-row input[type=range] { flex: 1; accent-color: var(--accent); cursor: pointer; }
+  .ts-row .tsv { min-width: 34px; text-align: right; font-size: 11px;
+    color: var(--accent); font-family: ui-monospace,'SF Mono',monospace; }
+  .ts-row select, .ts-row input[type=color], .ts-row input[type=text] { flex: 1; }
+  .ts-row input[type=color] { height: 28px; padding: 2px; border-radius: 4px;
+    border: 1px solid var(--border2); background: var(--bg); cursor: pointer; }
+  .ts-swatches { display: flex; flex-wrap: wrap; gap: 6px; margin: 4px 0 10px; }
+  .ts-swatch { display: flex; flex-direction: column; align-items: center; gap: 3px;
+    cursor: pointer; user-select: none; }
+  .ts-swatch .tsb { width: 44px; height: 30px; border-radius: 6px; border: 2px solid transparent;
+    transition: border-color .15s, transform .1s; }
+  .ts-swatch:hover .tsb { transform: scale(1.06); }
+  .ts-swatch.active .tsb { border-color: var(--accent); }
+  .ts-swatch span { font-size: 9px; color: var(--muted); }
+  .ts-section { font-size: 10px; color: var(--dim); text-transform: uppercase;
+    letter-spacing: .6px; margin: 12px 0 6px; padding-bottom: 4px;
+    border-bottom: 1px solid var(--border); }
+  .ts-check { display: flex; align-items: center; gap: 6px; margin: 4px 0 8px;
+    font-size: 12px; color: var(--muted); cursor: pointer; }
+  .ts-check input { accent-color: var(--accent); cursor: pointer; }
+
   /* Config / Agents / Skills lists */
   .pane-section { padding: 10px 14px; }
   .pane-section h4 { font-size: 11px; color: var(--dim); text-transform: uppercase;
@@ -617,6 +649,7 @@ function buildHTML() {
     <button onclick="sendCmd('/model')">model</button>
     <button onclick="sendCmd('/clear')">clear</button>
     <button onclick="restartSapper()">restart</button>
+    <button title="Terminal appearance settings" onclick="openTermSettings()" style="font-size:13px;padding:3px 7px;">&#9881;</button>
   </div>
 
   <div id="body">
@@ -741,6 +774,114 @@ function buildHTML() {
 </div>
 <div id="toast"></div>
 
+<!-- Terminal Settings Modal -->
+<div id="tsModal" style="display:none;position:fixed;inset:0;background:rgba(0,0,0,.6);z-index:12000;display:none;align-items:center;justify-content:center;">
+  <div class="modal" style="width:520px;max-height:92vh;overflow-y:auto;">
+    <h3>&#9881; Terminal Appearance</h3>
+
+    <div class="ts-section">Themes</div>
+    <div class="ts-swatches" id="tsSwatches"></div>
+
+    <div class="ts-section">Colors</div>
+    <div class="ts-grid">
+      <div>
+        <label>Background</label>
+        <div class="ts-row">
+          <input type="color" id="tsBg" />
+          <input type="text" id="tsBgHex" placeholder="#0a0e14" style="width:90px;flex:none;font-family:ui-monospace,monospace;font-size:11px;" />
+        </div>
+      </div>
+      <div>
+        <label>Foreground</label>
+        <div class="ts-row">
+          <input type="color" id="tsFg" />
+          <input type="text" id="tsFgHex" placeholder="#e6edf3" style="width:90px;flex:none;font-family:ui-monospace,monospace;font-size:11px;" />
+        </div>
+      </div>
+      <div>
+        <label>Cursor</label>
+        <div class="ts-row">
+          <input type="color" id="tsCursor" />
+          <input type="text" id="tsCursorHex" placeholder="#58a6ff" style="width:90px;flex:none;font-family:ui-monospace,monospace;font-size:11px;" />
+        </div>
+      </div>
+      <div>
+        <label>Selection</label>
+        <div class="ts-row">
+          <input type="color" id="tsSel" />
+          <input type="text" id="tsSelHex" placeholder="#58a6ff" style="width:90px;flex:none;font-family:ui-monospace,monospace;font-size:11px;" />
+        </div>
+      </div>
+    </div>
+
+    <div class="ts-section">Font</div>
+    <div class="ts-grid">
+      <div class="ts-full">
+        <label>Font Family</label>
+        <div class="ts-row">
+          <select id="tsFont">
+            <option value='"SF Mono","Fira Code","JetBrains Mono",Menlo,ui-monospace,monospace'>SF Mono / Fira Code</option>
+            <option value='"JetBrains Mono","Fira Code",ui-monospace,monospace'>JetBrains Mono</option>
+            <option value='"Fira Code","Source Code Pro",ui-monospace,monospace'>Fira Code</option>
+            <option value='"Cascadia Code","Consolas",ui-monospace,monospace'>Cascadia Code</option>
+            <option value='"Monaco",Menlo,ui-monospace,monospace'>Monaco</option>
+            <option value='Menlo,ui-monospace,monospace'>Menlo</option>
+            <option value='"Courier New",monospace'>Courier New</option>
+            <option value='ui-monospace,monospace'>System Mono</option>
+          </select>
+        </div>
+      </div>
+      <div>
+        <label>Size &mdash; <span id="tsFontSzV">13</span>px</label>
+        <div class="ts-row">
+          <input type="range" id="tsFontSz" min="9" max="28" step="1" value="13" oninput="document.getElementById('tsFontSzV').textContent=this.value" />
+        </div>
+      </div>
+      <div>
+        <label>Line Height &mdash; <span id="tsLhV">1.25</span></label>
+        <div class="ts-row">
+          <input type="range" id="tsLh" min="1.0" max="2.0" step="0.05" value="1.25" oninput="document.getElementById('tsLhV').textContent=parseFloat(this.value).toFixed(2)" />
+        </div>
+      </div>
+    </div>
+
+    <div class="ts-section">Cursor &amp; Behavior</div>
+    <div class="ts-grid">
+      <div>
+        <label>Cursor Style</label>
+        <div class="ts-row">
+          <select id="tsCursorStyle">
+            <option value="bar">Bar |</option>
+            <option value="block">Block &#9646;</option>
+            <option value="underline">Underline _</option>
+          </select>
+        </div>
+      </div>
+      <div>
+        <label>Scrollback Lines</label>
+        <div class="ts-row">
+          <select id="tsScrollback">
+            <option value="1000">1,000</option>
+            <option value="5000">5,000</option>
+            <option value="10000" selected>10,000</option>
+            <option value="50000">50,000</option>
+          </select>
+        </div>
+      </div>
+      <div class="ts-full">
+        <label class="ts-check"><input type="checkbox" id="tsCursorBlink" checked /> Cursor blink</label>
+        <label class="ts-check"><input type="checkbox" id="tsLigatures" /> Font ligatures (requires compatible font)</label>
+      </div>
+    </div>
+
+    <div class="modal-actions" style="display:flex;gap:8px;justify-content:flex-end;margin-top:16px;">
+      <button onclick="tsReset()" style="background:transparent;color:var(--muted);border:1px solid var(--border);border-radius:5px;padding:6px 12px;font-size:12px;cursor:pointer;">Reset defaults</button>
+      <button onclick="document.getElementById('tsModal').style.display='none'" style="background:transparent;color:var(--muted);border:1px solid var(--border);border-radius:5px;padding:6px 12px;font-size:12px;cursor:pointer;">Close</button>
+      <button onclick="tsApply(true)" style="background:var(--accent);color:#fff;border:1px solid var(--accent);border-radius:5px;padding:6px 14px;font-size:12px;cursor:pointer;">Apply &amp; Save</button>
+    </div>
+  </div>
+</div>
+
 <script src="https://cdn.jsdelivr.net/npm/xterm@5.3.0/lib/xterm.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/xterm-addon-fit@0.8.0/lib/xterm-addon-fit.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/xterm-addon-web-links@0.9.0/lib/xterm-addon-web-links.min.js"></script>
@@ -824,7 +965,184 @@ try { term.loadAddon(new WebLinksAddon.WebLinksAddon()); } catch(e){}
 term.open(document.getElementById('term-wrap'));
 setTimeout(function(){ try { fit.fit(); } catch(e){} }, 30);
 
-var ws = null, reconnectTimer = null;
+// ─── Terminal Settings ────────────────────────────────────────
+var TS_DEFAULTS = {
+  fontSize: 13, lineHeight: 1.25, fontFamily: '"SF Mono","Fira Code","JetBrains Mono",Menlo,ui-monospace,monospace',
+  cursorStyle: 'bar', cursorBlink: true, scrollback: 10000, ligatures: false,
+  bg: '#0a0e14', fg: '#e6edf3', cursor: '#58a6ff', sel: '#58a6ff'
+};
+
+var TS_THEMES = [
+  { name:'Sapper Dark', bg:'#0a0e14', fg:'#e6edf3', cursor:'#58a6ff', sel:'#58a6ff',
+    colors:['#0a0e14','#484f58','#ff7b72','#3fb950','#d29922','#58a6ff','#bc8cff','#39c5cf'] },
+  { name:'GitHub Dark', bg:'#161b22', fg:'#c9d1d9', cursor:'#58a6ff', sel:'#388bfd',
+    colors:['#161b22','#484f58','#ff7b72','#3fb950','#d29922','#58a6ff','#bc8cff','#39c5cf'] },
+  { name:'Dracula', bg:'#282a36', fg:'#f8f8f2', cursor:'#ff79c6', sel:'#44475a',
+    colors:['#282a36','#44475a','#ff5555','#50fa7b','#f1fa8c','#6272a4','#ff79c6','#8be9fd'] },
+  { name:'One Dark', bg:'#282c34', fg:'#abb2bf', cursor:'#528bff', sel:'#3e4451',
+    colors:['#282c34','#3e4451','#e06c75','#98c379','#e5c07b','#61afef','#c678dd','#56b6c2'] },
+  { name:'Monokai', bg:'#272822', fg:'#f8f8f2', cursor:'#f8f8f2', sel:'#49483e',
+    colors:['#272822','#75715e','#f92672','#a6e22e','#f4bf75','#66d9e8','#ae81ff','#a1efe4'] },
+  { name:'Solarized', bg:'#002b36', fg:'#839496', cursor:'#268bd2', sel:'#073642',
+    colors:['#002b36','#073642','#dc322f','#859900','#b58900','#268bd2','#d33682','#2aa198'] },
+  { name:'Nord', bg:'#2e3440', fg:'#d8dee9', cursor:'#88c0d0', sel:'#4c566a',
+    colors:['#2e3440','#4c566a','#bf616a','#a3be8c','#ebcb8b','#5e81ac','#b48ead','#88c0d0'] },
+  { name:'Light', bg:'#ffffff', fg:'#24292e', cursor:'#0366d6', sel:'#0366d6',
+    colors:['#ffffff','#f6f8fa','#d73a49','#22863a','#b08800','#0366d6','#6f42c1','#005cc5'] }
+];
+
+var tsSettings = {};
+try { tsSettings = JSON.parse(localStorage.getItem('sapperTermSettings') || '{}') || {}; } catch(e) {}
+
+function tsGet(k) { return tsSettings[k] !== undefined ? tsSettings[k] : TS_DEFAULTS[k]; }
+
+function tsApplyToTerm(s) {
+  s = s || tsSettings;
+  var fontSize = s.fontSize !== undefined ? s.fontSize : TS_DEFAULTS.fontSize;
+  var lineHeight = s.lineHeight !== undefined ? s.lineHeight : TS_DEFAULTS.lineHeight;
+  var fontFamily = s.fontFamily !== undefined ? s.fontFamily : TS_DEFAULTS.fontFamily;
+  var cursorStyle = s.cursorStyle !== undefined ? s.cursorStyle : TS_DEFAULTS.cursorStyle;
+  var cursorBlink = s.cursorBlink !== undefined ? s.cursorBlink : TS_DEFAULTS.cursorBlink;
+  var scrollback  = s.scrollback !== undefined ? s.scrollback  : TS_DEFAULTS.scrollback;
+  var bg     = s.bg     !== undefined ? s.bg     : TS_DEFAULTS.bg;
+  var fg     = s.fg     !== undefined ? s.fg     : TS_DEFAULTS.fg;
+  var cursor = s.cursor !== undefined ? s.cursor : TS_DEFAULTS.cursor;
+  var sel    = s.sel    !== undefined ? s.sel    : TS_DEFAULTS.sel;
+
+  term.options.fontSize    = parseInt(fontSize, 10);
+  term.options.lineHeight  = parseFloat(lineHeight);
+  term.options.fontFamily  = fontFamily;
+  term.options.cursorStyle = cursorStyle;
+  term.options.cursorBlink = !!cursorBlink;
+  term.options.scrollback  = parseInt(scrollback, 10);
+  term.options.theme = {
+    background: bg, foreground: fg,
+    cursor: cursor, cursorAccent: bg,
+    selectionBackground: sel + '59',
+    black:'#484f58', red:'#ff7b72', green:'#3fb950', yellow:'#d29922',
+    blue:'#58a6ff', magenta:'#bc8cff', cyan:'#39c5cf', white:'#e6edf3',
+    brightBlack:'#6e7681', brightRed:'#ffa198', brightGreen:'#56d364',
+    brightYellow:'#e3b341', brightBlue:'#79c0ff', brightMagenta:'#d2a8ff',
+    brightCyan:'#56d4dd', brightWhite:'#f0f6fc'
+  };
+  // Also update the page background to match terminal background
+  document.documentElement.style.setProperty('--bg', bg);
+  document.documentElement.style.setProperty('--fg', fg);
+  document.documentElement.style.setProperty('--accent', cursor);
+  document.documentElement.style.setProperty('--accent2', cursor);
+  // Also update the xterm viewport background directly
+  document.querySelectorAll('.xterm .xterm-viewport').forEach(function(el){ el.style.backgroundColor = bg; });
+  try { fit.fit(); } catch(e) {}
+}
+
+// Apply saved settings on load (if any)
+(function(){
+  if (Object.keys(tsSettings).length > 0) tsApplyToTerm(tsSettings);
+})();
+
+function tsColorInputPair(colorId, hexId) {
+  var col = document.getElementById(colorId);
+  var hex = document.getElementById(hexId);
+  if (!col || !hex) return;
+  col.addEventListener('input', function() {
+    hex.value = col.value;
+  });
+  hex.addEventListener('change', function() {
+    var v = hex.value.trim();
+    if (/^#[0-9a-fA-F]{6}$/.test(v)) col.value = v;
+  });
+  hex.addEventListener('input', function() {
+    var v = hex.value.trim();
+    if (/^#[0-9a-fA-F]{6}$/.test(v)) col.value = v;
+  });
+}
+
+function tsApply(save) {
+  var s = {
+    fontSize:    parseInt(document.getElementById('tsFontSz').value, 10),
+    lineHeight:  parseFloat(document.getElementById('tsLh').value),
+    fontFamily:  document.getElementById('tsFont').value,
+    cursorStyle: document.getElementById('tsCursorStyle').value,
+    cursorBlink: document.getElementById('tsCursorBlink').checked,
+    scrollback:  parseInt(document.getElementById('tsScrollback').value, 10),
+    ligatures:   document.getElementById('tsLigatures').checked,
+    bg:     document.getElementById('tsBgHex').value || document.getElementById('tsBg').value,
+    fg:     document.getElementById('tsFgHex').value || document.getElementById('tsFg').value,
+    cursor: document.getElementById('tsCursorHex').value || document.getElementById('tsCursor').value,
+    sel:    document.getElementById('tsSelHex').value || document.getElementById('tsSel').value,
+  };
+  tsApplyToTerm(s);
+  if (save) {
+    tsSettings = s;
+    try { localStorage.setItem('sapperTermSettings', JSON.stringify(s)); } catch(e) {}
+    document.getElementById('tsModal').style.display = 'none';
+    showToast('Terminal settings saved');
+  }
+}
+
+function tsReset() {
+  tsSettings = {};
+  try { localStorage.removeItem('sapperTermSettings'); } catch(e) {}
+  tsApplyToTerm(TS_DEFAULTS);
+  tsLoadIntoForm(TS_DEFAULTS);
+  showToast('Reset to defaults');
+}
+
+function tsLoadIntoForm(s) {
+  var get = function(k){ return s[k] !== undefined ? s[k] : TS_DEFAULTS[k]; };
+  document.getElementById('tsFontSz').value = get('fontSize');
+  document.getElementById('tsFontSzV').textContent = get('fontSize');
+  document.getElementById('tsLh').value = get('lineHeight');
+  document.getElementById('tsLhV').textContent = parseFloat(get('lineHeight')).toFixed(2);
+  document.getElementById('tsFont').value = get('fontFamily');
+  document.getElementById('tsCursorStyle').value = get('cursorStyle');
+  document.getElementById('tsCursorBlink').checked = !!get('cursorBlink');
+  document.getElementById('tsScrollback').value = get('scrollback');
+  document.getElementById('tsLigatures').checked = !!get('ligatures');
+  var bg = get('bg'); document.getElementById('tsBg').value = bg; document.getElementById('tsBgHex').value = bg;
+  var fg = get('fg'); document.getElementById('tsFg').value = fg; document.getElementById('tsFgHex').value = fg;
+  var c  = get('cursor'); document.getElementById('tsCursor').value = c; document.getElementById('tsCursorHex').value = c;
+  var sl = get('sel'); document.getElementById('tsSel').value = sl; document.getElementById('tsSelHex').value = sl;
+}
+
+function tsBuildSwatches() {
+  var cont = document.getElementById('tsSwatches');
+  if (!cont) return;
+  cont.innerHTML = TS_THEMES.map(function(t, i) {
+    var grad = 'background:linear-gradient(135deg,' + t.bg + ' 55%,' + t.cursor + ' 100%)';
+    return '<div class="ts-swatch" data-i="' + i + '" title="' + t.name + '">' +
+      '<div class="tsb" style="' + grad + '"></div>' +
+      '<span>' + t.name + '</span></div>';
+  }).join('');
+  cont.querySelectorAll('.ts-swatch').forEach(function(el) {
+    el.addEventListener('click', function() {
+      cont.querySelectorAll('.ts-swatch').forEach(function(e){ e.classList.remove('active'); });
+      el.classList.add('active');
+      var t = TS_THEMES[parseInt(el.getAttribute('data-i'), 10)];
+      document.getElementById('tsBg').value = t.bg; document.getElementById('tsBgHex').value = t.bg;
+      document.getElementById('tsFg').value = t.fg; document.getElementById('tsFgHex').value = t.fg;
+      document.getElementById('tsCursor').value = t.cursor; document.getElementById('tsCursorHex').value = t.cursor;
+      document.getElementById('tsSel').value = t.sel; document.getElementById('tsSelHex').value = t.sel;
+      tsApply(false); // live preview
+    });
+  });
+}
+
+window.openTermSettings = function() {
+  var modal = document.getElementById('tsModal');
+  tsLoadIntoForm(tsSettings);
+  tsBuildSwatches();
+  // Wire color input pairs
+  tsColorInputPair('tsBg','tsBgHex');
+  tsColorInputPair('tsFg','tsFgHex');
+  tsColorInputPair('tsCursor','tsCursorHex');
+  tsColorInputPair('tsSel','tsSelHex');
+  modal.style.display = 'flex';
+  // Close on backdrop click
+  modal.onclick = function(ev){ if (ev.target === modal) modal.style.display = 'none'; };
+};
+
+
 
 function connectPty() {
   var proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
@@ -1895,9 +2213,19 @@ function renderIndex() {
     var info = state.indexSet[p];
     var cls = info.isDir ? 'chip dir' : 'chip';
     var ico = info.isDir ? '&#128193;' : '&#128462;';
+    var deepBtn = '';
+    if (info.isDir) {
+      var deepOn = info.deep ? ' on' : '';
+      var deepLabel = info.deep ? 'deep' : 'scan';
+      var deepTitle = info.deep
+        ? 'Deep: include the contents of every readable file in this folder'
+        : 'Scan: list the folder and include code-file contents (smaller payload). Click to switch to deep.';
+      deepBtn = '<span class="cdeep' + deepOn + '" data-p="' + esc(p) + '" title="' + deepTitle + '">' + deepLabel + '</span>';
+    }
     return '<span class="' + cls + '" title="' + esc(p) + '">' +
       '<span>' + ico + '</span>' +
       '<span class="cp">' + esc(p) + '</span>' +
+      deepBtn +
       '<span class="cx" data-p="' + esc(p) + '" title="Remove">&times;</span>' +
       '</span>';
   }).join('');
@@ -1907,23 +2235,42 @@ function renderIndex() {
       toggleIndex(el.getAttribute('data-p'), state.indexSet[el.getAttribute('data-p')] && state.indexSet[el.getAttribute('data-p')].isDir);
     });
   });
+  chips.querySelectorAll('.cdeep').forEach(function(el){
+    el.addEventListener('click', function(ev){
+      ev.stopPropagation();
+      var p = el.getAttribute('data-p');
+      var info = state.indexSet[p];
+      if (!info || !info.isDir) return;
+      info.deep = !info.deep;
+      saveIndex();
+      renderIndex();
+    });
+  });
 }
 
 window.sendIndexToChat = function() {
   var paths = Object.keys(state.indexSet);
   if (!paths.length) { showToast('Index is empty', 'err'); return; }
   if (!ws || ws.readyState !== 1) { showToast('Terminal not connected', 'err'); return; }
-  var files = [], dirs = [];
+  var files = [], dirsShallow = [], dirsDeep = [];
   paths.forEach(function(p){
-    if (state.indexSet[p] && state.indexSet[p].isDir) dirs.push(p); else files.push(p);
+    var info = state.indexSet[p];
+    if (!info) return;
+    if (info.isDir) {
+      if (info.deep) dirsDeep.push(p); else dirsShallow.push(p);
+    } else {
+      files.push(p);
+    }
   });
   // Helper: quote paths that contain spaces, leave plain otherwise.
   function quoteIfNeeded(p) {
     return /\\s/.test(p) ? '"' + p.replace(/"/g, '\\\\"') + '"' : p;
   }
-  // 1) /scan each folder (each sent as its own command + Enter)
-  dirs.forEach(function(d){ sendPasteToTerm('/scan ' + quoteIfNeeded(d)); });
-  // 2) Build attachments token for files
+  // 1) /scan for shallow folders (file tree + code-file contents)
+  dirsShallow.forEach(function(d){ sendPasteToTerm('/scan ' + quoteIfNeeded(d)); });
+  // 2) /include for deep folders (every readable file's contents)
+  dirsDeep.forEach(function(d){ sendPasteToTerm('/include ' + quoteIfNeeded(d)); });
+  // 3) Build attachments token for files
   var atTokens = files.map(function(f){ return '@' + quoteIfNeeded(f); }).join(' ');
   var comment = (document.getElementById('idxComment') || {}).value || '';
   comment = comment.trim();
@@ -1936,8 +2283,10 @@ window.sendIndexToChat = function() {
     // Stage at cursor — no Enter, so the user can type their question
     sendRawToTerm(atTokens + ' ');
   }
+  var dirsTotal = dirsShallow.length + dirsDeep.length;
   showToast('Sent ' + files.length + ' file' + (files.length === 1 ? '' : 's') +
-            (dirs.length ? ' and ' + dirs.length + ' folder' + (dirs.length === 1 ? '' : 's') : '') +
+            (dirsTotal ? ' and ' + dirsTotal + ' folder' + (dirsTotal === 1 ? '' : 's') +
+              (dirsDeep.length ? ' (' + dirsDeep.length + ' deep)' : '') : '') +
             ' to chat');
   // Clear comment, clear index, refocus terminal
   var cmt = document.getElementById('idxComment'); if (cmt) cmt.value = '';
@@ -2777,41 +3126,98 @@ function spawnSapper(cols, rows) {
   });
 }
 
+// ─── Persistent PTY (survives browser refresh) ───────────────────
+// The pty process lives at module scope so it outlives any WS connection.
+// All output is stored in a ring buffer; new clients replay it on connect.
+
+const PTY_SCROLLBACK_MAX = 512 * 1024; // 512 KB replay buffer
+let sharedPty = null;
+let ptyScrollback = '';          // raw bytes (utf-8) for replay
+let ptyCols = 220, ptyRows = 50;  // last known size
+
+function appendPtyScrollback(chunk) {
+  ptyScrollback += chunk;
+  if (ptyScrollback.length > PTY_SCROLLBACK_MAX) {
+    // Drop oldest half to stay near cap without constant slicing
+    ptyScrollback = ptyScrollback.slice(ptyScrollback.length - Math.floor(PTY_SCROLLBACK_MAX * 0.6));
+  }
+}
+
+function ensurePty(cols, rows) {
+  if (sharedPty) return;
+  ptyCols = cols || 220; ptyRows = rows || 50;
+  try {
+    sharedPty = spawnSapper(ptyCols, ptyRows);
+  } catch (e) {
+    console.error('[ui] spawn failed:', e.message);
+    return;
+  }
+  dbg('pty pid=' + sharedPty.pid + ' ' + ptyCols + 'x' + ptyRows);
+  sharedPty.onData((d) => {
+    appendPtyScrollback(d);
+    // Broadcast to every connected pty client
+    for (const ws of ptyClients) {
+      if (ws.readyState === ws.OPEN) {
+        try { ws.send(Buffer.from(d, 'utf8')); } catch {}
+      }
+    }
+  });
+  sharedPty.onExit(({ exitCode, signal }) => {
+    dbg('pty exit code=' + exitCode);
+    sharedPty = null;
+    // Notify all clients so they can show "exited" badge
+    const msg = JSON.stringify({ type: 'exit', code: exitCode, signal });
+    for (const ws of ptyClients) {
+      if (ws.readyState === ws.OPEN) { try { ws.send(msg); } catch {} }
+    }
+  });
+}
+
+const ptyClients = new Set(); // all currently-connected pty websockets
+
 wssPty.on('connection', (ws) => {
   dbg('pty client connected');
-  let pty = null; let initialized = false;
-
-  function start(cols, rows) {
-    if (pty) { try { pty.kill(); } catch {} }
-    try { pty = spawnSapper(cols, rows); }
-    catch (e) {
-      console.error('[ui] spawn failed:', e.message);
-      try { ws.send(Buffer.from('\x1b[31mFailed to spawn sapper: ' + e.message + '\x1b[0m\r\n', 'utf8')); } catch {}
-      return;
-    }
-    dbg('pty pid=' + pty.pid + ' ' + cols + 'x' + rows);
-    pty.onData((d) => { if (ws.readyState === ws.OPEN) ws.send(Buffer.from(d, 'utf8')); });
-    pty.onExit(({ exitCode, signal }) => {
-      dbg('pty exit code=' + exitCode);
-      if (ws.readyState === ws.OPEN) { try { ws.send(JSON.stringify({ type: 'exit', code: exitCode, signal })); } catch {} }
-    });
-    try { ws.send(JSON.stringify({ type: 'cwd', path: workingDir })); } catch {}
-  }
+  ptyClients.add(ws);
 
   ws.on('message', (raw, isBinary) => {
     const str = raw.toString('utf8');
     if (!isBinary && str.startsWith('{')) {
       try {
         const m = JSON.parse(str);
-        if (m.type === 'init') { if (!initialized) { initialized = true; start(m.cols, m.rows); } return; }
-        if (m.type === 'resize' && pty) { try { pty.resize(m.cols || 100, m.rows || 30); } catch {} return; }
-        if (m.type === 'restart') { initialized = true; start(100, 30); return; }
+        if (m.type === 'init') {
+          // Spawn pty if not running yet
+          ensurePty(m.cols, m.rows);
+          // Replay scrollback so the refreshed browser sees prior output
+          if (ptyScrollback.length > 0) {
+            try { ws.send(Buffer.from(ptyScrollback, 'utf8')); } catch {}
+          }
+          // Always send current cwd
+          try { ws.send(JSON.stringify({ type: 'cwd', path: workingDir })); } catch {}
+          return;
+        }
+        if (m.type === 'resize' && sharedPty) {
+          ptyCols = m.cols || ptyCols; ptyRows = m.rows || ptyRows;
+          try { sharedPty.resize(ptyCols, ptyRows); } catch {}
+          return;
+        }
+        if (m.type === 'restart') {
+          // Kill current pty and start fresh; clear scrollback
+          if (sharedPty) { try { sharedPty.kill(); } catch {} sharedPty = null; }
+          ptyScrollback = '';
+          ensurePty(ptyCols, ptyRows);
+          try { ws.send(JSON.stringify({ type: 'cwd', path: workingDir })); } catch {}
+          return;
+        }
       } catch {}
     }
-    if (pty) pty.write(str);
+    if (sharedPty) sharedPty.write(str);
   });
 
-  ws.on('close', () => { if (pty) { try { pty.kill(); } catch {} pty = null; } });
+  ws.on('close', () => {
+    ptyClients.delete(ws);
+    // Do NOT kill the pty — keep it alive for the next reconnect.
+    dbg('pty client disconnected (' + ptyClients.size + ' remaining)');
+  });
 });
 
 // ── FS watcher: broadcast to all /events clients ─────────────────
@@ -3088,5 +3494,11 @@ server.on('listening', () => {
 
 tryListen(PORT);
 
-process.on('SIGINT', () => { console.log('\nShutting down…'); try { watcher && watcher.close(); } catch {} process.exit(0); });
-process.on('SIGTERM', () => process.exit(0));
+function shutdown() {
+  console.log('\nShutting down…');
+  try { watcher && watcher.close(); } catch {}
+  if (sharedPty) { try { sharedPty.kill(); } catch {} }
+  process.exit(0);
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);

package/sapper.mjs

@@ -1019,6 +1019,12 @@ let _useNativeToolsFlag = false;
 // Models known to reject `think:true` (populated lazily on first failure).
 const modelsWithoutThinking = new Set();
 
+// Models known to emit malformed native tool calls (e.g. broken XML that
+// Ollama's parser rejects with "element <function> closed by </parameter>").
+// Once a model lands here we stop sending `tools` to it for the rest of the
+// session — it falls back to text-marker tools, which any model can produce.
+const modelsWithBrokenNativeTools = new Set();
+
 function buildSystemPrompt(agentContent = null, skillContents = []) {
   const now = new Date();
   const dateStr = now.toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' });
@@ -3013,7 +3019,8 @@ const COMMAND_GROUPS = Object.freeze([
     rows: [
       ['@ or /attach', 'Pick files to attach interactively'],
       ['@file', 'Attach a file inline, for example @src/app.js'],
-      ['/scan', 'Scan the codebase into context'],
+      ['/scan [path]', 'Scan a folder (code files only) into context'],
+      ['/include [path]', 'Attach every readable file in a folder (deep)'],
       ['/index', 'Rebuild the workspace graph'],
       ['/graph file', 'Show related files from the graph'],
       ['/symbol name', 'Search indexed functions and classes'],
@@ -4185,6 +4192,50 @@ function scanCodebase(dir = '.', depth = 0, maxDepth = 5) {
   return { files, totalSize };
 }
 
+// Walk a folder and read every readable text file's contents (broader than
+// scanCodebase, which is restricted to CODE_EXTENSIONS). Used by /include
+// when the user wants ALL files in a folder attached (not just a tree+code).
+function includeFolderContents(dir, depth = 0, maxDepth = 8, acc = null) {
+  acc = acc || { files: [], totalSize: 0, skipped: [], reachedCap: false };
+  if (acc.reachedCap || depth > maxDepth) return acc;
+  let entries;
+  try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+  catch (e) { return acc; }
+  for (const entry of entries) {
+    if (acc.reachedCap) break;
+    const fullPath = dir === '.' ? entry.name : `${dir}/${entry.name}`;
+    if (entry.isDirectory()) {
+      if (shouldIgnore(entry.name) || entry.name.startsWith('.')) continue;
+      includeFolderContents(fullPath, depth + 1, maxDepth, acc);
+      continue;
+    }
+    if (!entry.isFile()) continue;
+    if (shouldIgnore(fullPath) || shouldIgnore(entry.name)) continue;
+    let stats;
+    try { stats = fs.statSync(fullPath); } catch (e) { continue; }
+    if (stats.size > getMaxFileSize()) {
+      acc.skipped.push({ path: fullPath, size: stats.size, reason: 'too large' });
+      continue;
+    }
+    if (acc.totalSize + stats.size > getMaxScanSize()) {
+      acc.skipped.push({ path: fullPath, size: stats.size, reason: 'total limit reached' });
+      acc.reachedCap = true;
+      continue;
+    }
+    let content;
+    try { content = fs.readFileSync(fullPath, 'utf8'); }
+    catch (e) { acc.skipped.push({ path: fullPath, reason: e.message }); continue; }
+    // Skip binary-looking files (NUL byte in first 4KB)
+    if (content.length && content.slice(0, 4096).indexOf('\u0000') !== -1) {
+      acc.skipped.push({ path: fullPath, size: stats.size, reason: 'binary' });
+      continue;
+    }
+    acc.files.push({ path: fullPath, size: stats.size, content });
+    acc.totalSize += stats.size;
+  }
+  return acc;
+}
+
 // Scan directory for files (for @ file picker)
 function getFilesForPicker(dir = '.', prefix = '', maxFiles = 50) {
   let files = [];
@@ -6263,6 +6314,12 @@ async function runSapper() {
     } else {
       toolModeLabel = 'text markers';
     }
+    // If we previously caught this model emitting malformed tool XML, stay
+    // on text-marker tools for the whole session.
+    if (modelsWithBrokenNativeTools.has(selectedModel)) {
+      useNativeTools = false;
+      toolModeLabel = 'text markers (native tools disabled — model emits broken XML)';
+    }
     // Extract context window size from model_info
     // Different model families use different keys: llama.context_length, qwen2.context_length, etc.
     if (modelInfo.model_info) {
@@ -8424,6 +8481,61 @@ async function runSapper() {
         continue;
       }
 
+      // /include <path> — deep-attach every readable file in a folder
+      // (broader than /scan: not limited to code extensions). Used by the
+      // Index tray's "deep" toggle on folder chips.
+      if (input.toLowerCase() === '/include' || input.toLowerCase().startsWith('/include ')) {
+        let incTarget = '.';
+        const incRest = input.slice(8).trim();
+        if (incRest) {
+          if ((incRest.startsWith('"') && incRest.endsWith('"')) ||
+              (incRest.startsWith("'") && incRest.endsWith("'"))) {
+            incTarget = incRest.slice(1, -1);
+          } else {
+            incTarget = incRest;
+          }
+        }
+        if (!fs.existsSync(incTarget)) {
+          console.log(chalk.red(`Path not found: ${incTarget}`));
+          continue;
+        }
+        const incStat = fs.statSync(incTarget);
+        if (!incStat.isDirectory()) {
+          console.log(chalk.red(`Not a directory: ${incTarget}`));
+          continue;
+        }
+        console.log(uiCleanMode()
+          ? chalk.cyan(`\nIncluding all files in ${incTarget}...`)
+          : chalk.cyan(`\n📚 Including all files in ${incTarget}...`));
+        const incResult = includeFolderContents(incTarget);
+        if (incResult.files.length === 0) {
+          console.log(chalk.yellow(`No readable files found in ${incTarget}.`));
+          if (incResult.skipped.length) {
+            console.log(chalk.gray(`(${incResult.skipped.length} skipped — too large, binary, or ignored)`));
+          }
+          continue;
+        }
+        const incBlock = formatFileAttachments(incResult.files);
+        messages.push({
+          role: 'user',
+          content: `Including all readable files from ${incTarget}:\n${incBlock}`
+        });
+        console.log(uiCleanMode()
+          ? chalk.green(`Included ${incResult.files.length} files (~${Math.round(incResult.totalSize/1024)}KB) from ${incTarget}`)
+          : chalk.green(`✅ Included ${incResult.files.length} files (~${Math.round(incResult.totalSize/1024)}KB) from ${incTarget}`));
+        if (incResult.skipped.length > 0) {
+          console.log(uiCleanMode()
+            ? chalk.yellow(`Skipped ${incResult.skipped.length} files (too large, binary, or limit reached)`)
+            : chalk.yellow(`⏭️  Skipped ${incResult.skipped.length} files (too large, binary, or limit reached)`));
+        }
+        if (incResult.reachedCap) {
+          console.log(chalk.yellow(`⚠️  Hit total-size cap (~${Math.round(getMaxScanSize()/1024)}KB); some files were not included.`));
+        }
+        ensureSapperDir();
+        fs.writeFileSync(CONTEXT_FILE, JSON.stringify(messages, null, 2));
+        continue;
+      }
+
       if (input.startsWith('/') && !input.startsWith('//') && !agentHandled) {
         const commandToken = input.slice(1).trim().split(/\s+/)[0] || '';
         const suggestions = suggestSlashCommands(commandToken, 5);
@@ -8654,6 +8766,9 @@ async function runSapper() {
       let turnThinkingEnabled = shouldUseThinkingForInput(input);
       if (modelsWithoutThinking.has(selectedModel)) turnThinkingEnabled = false;
 
+      // Auto-recover once per turn if the model emits malformed native tool XML.
+      let nativeToolXmlRetried = false;
+
       let active = true;
       while (active) {
         if (stepMode) await safeQuestion(chalk.gray(promptLabel('questions.stepContinue', '[STEP] Press Enter to let AI think...')));
@@ -8866,8 +8981,31 @@ async function runSapper() {
             process.stdout.write(`\n${UI.slate('  └─')}\n`);
           }
           process.stdout.write('\r\x1b[K');
-          console.error(chalk.red(`\n❌ Stream error: ${streamErrored.message || streamErrored}`));
-          logEntry('error', { message: `Stream error: ${streamErrored.message || streamErrored}` });
+          const streamErrMsg = streamErrored.message || String(streamErrored);
+          // Detect malformed native-tool XML from small/quantized models.
+          // Ollama's parser surfaces this as e.g. "XML syntax error on line 3:
+          // element <function> closed by </parameter>". Disable native tools
+          // for this model and retry the same turn once.
+          const isXmlToolErr = /xml syntax|element <\w+> closed by|invalid character|unexpected end of/i.test(streamErrMsg);
+          if (isXmlToolErr && useNativeTools && !nativeToolXmlRetried) {
+            nativeToolXmlRetried = true;
+            modelsWithBrokenNativeTools.add(selectedModel);
+            useNativeTools = false;
+            toolModeLabel = 'text markers (auto: model emits broken tool XML)';
+            console.error(chalk.yellow(
+              `\n⚠ "${selectedModel}" emitted malformed tool XML — disabling native tool calling for this session and retrying.`
+            ));
+            console.error(chalk.gray('  Tip: a larger / instruction-tuned model (e.g. qwen2.5:7b, llama3.1) will not hit this.'));
+            logEntry('warn', { message: `Disabled native tools for ${selectedModel}: ${streamErrMsg}` });
+            // Reset per-attempt state and try this same turn again without tools.
+            msg = '';
+            thinkMsg = '';
+            nativeToolCalls = [];
+            streamErrored = null;
+            continue;
+          }
+          console.error(chalk.red(`\n❌ Stream error: ${streamErrMsg}`));
+          logEntry('error', { message: `Stream error: ${streamErrMsg}` });
           active = false;
           continue;
         }