crosspad-mcp-server 9.1.1 → 9.2.0

package/tracer/ui/symbols.js

@@ -0,0 +1,80 @@
+/* Symbol autocomplete data source ("podpowiedzi zmiennych").
+   Fetches /symbols (PROTOCOL §8/§9) and builds a flat, deduped suggestion list
+   + a name→metadata map. The watchlist module renders the actual dropdown from
+   this data; here we only fetch and shape. Free-form expansion specs the user
+   types (vec[*], vec[a:b], mat[*][k]) are never blocked — suggestions only
+   ASSIST; the server expands whatever is actually submitted. */
+
+import { bus } from "./state.js";
+
+let suggestList = [];                 // deduped suggestion strings (sorted)
+export const symMeta = new Map();     // name -> §8 metadata entry
+export function getSuggestList(){ return suggestList; }
+
+/* Build suggestion strings from one symbol metadata entry (§8 shape). */
+export function suggestionsForSymbol(sym){
+  const out=[];
+  const name=sym&&typeof sym.name==="string"?sym.name:null;
+  if(!name)return out;
+  const kind=sym.kind;
+  if(kind==="array"){
+    out.push(name);          // bare array name → whole-array expansion
+    out.push(name+"[0]");    // first element
+    out.push(name+"[*]");    // all elements (wildcard)
+    if(Array.isArray(sym.dims)&&sym.dims.length>=2){
+      out.push(name+"[0][0]");
+      out.push(name+"[*][0]");
+    }
+  }else if(kind==="struct"||kind==="union"){
+    out.push(name);
+    if(Array.isArray(sym.members)){
+      for(const mb of sym.members){ if(typeof mb==="string"&&mb) out.push(name+"."+mb); }
+    }
+  }else{
+    out.push(name);          // scalar / other / unknown
+  }
+  return out;
+}
+
+/* Strip the [i]/[*]/.member suffix to get the base symbol name for metadata
+   lookup. */
+export function baseName(spec){
+  const m=/^[A-Za-z_$][A-Za-z0-9_$]*/.exec(spec);
+  return m?m[0]:spec;
+}
+
+/* A short metadata hint for a suggestion, e.g. "(8×, n=8)" or "(struct)". */
+export function metaHint(spec){
+  const meta=symMeta.get(baseName(spec));
+  if(!meta)return "";
+  if(meta.kind==="array"){
+    const dims=Array.isArray(meta.dims)?meta.dims.join("×")+", ":"";
+    return "("+dims+"n="+(meta.count!=null?meta.count:"?")+")";
+  }
+  if(meta.kind==="struct"||meta.kind==="union") return "("+meta.kind+")";
+  return "";
+}
+
+/* Fetch /symbols and rebuild the suggestion list. Degrades gracefully: any
+   failure (older server, no active session, non-JSON) leaves autocomplete empty
+   and manual entry still works. Notifies the view via bus.onSymbols so an open
+   dropdown can refresh. */
+export function loadSymbols(){
+  fetch("/symbols").then(r=>{
+    if(!r.ok) throw new Error("HTTP "+r.status);
+    return r.json();
+  }).then(j=>{
+    const arr=(j&&Array.isArray(j.symbols))?j.symbols:[];
+    const seen=new Set(); const list=[];
+    symMeta.clear();
+    for(const sym of arr){
+      if(sym&&typeof sym.name==="string") symMeta.set(sym.name,sym);
+      for(const sug of suggestionsForSymbol(sym)){
+        if(!seen.has(sug)){ seen.add(sug); list.push(sug); }
+      }
+    }
+    list.sort();
+    suggestList=list;
+    bus.onSymbols();
+  }).catch(()=>{ /* no autocomplete — manual entry still works */ });
+}

package/tracer/ui/toolbar.js

