fui-studio-mcp 0.1.0 → 0.1.1

package/README.md

@@ -22,6 +22,8 @@ on your computer when it needs it. You don't run it yourself.
 
 Make a folder for your FUI projects, for example `FUI-Studio` in your home
 folder. The assistant saves there, and the studio watches the same folder.
+If the config names no folder, the server uses `FUI-Studio` in your home
+folder.
 
 ## 2. Add the server to your AI app
 
@@ -82,7 +84,8 @@ over stdio. Instead of `--projects`, you can set the environment variable
 ## 3. Open the same folder in the studio
 
 In FUI Studio, click **folder…** in the toolbar and choose your projects
-folder. Once the assistant has saved a project, open it from **Open**. From
+folder, the same one as in step 1. The assistant also tells you the folder
+when it first saves. Once it has saved a project, open it from **Open**. From
 then on, every save the assistant makes shows up within a second, on the page
 you're looking at. One undo takes a change back.
 
@@ -130,14 +133,19 @@ projects fit together.
 
 ## Troubleshooting
 
-- **The assistant says it has no projects folder.** Your config is missing
-  `--projects`.
+- **The assistant saved somewhere else.** Its save message names the folder.
+  Without `--projects` in the config, it saves in `FUI-Studio` in your home
+  folder.
+- **Changing the folder.** For the assistant, change the path after
+  `--projects` in its config and restart your AI app; with Claude Code, run
+  `claude mcp remove fui-studio` and the add command again. For the studio,
+  choose **change folder…** at the bottom of the **Open** dialog.
 - **"npx: command not found", or the server won't start.** Install Node.js,
   then restart your AI app. Apps started from the Dock or Start menu may not
   see a Node installed through nvm; in that case, put the full path to `npx`
   in `"command"`.
 - **The studio doesn't update.** Check that it has the same folder open
-  (**folder…**), and that you opened the very project the assistant is
+  (the **Open** dialog shows which), and that you opened the very project the assistant is
   saving.
 - **Which version is this?** Run `npx fui-studio-mcp --version`.
 

package/dist/{chunk-RAHWGTHJ.js → chunk-EFZHSV66.js}

@@ -11,7 +11,7 @@ import {
   localFontBytes,
   parseBdf,
   resolveFace
-} from "./chunk-W7L36Z34.js";
+} from "./chunk-NDQB3ETD.js";
 
 // ../../packages/fonts/dist/chunk-MTHRWFM6.js
 import * as opentype from "opentype.js";

package/dist/{chunk-W7L36Z34.js → chunk-NDQB3ETD.js}

