tabtree-mcp 1.6.0 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tabtree-mcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "mcpName": "app.tabtree/tabtree",
   "description": "Let Claude read your TabTree library and build mind maps, kanban boards and whiteboards in your TabTree account — team spaces included.",
   "repository": {

package/tabtree-mcp.mjs

@@ -672,6 +672,13 @@ function fitSize(text, w, h, kind, want){
   return { size: 9, shrunk: true, readable: false };
 }
 
+// L'ordre de superposition (`z`, ≡ `zOk` de l'app) : un entier [-9, 9], 0 omis. À z égal l'app peint
+// par nature — images < formes < flèches < tracés < post-it — donc un panneau coloré REMPLI recouvre
+// un logo posé dedans : `z:-1` sur le panneau (ou `z:1` sur l'image) est ce qui le remet devant.
+function zMcp(v){
+  const n = Math.round(+v);
+  return (v != null && isFinite(n) && n >= -9 && n <= 9 && n !== 0) ? n : undefined;
+}
 function buildBoardDoc(name, elements, connections, style){
   if(!Array.isArray(elements) || !elements.length) throw new Error("`elements` must be a non-empty list.");
   const imgCount = elements.filter(e=>e && e.kind === "image").length;
@@ -689,7 +696,7 @@ function buildBoardDoc(name, elements, connections, style){
       if(w && !h) h = Math.max(24, Math.round(w / ar));
       else if(h && !w) w = Math.max(24, Math.round(h * ar));
       else if(!w && !h){ if(ar >= 1){ w = 220; h = Math.max(24, Math.round(220 / ar)); } else { h = 220; w = Math.max(24, Math.round(220 * ar)); } }
-      return { lid: String(e.id != null ? e.id : i), kind: "image", text: "", src: im.src,
+      return { lid: String(e.id != null ? e.id : i), kind: "image", text: "", src: im.src, z: zMcp(e.z),
                x: Number.isFinite(+e.x) && e.x!=null ? Math.round(+e.x) : null,
                y: Number.isFinite(+e.y) && e.y!=null ? Math.round(+e.y) : null, w, h };
     }
@@ -708,7 +715,8 @@ function buildBoardDoc(name, elements, connections, style){
              // L'image sans octets sur un élément de board (2026-09-03) : même frontière que
              // pour un nœud — un id inventé retombe sur « aucune image », jamais sur du balisage.
              // Pas sur un secteur, un gradin ou un chevron : leur silhouette n'a pas de « haut ».
-             pic: (e.pic != null && !["arc","trap","chev"].includes(kind)) ? okPic(String(e.pic)) : "" };
+             pic: (e.pic != null && !["arc","trap","chev"].includes(kind)) ? okPic(String(e.pic)) : "",
+             z: zMcp(e.z) };
   });
   const byId = new Map();
   for(const e of els){
@@ -775,10 +783,10 @@ function buildBoardDoc(name, elements, connections, style){
   for(const e of els){
     if(e.kind==="image"){
       refOf.set(e.lid, "im:" + images.length);
-      images.push({ id: "im" + images.length, src: e.src, x: e.x, y: e.y, w: e.w, h: e.h });
+      images.push({ id: "im" + images.length, src: e.src, x: e.x, y: e.y, w: e.w, h: e.h, z: e.z });
     } else if(e.kind==="sticky"){
       refOf.set(e.lid, "st:" + stickies.length);
-      stickies.push({ text:e.text, x:e.x, y:e.y, w:e.w, h:e.h, color:e.color, size:e.size||undefined, pic:e.pic||undefined });
+      stickies.push({ text:e.text, x:e.x, y:e.y, w:e.w, h:e.h, color:e.color, size:e.size||undefined, pic:e.pic||undefined, z:e.z });
     } else {
       refOf.set(e.lid, "sh:" + shapes.length);
       shapes.push({ kind:e.kind, x:e.x, y:e.y, w:e.w, h:e.h, color:e.kind==="text" ? "#ffffff" : e.color, text:e.text, size:e.size||undefined,
@@ -786,7 +794,8 @@ function buildBoardDoc(name, elements, connections, style){
                     tk: e.tk != null ? e.tk : undefined,
                     a0: e.a0 != null ? e.a0 : undefined,
                     a1: e.a1 != null ? e.a1 : undefined,
-                    ir: e.ir != null ? e.ir : undefined });
+                    ir: e.ir != null ? e.ir : undefined,
+                    z: e.z });
     }
   }
   const arrows = conns.map(c=>{
@@ -995,15 +1004,27 @@ function boardToText(doc){
     const o = arr[i];
     return o ? `${tag}${i} ${JSON.stringify((o.text||"(no text)").slice(0,60))}` : tag+i+" ?";
   };
+  const zs = o=>o && o.z ? ` z:${o.z}` : "";
   lines.push(`Shapes (${(doc.shapes||[]).length}):`);
-  (doc.shapes||[]).forEach((s,i)=>lines.push(`  sh:${i} [${s.kind}] ${JSON.stringify((s.text||"").slice(0,80))} @(${s.x},${s.y}) ${s.w}×${s.h}`));
+  (doc.shapes||[]).forEach((s,i)=>lines.push(`  sh:${i} [${s.kind}] ${JSON.stringify((s.text||"").slice(0,80))} @(${s.x},${s.y}) ${s.w}×${s.h}${zs(s)}`));
+  // Les images d'un board (2026-10-23) : le type et le poids, jamais les octets — une data URL de
+  // 200 Ko dans la réponse noierait tout le reste, et Claude n'en lirait rien.
+  const imgs = (doc.images||[]);
+  if(imgs.length){
+    lines.push(`Images (${imgs.length}):`);
+    imgs.forEach((m,i)=>{
+      const t = (/^data:image\/([a-z+.-]+)/i.exec(m.src||"") || [,"?"])[1].replace("svg+xml","svg");
+      lines.push(`  im:${i} [${t}, ${Math.round(String(m.src||"").length * 3 / 4 / 1024)} KB] @(${m.x},${m.y}) ${m.w}×${m.h}${zs(m)}`);
+    });
+  }
   if((doc.stickies||[]).length){
     lines.push(`Sticky notes (${doc.stickies.length}):`);
     doc.stickies.forEach((s,i)=>lines.push(`  st:${i} ${JSON.stringify((s.text||"").slice(0,80))} @(${s.x},${s.y})`));
   }
   const named = ref=>{
     if(typeof ref !== "string") return null;
-    const m = /^(sh|st):(\d+)$/.exec(ref); if(!m) return null;
+    const m = /^(sh|st|im):(\d+)$/.exec(ref); if(!m) return null;
+    if(m[1]==="im") return (doc.images||[])[+m[2]] ? "im:" + m[2] + " (image)" : "im:" + m[2] + " ?";
     return label(m[1]==="sh" ? (doc.shapes||[]) : (doc.stickies||[]), +m[2], m[1]+":");
   };
   if((doc.arrows||[]).length){
@@ -1731,7 +1752,8 @@ const TOOLS = [
         a1:{ type:"number", description:"arc only — end angle in degrees (a1 > a0; a full circle is a0=0, a1=360)" },
         ir:{ type:"number", description:"arc only — inner-radius fraction 0..0.9 (0 = pie slice, 0.55 = donut)" },
         file:{ type:"string", description:"image only — full path of a PNG/JPEG/WebP/GIF/SVG file on this machine. Rasters are re-encoded to about 840 px; an SVG is kept as is (300 KB max)." },
-        data:{ type:"string", description:"image only — a data:image/(png|jpeg|webp|gif|svg+xml) URL instead of a file" }
+        data:{ type:"string", description:"image only — a data:image/(png|jpeg|webp|gif|svg+xml) URL instead of a file" },
+        z:{ type:"number", description:"Stacking order, -9..9 (default 0). At equal z the app paints images UNDER shapes, shapes under sticky notes — so a filled background panel hides a logo placed on it. Give such a panel z:-1 (or the image z:1) to keep the picture visible." }
       }, additionalProperties:false } },
       connections:{ type:"array", description:"Arrows anchored between elements (by id)", items:{ type:"object", properties:{
         from:{ type:"string" }, to:{ type:"string" }
@@ -2168,7 +2190,7 @@ function handle(msg){
       // déjà dérivé (1.0.0 ici, 1.1.0 dans le manifeste) sans que rien ne le
       // signale : un client affiche l'une, le registre publie l'autre. Un
       // autotest les compare désormais toutes les quatre.
-      serverInfo: { name: "tabtree", version: "1.6.0" }
+      serverInfo: { name: "tabtree", version: "1.6.1" }
     });
   } else if(method === "notifications/initialized" || (method||"").startsWith("notifications/")){
     // notification : pas de réponse