@@ -0,0 +1,95 @@
+/* Top-bar controls: pause/resume, reset view, PNG/CSV export, force-reconnect,
+   and keyboard shortcuts. */
+
+import { state, sigs } from "./state.js";
+import { curRange, renderExport } from "./plot.js";
+import { downloadBlob, tstamp, toast } from "./util.js";
+import { forceReconnect, getConnState, hasSocket } from "./connection.js";
+import { toggleFull } from "./config.js";
+
+let pauseBtn=null, pauseLbl=null;
+
+/* Pause = HOLD: keep ingesting samples (no data lost) but FREEZE the view by
+   pinning the current range. Resume clears the pin → back to the live window. */
+export function togglePause(){
+  state.paused=!state.paused;
+  if(state.paused){
+    const [a,b]=curRange();
+    state.viewT0=a; state.viewT1=b;
+  }else{
+    state.viewT0=null; state.viewT1=null;
+  }
+  pauseBtn.classList.toggle("active",state.paused);
+  if(pauseLbl) pauseLbl.textContent=state.paused?"Resume":"Pause";
+}
+
+/* Reset view: drop manual time AND Y overrides → back to the live window. */
+export function resetView(){ state.viewT0=null; state.viewT1=null; state.viewY0=null; state.viewY1=null; }
+
+/* High-contrast, labeled, 2× export (see plot.renderExport) — far more legible
+   than dumping the live low-contrast canvas. */
+function exportPng(){
+  try{
+    const fsText=document.getElementById("fs")?.textContent||"";
+    const off=renderExport(fsText);
+    off.toBlob(b=>{ if(b) downloadBlob("trace-"+tstamp()+".png",b); else toast("PNG export failed"); });
+  }catch(_){ toast("PNG export failed"); }
+}
+
+/* Top-bar "i" help popover (replaces the canvas tooltip that blocked the view). */
+function initInfo(){
+  const info=document.getElementById("info");
+  const help=document.getElementById("help");
+  if(!info||!help)return;
+  info.onclick=(e)=>{ e.stopPropagation(); help.hidden=!help.hidden; };
+  document.addEventListener("click",(e)=>{
+    if(!help.hidden && e.target!==info && !help.contains(e.target)) help.hidden=true;
+  });
+}
+
+/* CSV: wide format over the visible window. Sample frames share one timestamp
+   across all signals (PROTOCOL §10), so rows key on `t`, columns = signals. */
+function exportCsv(){
+  const names=[...sigs.keys()];
+  if(!names.length){ toast("nothing to export","info"); return; }
+  const [t0,t1]=curRange();
+  const rowsByT=new Map();
+  for(const n of names) for(const p of sigs.get(n).data){
+    if(p.t<t0||p.t>t1)continue;
+    let row=rowsByT.get(p.t); if(!row){row={};rowsByT.set(p.t,row);}
+    row[n]=p.v;
+  }
+  if(!rowsByT.size){ toast("no samples in view","info"); return; }
+  const ts=[...rowsByT.keys()].sort((a,b)=>a-b);
+  const q=v=>{const s=String(v); return /[",\n]/.test(s)?'"'+s.replace(/"/g,'""')+'"':s;};
+  let csv="t,"+names.map(q).join(",")+"\n";
+  for(const t of ts){ const row=rowsByT.get(t); csv+=t+","+names.map(n=>n in row?row[n]:"").join(",")+"\n"; }
+  downloadBlob("trace-"+tstamp()+".csv",new Blob([csv],{type:"text/csv"}));
+}
+
+export function initToolbar(){
+  pauseBtn=document.getElementById("pause");
+  pauseLbl=pauseBtn.querySelector(".lbl");
+  pauseBtn.onclick=togglePause;
+  document.getElementById("auto").onclick=resetView;
+  document.getElementById("expPng").onclick=exportPng;
+  document.getElementById("expCsv").onclick=exportCsv;
+  document.getElementById("reconnect").onclick=()=>forceReconnect();
+  initInfo();
+
+  // Keyboard shortcuts — inert while typing in an input/select/textarea.
+  document.addEventListener("keydown",e=>{
+    if(e.key==="Escape"){ const help=document.getElementById("help"); if(help) help.hidden=true; }
+    const tag=(e.target&&e.target.tagName)||"";
+    if(/^(INPUT|SELECT|TEXTAREA)$/.test(tag))return;
+    if(e.metaKey||e.ctrlKey||e.altKey)return;
+    if(e.key===" "){ e.preventDefault(); togglePause(); }
+    else if(e.key==="r"||e.key==="R"){ resetView(); }
+    else if(e.key==="f"||e.key==="F"){ toggleFull(); }
+  });
+
+  // Tab backgrounded + socket died → retry as soon as it's visible again.
+  document.addEventListener("visibilitychange",()=>{
+    if(document.visibilityState==="visible" && !hasSocket() && getConnState()!=="connected") forceReconnect();
+  });
+}

package/tracer/ui/util.js

@@ -0,0 +1,62 @@
+/* Pure helpers + the toast notifier. No app state — safe to import anywhere. */
+
+export function esc(n){ return String(n).replace(/[&<>"]/g,c=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"}[c])); }
+export function cssid(n){ return n.replace(/[^a-z0-9]/gi,"_"); }
+export function cssAttr(n){ return n.replace(/"/g,'\\"'); }
+
+/* Expand a #rgb / #rrggbb color to the 6-digit form an <input type=color>
+   requires (palette literals are 3-digit shorthand). Non-hex → safe default. */
+export function hex6(c){
+  if(typeof c!=="string")return "#4488ff";
+  const m=/^#([0-9a-f]{3})$/i.exec(c);
+  if(m){const s=m[1];return "#"+s[0]+s[0]+s[1]+s[1]+s[2]+s[2];}
+  if(/^#[0-9a-f]{6}$/i.test(c))return c;
+  return "#4488ff";
+}
+
+/* Compact numeric formatter for readouts/stats. */
+export function fmt(x){
+  if(x===null||x===undefined||!isFinite(x))return "—";
+  const a=Math.abs(x);
+  if(a!==0&&(a<0.01||a>=1e6))return x.toExponential(2);
+  if(Number.isInteger(x))return String(x);
+  return x.toFixed(a<1?4:2);
+}
+
+/* Binary-search the sample nearest a timestamp (data is time-sorted). Used by
+   the crosshair readout. Returns null for an empty series. */
+export function nearestSample(d,t){
+  if(!d.length)return null;
+  if(t<=d[0].t)return d[0];
+  const last=d[d.length-1]; if(t>=last.t)return last;
+  let lo=0,hi=d.length-1;
+  while(lo<hi){const mid=(lo+hi)>>1; if(d[mid].t<t)lo=mid+1; else hi=mid;}
+  const b=d[lo],a=d[lo-1]||b;
+  return (t-a.t<=b.t-t)?a:b;
+}
+
+/* Trigger a client-side file download from a Blob. */
+export function downloadBlob(name,blob){
+  const a=document.createElement("a");
+  const u=URL.createObjectURL(blob);
+  a.href=u;a.download=name;document.body.appendChild(a);a.click();
+  setTimeout(()=>{a.remove();URL.revokeObjectURL(u);},0);
+}
+
+/* Local timestamp for export filenames (YYYYMMDD-HHMMSS). */
+export function tstamp(){
+  const d=new Date();const p=n=>String(n).padStart(2,"0");
+  return d.getFullYear()+p(d.getMonth()+1)+p(d.getDate())+"-"+p(d.getHours())+p(d.getMinutes())+p(d.getSeconds());
+}
+
+/* Transient toast (unresolved specs / errors / info). */
+export function toast(msg,kind){
+  const box=document.getElementById("toast");
+  if(!box)return;
+  const el=document.createElement("div");
+  el.className="t"+(kind==="info"?" info":"");
+  el.textContent=msg;
+  box.appendChild(el);
+  setTimeout(()=>{el.style.opacity="0";el.style.transition="opacity .4s";},kind==="info"?2500:4500);
+  setTimeout(()=>el.remove(),kind==="info"?2900:4900);
+}

package/tracer/ui/watchlist.js

@@ -0,0 +1,179 @@
+/* Unified "Signals" panel: add row with a custom autocomplete dropdown, presets,
+   and the live signal list (color / show-hide / name / encoding / remove / stats).
+   Replaces the old native <datalist> (clunky, whole-field matching) and merges
+   the former separate "Signals & stats" panel into one place.
+
+   Rows are built with DOM nodes + textContent (signal names are server/spec
+   strings) so nothing is interpolated into innerHTML. */
+
+import { sigs, bus } from "./state.js";
+import { cssid, hex6 } from "./util.js";
+import { addSpecs, removeSignal, wsSend } from "./connection.js";
+import { getSuggestList, symMeta, baseName, metaHint } from "./symbols.js";
+
+const PRESETS=[
+  ["ADC raw","s_adc_raw[0],s_adc_raw[1],s_adc_raw[2],s_adc_raw[3]"],
+  ["Voltages","s_vbat_mv,s_vbus_stm_mv,s_vbus_esp_mv"],
+  ["Pads","s_inputs[1],s_inputs[2]"],
+  ["Pad pressure","s_inputs[3],s_inputs[4],s_inputs[5],s_inputs[6]"],
+  ["Encoder","s_inputs[0]"],
+  ["Buttons","s_inputs[44]"],
+];
+
+let inp=null, ac=null, list=null, empty=null;
+let acItems=[];   // current dropdown specs
+let acSel=-1;     // highlighted index (-1 = none)
+
+/* ---------- live signal list ---------- */
+function rowFor(name, s){
+  const row=document.createElement("div");
+  row.className="sig"+(s.on?"":" off");
+
+  const color=document.createElement("input");
+  color.type="color"; color.className="sw"; color.value=hex6(s.color); color.title="signal color";
+  color.oninput=()=>{ s.color=color.value; };
+
+  const cb=document.createElement("input");
+  cb.type="checkbox"; cb.checked=!!s.on; cb.title="show / hide";
+  cb.onchange=()=>{ s.on=cb.checked; row.classList.toggle("off",!s.on); };
+
+  const nm=document.createElement("span");
+  nm.className="signame"; nm.textContent=name; nm.title="click to show / hide";
+  nm.onclick=()=>{ s.on=!s.on; cb.checked=s.on; row.classList.toggle("off",!s.on); };
+
+  const enc=document.createElement("span");
+  enc.className="enc"; if(s.encoding) enc.textContent=s.encoding;
+
+  const rm=document.createElement("span");
+  rm.className="rm"; rm.textContent="×"; rm.title="remove";
+  rm.onclick=()=>removeSignal(name);
+
+  const head=document.createElement("div");
+  head.className="sighead";
+  head.append(color, cb, nm, enc, rm);
+
+  const stats=document.createElement("div");
+  stats.className="stats"; stats.id="st-"+cssid(name);
+
+  row.append(head, stats);
+  return row;
+}
+
+/* Rebuild the list to match the current sigs map (assigned to bus.rebuildList). */
+function buildList(){
+  if(!list)return;
+  list.textContent="";
+  for(const [name,s] of sigs) list.appendChild(rowFor(name,s));
+  if(empty) empty.style.display = sigs.size ? "none" : "block";
+}
+
+/* ---------- custom autocomplete dropdown ---------- */
+/* Active comma-token around the caret; preserves earlier/later tokens. */
+function tokenCtx(){
+  const val=inp.value;
+  const caret=(inp.selectionStart!=null)?inp.selectionStart:val.length;
+  const start=val.lastIndexOf(",",caret-1)+1;
+  let end=val.indexOf(",",caret); if(end<0)end=val.length;
+  return { prefix:val.slice(0,start), token:val.slice(start,end).trim(), suffix:val.slice(end) };
+}
+
+function matchesFor(token){
+  const all=getSuggestList();
+  if(!token) return all.slice(0,200);
+  const tl=token.toLowerCase(), pref=[], sub=[];
+  for(const sgn of all){
+    const sl=sgn.toLowerCase();
+    if(sl.startsWith(tl)) pref.push(sgn);
+    else if(sl.indexOf(tl)>=0) sub.push(sgn);
+  }
+  return pref.concat(sub).slice(0,200);
+}
+
+function renderDropdown(){
+  if(!ac)return;
+  const { token }=tokenCtx();
+  acItems=matchesFor(token);
+  acSel=-1;
+  ac.textContent="";
+  if(!acItems.length){ ac.hidden=true; return; }
+  acItems.forEach((spec,i)=>{
+    const opt=document.createElement("div");
+    opt.className="ac-opt";
+    const nm=document.createElement("span"); nm.className="ac-spec"; nm.textContent=spec;
+    opt.appendChild(nm);
+    const hint=metaHint(spec);
+    if(hint){ const h=document.createElement("span"); h.className="ac-hint"; h.textContent=hint; opt.appendChild(h); }
+    // mousedown (not click) so it fires before the input blur closes the list.
+    opt.addEventListener("mousedown",(e)=>{ e.preventDefault(); accept(i); });
+    ac.appendChild(opt);
+  });
+  ac.hidden=false;
+}
+
+function highlight(i){
+  const opts=ac.children;
+  if(acSel>=0&&opts[acSel]) opts[acSel].classList.remove("sel");
+  acSel=i;
+  if(acSel>=0&&opts[acSel]){ opts[acSel].classList.add("sel"); opts[acSel].scrollIntoView({block:"nearest"}); }
+}
+
+/* Accept suggestion `i`: replace the active token, keep focus, re-suggest. */
+function accept(i){
+  const spec=acItems[i]; if(spec==null)return;
+  const { prefix, suffix }=tokenCtx();
+  const lead=prefix.length?(prefix.replace(/\s*$/,"")+" "):"";
+  inp.value=lead+spec+suffix;
+  const caret=lead.length+spec.length;
+  inp.focus(); inp.setSelectionRange(caret,caret);
+  renderDropdown();
+}
+
+function closeDropdown(){ if(ac){ ac.hidden=true; acSel=-1; } }
+
+function submitAdd(){
+  const specs=inp.value.split(",");
+  if(specs.some(s=>s.trim())){ addSpecs(specs); inp.value=""; }
+  closeDropdown();
+}
+
+/* ---------- init ---------- */
+export function initWatchlist(){
+  inp=document.getElementById("addInput");
+  ac=document.getElementById("ac");
+  list=document.getElementById("siglist");
+  empty=document.getElementById("noSigs");
+
+  document.getElementById("addBtn").onclick=submitAdd;
+
+  inp.addEventListener("input",renderDropdown);
+  inp.addEventListener("click",renderDropdown);
+  inp.addEventListener("focus",renderDropdown);
+  inp.addEventListener("blur",()=>setTimeout(closeDropdown,120));
+  inp.addEventListener("keydown",(e)=>{
+    if(ac && !ac.hidden && acItems.length){
+      if(e.key==="ArrowDown"){ e.preventDefault(); highlight((acSel+1)%acItems.length); return; }
+      if(e.key==="ArrowUp"){ e.preventDefault(); highlight((acSel-1+acItems.length)%acItems.length); return; }
+      if(e.key==="Escape"){ closeDropdown(); return; }
+      if(e.key==="Enter" && acSel>=0){ e.preventDefault(); accept(acSel); return; }
+    }
+    if(e.key==="Enter"){ submitAdd(); }
+  });
+
+  // presets
+  const box=document.getElementById("presets");
+  for(const [label,specs] of PRESETS){
+    const b=document.createElement("button");
+    b.textContent=label; b.title=specs;
+    b.onclick=()=>addSpecs(specs.split(","));
+    box.appendChild(b);
+  }
+  document.getElementById("clearAll").onclick=()=>{
+    const names=[...sigs.keys()];
+    if(names.length) wsSend({cmd:"remove",signals:names});
+  };
+
+  // register view hooks + initial paint
+  bus.rebuildList=buildList;
+  bus.onSymbols=()=>{ if(ac && !ac.hidden) renderDropdown(); };
+  buildList();
+}

package/vscode-extension/README.md

@@ -0,0 +1,32 @@
+# CrossPad SWD Tracer Bridge
+
+Tiny VS Code extension that lets the `crosspad-mcp` SWD tracer open its live
+dashboard **inside VS Code** (a Simple Browser editor tab) instead of the system
+browser.
+
+VS Code exposes no CLI / external command to open its in-editor browser, but it
+does register itself as the OS handler for the `vscode://` scheme. This extension
+registers a URI handler for its own id, so the tracer can fire:
+
+```
+vscode://crosspad.swd-tracer-bridge/open?url=http%3A%2F%2Flocalhost%3A7373%2F
+```
+
+and the extension opens that URL in a Simple Browser tab.
+
+## Install (local)
+
+```bash
+cd vscode-extension
+npx --yes @vscode/vsce package          # → swd-tracer-bridge-0.1.0.vsix
+code --install-extension swd-tracer-bridge-0.1.0.vsix
+```
+
+Then set the tracer to VS Code mode (default):
+
+```
+crosspad_trace action=config_set key=ui_open value=vscode
+```
+
+`ui_open`: `vscode` (default — open in a VS Code tab via this bridge) ·
+`browser` (system browser) · `none` (don't auto-open).

package/vscode-extension/extension.js

@@ -0,0 +1,56 @@
+// CrossPad SWD Tracer Bridge — opens the tracer dashboard in a VS Code editor
+// tab in response to a vscode:// deep link fired by the MCP server.
+//
+// Flow:  crosspad_trace action=start (ui_open=vscode)
+//          → server: xdg-open "vscode://crosspad.swd-tracer-bridge/open?url=<http url>"
+//          → OS routes vscode:// to VS Code → activates this extension (onUri)
+//          → handleUri() opens the URL in a Simple Browser editor tab.
+//
+// This is the only mechanism that lets an EXTERNAL process open an in-editor
+// browser tab: VS Code has no CLI / generic external command for it, but it does
+// register itself as the OS handler for the vscode:// scheme, and an extension
+// may register a URI handler for its own extension id.
+const vscode = require("vscode");
+
+function activate(context) {
+  context.subscriptions.push(
+    vscode.window.registerUriHandler({
+      handleUri(uri) {
+        // Expect: vscode://crosspad.swd-tracer-bridge/open?url=<encoded http url>
+        let raw = null;
+        try {
+          raw = new URLSearchParams(uri.query).get("url");
+        } catch (_e) {
+          return;
+        }
+        if (!raw) return;
+        // SECURITY: the deep link is invokable by ANY web page / process, so the
+        // `url` is untrusted. The only legitimate target is the local tracer
+        // dashboard, so hard-restrict to http(s) on a loopback host and reject
+        // everything else. Do NOT fall back to env.openExternal — that would let
+        // a crafted vscode:// link open arbitrary URIs (file://, mailto:, other
+        // schemes) system-wide. Simple Browser is an in-editor webview, safe.
+        let parsed;
+        try {
+          parsed = new URL(raw);
+        } catch (_e) {
+          return;
+        }
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return;
+        if (!["127.0.0.1", "localhost", "::1"].includes(parsed.hostname)) return;
+        const url = parsed.toString();
+        Promise.resolve(vscode.commands.executeCommand("simpleBrowser.show", url)).then(
+          undefined,
+          () =>
+            Promise.resolve(
+              vscode.commands.executeCommand("simpleBrowser.api.open", vscode.Uri.parse(url)),
+            ).then(undefined, () => { /* in-editor open failed; do not escalate to external */ }),
+        );
+      },
+    }),
+  );
+}
+
+function deactivate() {}
+
+module.exports = { activate, deactivate };

package/vscode-extension/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "swd-tracer-bridge",
+  "displayName": "CrossPad SWD Tracer Bridge",
+  "description": "Opens the CrossPad SWD tracer dashboard in a VS Code Simple Browser tab when the tracer fires a vscode:// deep link (so `crosspad_trace action=start` auto-opens the live view inside the editor instead of the system browser).",
+  "publisher": "crosspad",
+  "version": "0.1.2",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/CrossPad/crosspad-mcp.git" },
+  "engines": { "vscode": "^1.80.0" },
+  "categories": ["Other"],
+  "activationEvents": ["onStartupFinished"],
+  "main": "./extension.js",
+  "contributes": {}
+}