@@ -2294,7 +2294,6 @@ function makeCookContext(input) {
     params,
     inputs,
     wires,
-    wiredOutputs: input.wiredOutputs ?? /* @__PURE__ */ new Set(),
     inputList: (name) => multiInputs[name] ?? (inputs[name] ? [inputs[name]] : []),
     scope,
     num: (key, i, n, vars) => resolveNumber(params, key, fallbackNum(key), scope(i, n, vars)),
@@ -2805,10 +2804,6 @@ function evaluate(project, registry, opts = {}) {
     }
     const def = registry.requireNode(node);
     const edges = incoming.get(node.id) ?? [];
-    const claiming = def.outputs.filter((o) => o.claims).map((o) => o.name);
-    const wiredOutputs = new Set(
-      claiming.length === 0 ? [] : project.graph.edges.filter((e) => e.from === node.id && claiming.includes(e.fromPort)).map((e) => e.fromPort)
-    );
     const seed = node.seed ?? project.seed;
     let wires = wiresOf.get(node.id);
     if (!wires) {
@@ -2891,16 +2886,12 @@ function evaluate(project, registry, opts = {}) {
       continue;
     }
     if (opts.vectors && readsPixels(def)) {
+      const shapes = opts.vectors(node.id);
+      const outPort = def.outputs[0];
       const out = {};
-      const keys = [];
-      for (const port of def.outputs) {
-        if (port.type !== "shapes") continue;
-        const shapes = opts.vectors(node.id, port.name);
-        if (shapes) out[port.name] = shapesVal(shapes);
-        keys.push(shapes ? String(identityKey(shapes)) : "none");
-      }
+      if (shapes && outPort) out[outPort.name] = shapesVal(shapes);
       outputs.set(node.id, withTaps(node.id, out));
-      hashes.set(node.id, hashOf("provided", node.id, ...keys));
+      hashes.set(node.id, hashOf("provided", node.id, shapes ? String(identityKey(shapes)) : "none"));
       continue;
     }
     if (node.disabled) {
@@ -2936,9 +2927,7 @@ function evaluate(project, registry, opts = {}) {
       timeDeps.has(node.id) ? String(tNode) : "",
       // The outliner arriving mid-session must invalidate text cooked without
       // it — one global salt, one full re-cook, then business as usual.
-      opts.outliner ? "o1" : "o0",
-      // A claiming output wired or not reshapes the others (Contours' major).
-      [...wiredOutputs].sort().join(",")
+      opts.outliner ? "o1" : "o0"
     );
     hashes.set(node.id, nodeHash);
     const hit = upstreamTainted ? void 0 : cache22?.get(node.id, nodeHash);
@@ -2947,7 +2936,6 @@ function evaluate(project, registry, opts = {}) {
       continue;
     }
     const ctx = makeCookContext({
-      wiredOutputs,
       nodeId: node.id,
       name: node.name,
       seed,
@@ -9025,6 +9013,16 @@ var transformNode = {
       description: "With a Ref wired: the point on its bounds the pivot lands on. Move X/Y are measured from it; Rotate and Scale turn about it.",
       dimWhen: refUnwired
     },
+    {
+      key: "refMix",
+      label: "Mix",
+      type: "number",
+      default: 1,
+      step: 0.01,
+      group: "Ref",
+      description: "How far along the way to the Ref point: 0 leaves the shape where it was authored, 1 lands it on the point. Wire a Seq or Mapping in to glide it there; past 0\u20131 it overshoots.",
+      dimWhen: refUnwired
+    },
     {
       key: "refEach",
       label: "Per Shape",
@@ -9057,10 +9055,11 @@ var transformNode = {
         const b = each ? shapeBounds(ref[i % ref.length]) : whole;
         if (!b) return shape;
         const { fx, fy } = REF_POINTS[point];
-        const R = { x: b.x + fx * b.w, y: b.y + fy * b.h };
+        const P = pivotFor(ctx, pivotMode, shape, i, n);
+        const mix = ctx.num("refMix", i, n);
+        const R = { x: P.x + mix * (b.x + fx * b.w - P.x), y: P.y + mix * (b.y + fy * b.h - P.y) };
         const tx = ctx.num("tx", i, n);
         const ty = ctx.num("ty", i, n);
-        const P = pivotFor(ctx, pivotMode, shape, i, n);
         const rot = ctx.num("rotation", i, n);
         const sx = ctx.num("sx", i, n);
         const sy = ctx.num("sy", i, n);
@@ -14942,10 +14941,16 @@ function fieldRef(p, shape, world, n, defs) {
   defs.push(`<pattern id="${id}" ${attrs.join(" ")}>${image}</pattern>`);
   return `url(#${id})`;
 }
-function styleAttrs(fill, stroke, style, n) {
+function paintAttr(name, color, n) {
+  const h = color.startsWith("#") ? splitHex(color) : void 0;
+  if (!h) return [`${name}="${color}"`];
+  return h.a < 1 ? [`${name}="${h.rgb}"`, `${name}-opacity="${n(h.a)}"`] : [`${name}="${color}"`];
+}
+function styleAttrs(fill, stroke, style, n, split = true) {
   const out = [];
-  if (fill !== void 0) out.push(`fill="${fill}"`);
-  if (stroke !== void 0 && stroke !== "none") out.push(`stroke="${stroke}"`);
+  const attr = (name, color) => split ? paintAttr(name, color, n) : [`${name}="${color}"`];
+  if (fill !== void 0) out.push(...attr("fill", fill));
+  if (stroke !== void 0 && stroke !== "none") out.push(...attr("stroke", stroke));
   if (style.strokeWidth !== void 0 && stroke !== "none") {
     out.push(`stroke-width="${n(style.strokeWidth)}"`);
   }
@@ -14978,7 +14983,7 @@ function renderShape(shape, opts, depth, pretty, parent = IDENTITY) {
   const defs = [];
   const fill = paintRef(shape.style.fill, shape, world, n, defs);
   const stroke = paintRef(shape.style.stroke, shape, world, n, defs);
-  const element = renderElement(shape, opts, depth, pretty, world, styleAttrs(fill, stroke, shape.style, n));
+  const element = renderElement(shape, opts, depth, pretty, world, styleAttrs(fill, stroke, shape.style, n, shape.kind !== "group"));
   if (defs.length === 0) return element;
   return `${pad}<g>${nl}${pad}<defs>${defs.join("")}</defs>${nl}${element}${pad}</g>${nl}`;
 }
@@ -15067,7 +15072,7 @@ function renderSvg(scene, options = {}) {
   const defs = options.defs ? `${pretty ? "  " : ""}<defs>${options.defs}</defs>${nl}` : "";
   const ox = scene.origin === "center" ? -scene.width / 2 : 0;
   const oy = scene.origin === "center" ? -scene.height / 2 : 0;
-  const bg = scene.background && scene.background !== "none" ? `${pretty ? "  " : ""}<rect x="${n(ox)}" y="${n(oy)}" width="${n(scene.width)}" height="${n(scene.height)}" fill="${scene.background}"/>${nl}` : "";
+  const bg = scene.background && scene.background !== "none" ? `${pretty ? "  " : ""}<rect x="${n(ox)}" y="${n(oy)}" width="${n(scene.width)}" height="${n(scene.height)}" ${paintAttr("fill", scene.background, n).join(" ")}/>${nl}` : "";
   const view = options.crop ?? { x: ox, y: oy, w: scene.width, h: scene.height };
   return `<svg xmlns="http://www.w3.org/2000/svg" width="${n(view.w)}" height="${n(view.h)}" viewBox="${n(view.x)} ${n(view.y)} ${n(view.w)} ${n(view.h)}">${nl}${defs}${bg}${body}</svg>${nl}`;
 }

package/dist/{dist-3URVYEPT.js → dist-RTISZO3Q.js}

@@ -28,7 +28,7 @@ import {
   stripPost,
   templateFiles,
   usedFonts
-} from "./chunk-W7L36Z34.js";
+} from "./chunk-NDQB3ETD.js";
 export {
   OGRAF_KINDS,
   SCHEMA_URL,

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   allTtfBuffers,
   fontDefs,
   nodeOutliner
-} from "./chunk-RAHWGTHJ.js";
+} from "./chunk-EFZHSV66.js";
 import {
   DEFAULT_FONT_FAMILY,
   Keyframe,
@@ -38,7 +38,7 @@ import {
   wouldCycle,
   yuvFrameBytes,
   yuvToRgb
-} from "./chunk-W7L36Z34.js";
+} from "./chunk-NDQB3ETD.js";
 
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -46,6 +46,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z as z2 } from "zod";
 import { createRequire as createRequire3 } from "module";
 import { homedir } from "os";
+import { dirname as dirname3, join as join4 } from "path";
 
 // src/session.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync, statSync, writeFileSync, mkdirSync } from "fs";
@@ -755,6 +756,14 @@ var Session = class {
    * come from that folder instead.
    */
   held = /* @__PURE__ */ new Map();
+  /**
+   * Nodes added this session without a position. A save lays them out —
+   * columns by wire depth, as the studio's L does — so the graph reads in
+   * the studio instead of arriving as one endless row. Nodes with a
+   * position of their own (the model's, or the person's in a file that
+   * was opened) never move.
+   */
+  placed = /* @__PURE__ */ new Set();
   bumpIds() {
     for (const n of this.project.graph.nodes) {
       const m = /(\d+)$/.exec(n.id);
@@ -770,6 +779,7 @@ var Session = class {
     this.path = void 0;
     this.stamp = void 0;
     this.held.clear();
+    this.placed.clear();
     return this.project;
   }
   open(path) {
@@ -781,6 +791,7 @@ var Session = class {
     this.path = abs;
     this.stamp = stamp;
     this.held.clear();
+    this.placed.clear();
     this.bumpIds();
     return { project, warnings };
   }
@@ -802,6 +813,7 @@ var Session = class {
         );
       }
     }
+    this.arrange();
     mkdirSync(dirname2(target), { recursive: true });
     this.writeHeldAssets(target);
     writeFileSync(target, serializeProject(this.project));
@@ -923,6 +935,7 @@ var Session = class {
       }
     }
     this.project.graph.nodes.push(node);
+    if (!options.position) this.placed.add(id);
     return node;
   }
   /**
@@ -943,9 +956,47 @@ var Session = class {
     const last = nodes[nodes.length - 1];
     return last ? { x: last.position.x + 260, y: last.position.y } : { x: 0, y: 0 };
   }
+  /**
+   * Lay out the nodes this session placed, page by page (the root, and each
+   * Layer's own). A page of nothing but such nodes is arranged whole, every
+   * save, so it stays tidy as it grows; on a page that also holds nodes with
+   * positions of their own, the new ones are arranged among themselves and
+   * set below what is already there.
+   */
+  arrange() {
+    const pages = /* @__PURE__ */ new Map();
+    for (const n of this.project.graph.nodes) {
+      const key = n.layer ?? "";
+      const list = pages.get(key);
+      if (list) list.push(n);
+      else pages.set(key, [n]);
+    }
+    for (const nodes of pages.values()) {
+      const moving = nodes.filter((n) => this.placed.has(n.id));
+      if (moving.length === 0) continue;
+      const staying = nodes.filter((n) => !this.placed.has(n.id));
+      const ids = new Set(moving.map((n) => n.id));
+      const edges = this.project.graph.edges.filter((e) => ids.has(e.from) && ids.has(e.to));
+      const origin = staying.length === 0 ? { x: 0, y: 0 } : {
+        x: Math.min(...staying.map((n) => n.position.x)),
+        y: Math.max(...staying.map((n) => n.position.y + nodeSize(n, registry.forNode(n)).height)) + 120
+      };
+      const at = columnLayout(moving, edges, origin);
+      for (const n of moving) n.position = at.get(n.id) ?? n.position;
+    }
+  }
+  /**
+   * Root-page nodes that draw straight onto the page because nothing takes
+   * their shapes — valid, but in the studio they read as forgotten wires.
+   */
+  looseDrawers() {
+    const feeding = new Set(this.project.graph.edges.map((e) => e.from));
+    return this.project.graph.nodes.filter((n) => n.layer === void 0 && !feeding.has(n.id)).filter((n) => registry.forNode(n)?.outputs.some((o) => o.type === "shapes")).map((n) => n.id);
+  }
   removeNode(id) {
     this.node(id);
     this.project.graph.nodes = this.project.graph.nodes.filter((n) => n.id !== id);
+    this.placed.delete(id);
     this.project.graph.edges = this.project.graph.edges.filter((e) => e.from !== id && e.to !== id);
   }
   setParam(nodeId, key, value) {
@@ -987,7 +1038,12 @@ var Session = class {
     }
     if (paramDef && !isExposable(paramDef)) fail(`${toNode.type}.${toPort} is not wireable.`);
     if (wouldCycle(this.project.graph, from, to, fromPort, toPort)) fail(`Connecting ${from} \u2192 ${to} would make a loop.`);
-    this.project.graph.edges = this.project.graph.edges.filter((e) => !(e.to === to && e.toPort === toPort));
+    if (toDef.inputs.find((i) => i.name === toPort)?.multi) {
+      const same = this.project.graph.edges.find((e) => e.from === from && e.fromPort === fromPort && e.to === to && e.toPort === toPort);
+      if (same) return same;
+    } else {
+      this.project.graph.edges = this.project.graph.edges.filter((e) => !(e.to === to && e.toPort === toPort));
+    }
     const edge = { id: makeId("edge"), from, fromPort, to, toPort };
     this.project.graph.edges.push(edge);
     const outType = fromDef.outputs.find((o) => o.name === fromPort)?.type;
@@ -997,10 +1053,13 @@ var Session = class {
     }
     return edge;
   }
-  disconnect(to, toPort) {
+  /** Remove the wires into a socket — only the one from `from`, when given (a Merge's `in` holds several). */
+  disconnect(to, toPort, from) {
     const before = this.project.graph.edges.length;
-    this.project.graph.edges = this.project.graph.edges.filter((e) => !(e.to === to && e.toPort === toPort));
-    if (this.project.graph.edges.length === before) fail(`Nothing is wired into ${to}.${toPort}.`);
+    this.project.graph.edges = this.project.graph.edges.filter(
+      (e) => !(e.to === to && e.toPort === toPort && (from === void 0 || e.from === from))
+    );
+    if (this.project.graph.edges.length === before) fail(`Nothing${from ? ` from ${from}` : ""} is wired into ${to}.${toPort}.`);
   }
   /**
    * Keyframes write into the same param model everything else uses — a track
@@ -1140,12 +1199,113 @@ var Session = class {
     return svgToPng(await this.renderSvgString(t, false), { scale });
   }
 };
+function nodeSize(node, def) {
+  if (node.micro) return { width: 80, height: 24 };
+  const width = def?.wide ? 456 : 228;
+  const outputs = def?.outputs.filter((o) => !o.hideWhen?.(node.params ?? {})).length ?? 0;
+  const height = node.collapsed ? 44 : 66 + Math.max(def?.inputs.length ?? 0, outputs) * 20 + (def?.params.length ?? 0) * 24;
+  return { width, height };
+}
+var COLUMN_HEIGHT = 1600;
+var ROW_GAP = 28;
+var COLUMN_GAP = 70;
+var BLOCK_GAP = 160;
+function columnLayout(nodes, edges, origin) {
+  const root = new Map(nodes.map((n) => [n.id, n.id]));
+  const find = (id) => {
+    let r = id;
+    while (root.get(r) !== r) r = root.get(r);
+    root.set(id, r);
+    return r;
+  };
+  for (const e of edges) if (root.has(e.from) && root.has(e.to)) root.set(find(e.from), find(e.to));
+  const wired = new Set(edges.flatMap((e) => [e.from, e.to]));
+  const blocks = /* @__PURE__ */ new Map();
+  const loose = [];
+  for (const n of nodes) {
+    if (!wired.has(n.id)) {
+      loose.push(n);
+      continue;
+    }
+    const key = find(n.id);
+    const list = blocks.get(key);
+    if (list) list.push(n);
+    else blocks.set(key, [n]);
+  }
+  const placed = /* @__PURE__ */ new Map();
+  let y = origin.y;
+  for (const block of [...blocks.values(), ...loose.length ? [loose] : []]) {
+    const bottom = layoutBlock(block, edges, { x: origin.x, y }, placed);
+    y = bottom + BLOCK_GAP;
+  }
+  return placed;
+}
+function layoutBlock(nodes, allEdges, origin, placed) {
+  const ids = new Set(nodes.map((n) => n.id));
+  const edges = allEdges.filter((e) => ids.has(e.from) && ids.has(e.to));
+  const incoming = /* @__PURE__ */ new Map();
+  for (const e of edges) {
+    const list = incoming.get(e.to);
+    if (list) list.push(e.from);
+    else incoming.set(e.to, [e.from]);
+  }
+  const colOf = /* @__PURE__ */ new Map();
+  const visiting = /* @__PURE__ */ new Set();
+  const col = (id) => {
+    const known = colOf.get(id);
+    if (known !== void 0) return known;
+    if (visiting.has(id)) return 0;
+    visiting.add(id);
+    const ins = incoming.get(id) ?? [];
+    const c = ins.length === 0 ? 0 : Math.max(...ins.map(col)) + 1;
+    visiting.delete(id);
+    colOf.set(id, c);
+    return c;
+  };
+  const columns = /* @__PURE__ */ new Map();
+  nodes.forEach((n) => {
+    const c = col(n.id);
+    const list = columns.get(c);
+    if (list) list.push(n);
+    else columns.set(c, [n]);
+  });
+  const order = new Map(nodes.map((n, i) => [n.id, i]));
+  const rowOf = /* @__PURE__ */ new Map();
+  let x = origin.x;
+  let bottom = origin.y;
+  for (const c of [...columns.keys()].sort((a, b) => a - b)) {
+    const list = columns.get(c);
+    const key = (n) => {
+      const ins = (incoming.get(n.id) ?? []).map((id) => rowOf.get(id) ?? 0);
+      return ins.length > 0 ? ins.reduce((sum, v) => sum + v, 0) / ins.length : -1;
+    };
+    list.sort((a, b) => key(a) - key(b) || order.get(a.id) - order.get(b.id));
+    let y = origin.y;
+    let widest = 0;
+    list.forEach((n, i) => {
+      const { width, height } = nodeSize(n, registry.forNode(n));
+      if (y > origin.y && y + height > origin.y + COLUMN_HEIGHT) {
+        x += widest + ROW_GAP;
+        y = origin.y;
+        widest = 0;
+      }
+      rowOf.set(n.id, i);
+      placed.set(n.id, { x, y });
+      y += height + ROW_GAP;
+      widest = Math.max(widest, width);
+      bottom = Math.max(bottom, y - ROW_GAP);
+    });
+    x += widest + COLUMN_GAP;
+  }
+  return bottom;
+}
 
 // src/index.ts
+var DEFAULT_PROJECTS = "FUI-Studio";
 function projectsFolder() {
   const at = process.argv.indexOf("--projects");
   const given = at >= 0 && process.argv[at + 1] ? process.argv[at + 1] : process.env.FUI_PROJECTS || void 0;
-  return given?.replace(/^~(?=$|[\\/])/, homedir());
+  return given?.replace(/^~(?=$|[\\/])/, homedir()) ?? join4(homedir(), DEFAULT_PROJECTS);
 }
 function version() {
   try {
@@ -1167,7 +1327,9 @@ How to work:
 2. Learn the library once: list_node_types, optionally by category. Generators draw shapes; modifiers change them; layout repeats and arranges; drivers (value, lfo, noise, time\u2026) produce numbers; post nodes are pixel effects.
 3. Build: add_node with params, then connect. Every param is also an input socket: connect(from: "lfo1", to: "ring1", toPort: "radius") makes the radius move. That is how things animate; set_keyframe is the other way, and params also take expressions ({"base": 5, "expr": "sin(t) * 10"}).
 4. Look: render_preview after each few edits and actually check the picture. Pass t (seconds) to see a moment of the animation.
-5. Save: save_project with a bare name ("radar") saves radar.tui in the projects folder.
+5. Save: save_project with a bare name ("radar") saves radar.tui in the projects folder. The first time you save, tell the user the full path the save reports, and that the studio shows the project live once they choose that same folder there (folder\u2026 in the toolbar, then Open).
+
+Keep the graph readable, because the user opens it in the studio. A node whose output is wired to nothing draws straight onto the page. That works, but a page of loose nodes looks like a graph with its wires missing. Gather the parts of one element (a radar's rings, ticks, labels and crosshair) into a Merge node: add_node merge, then connect each part to its "in" port. Merge draws in connection order, so the first wire is at the bottom. Give the Merge a name ("radar", "readout") so the studio shows what it is. Leave position out of add_node: on save, nodes without one are laid out in columns that follow the wires.
 
 Layers: a Layer node is a self-contained composition with its own page and its own clock. add_node with layer: "<layer id>" puts a node inside it. Arrange Layers in time with add_clip; a document with no clips plays every Layer all the time. list_layers explains the rules.
 
@@ -1223,7 +1385,15 @@ server.registerTool(
     description: 'Save the project. Without a path, writes back to where it was opened from. A relative path or bare name (".tui" is added) saves into the projects folder, where an open studio shows it at once. Writing back over a file someone saved since you opened it is refused unless overwrite is true.',
     inputSchema: { path: z2.string().optional(), overwrite: z2.boolean().default(false) }
   },
-  guard(({ path, overwrite }) => text(`saved ${session.save(path, { overwrite })}`))
+  guard(({ path, overwrite }) => {
+    const saved = session.save(path, { overwrite });
+    const loose = session.looseDrawers();
+    const nudge = loose.length > 3 ? `
+${loose.length} nodes draw with nothing wired to their output (${loose.join(", ")}). In the studio that reads as missing wires: gather each element's parts into a named Merge (connect in drawing order, first at the bottom) and save again.` : "";
+    const folder = session.root && dirname3(saved).startsWith(session.root) ? session.root : dirname3(saved);
+    return text(`saved ${saved}
+In FUI Studio, choose the folder ${folder} (folder\u2026 in the toolbar, or change folder\u2026 under Open) and open it from Open.${nudge}`);
+  })
 );
 server.registerTool(
   "list_projects",
@@ -1377,10 +1547,13 @@ server.registerTool(
 );
 server.registerTool(
   "disconnect",
-  { description: "Remove the wire feeding a socket.", inputSchema: { to: z2.string(), toPort: z2.string() } },
-  guard(({ to, toPort }) => {
-    session.disconnect(to, toPort);
-    return text(`disconnected ${to}.${toPort}`);
+  {
+    description: `Remove the wire feeding a socket. A multi input (a Merge's or Layer's "in") holds several: pass from to remove just that one, or leave it out to remove them all.`,
+    inputSchema: { to: z2.string(), toPort: z2.string(), from: z2.string().optional() }
+  },
+  guard(({ to, toPort, from }) => {
+    session.disconnect(to, toPort, from);
+    return text(`disconnected ${from ? `${from} \u2192 ` : ""}${to}.${toPort}`);
   })
 );
 server.registerTool(
@@ -1454,12 +1627,11 @@ server.registerTool(
   },
   guard(async ({ path, t, scale }) => {
     const { writeFileSync: writeFileSync2, mkdirSync: mkdirSync2 } = await import("fs");
-    const { dirname: dirname3 } = await import("path");
     const abs = session.resolvePath(path);
     mkdirSync2(dirname3(abs), { recursive: true });
     if (/\.(ograf|drfx)$/i.test(abs)) {
-      const { exportTemplate } = await import("./node-4RLELQ7B.js");
-      const { packDrfx, packOgraf } = await import("./dist-3URVYEPT.js");
+      const { exportTemplate } = await import("./node-3VDUDD3U.js");
+      const { packDrfx, packOgraf } = await import("./dist-RTISZO3Q.js");
       const template = exportTemplate(session.project, void 0, session.assetResolver());
       const errors = template.lint.filter((i) => i.level === "error");
       if (errors.length > 0) throw new SessionError(`The manifest has errors: ${errors.map((i) => `${i.where}: ${i.message}`).join("; ")}`);
@@ -1489,7 +1661,6 @@ server.registerTool(
   guard(async ({ dir, from, to, fps, scale }) => {
     if (to <= from) throw new SessionError("`to` must be after `from`.");
     const { writeFileSync: writeFileSync2, mkdirSync: mkdirSync2 } = await import("fs");
-    const { join: join4 } = await import("path");
     const abs = session.resolvePath(dir);
     mkdirSync2(abs, { recursive: true });
     const frames = Math.round((to - from) * fps);
@@ -1502,3 +1673,6 @@ server.registerTool(
   })
 );
 await server.connect(new StdioServerTransport());
+export {
+  DEFAULT_PROJECTS
+};

package/dist/{node-4RLELQ7B.js → node-3VDUDD3U.js}

@@ -2,10 +2,10 @@
 import {
   loadFaces,
   nodeOutliner
-} from "./chunk-RAHWGTHJ.js";
+} from "./chunk-EFZHSV66.js";
 import {
   buildTemplate
-} from "./chunk-W7L36Z34.js";
+} from "./chunk-NDQB3ETD.js";
 
 // ../../packages/ograf/dist/node.js
 import { existsSync, readFileSync } from "fs";