faux-studio 0.3.0 → 0.3.2

package/dist/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -11027,6 +11029,57 @@ var FIGMA_DESIGN_URL_RE = /figma\.com\/(file|design)\//;
 function findFigmaDesignTarget(targets) {
   return targets.find((t) => t.type === "page" && FIGMA_DESIGN_URL_RE.test(t.url)) || null;
 }
+async function probeCdpPorts() {
+  for (const port of KNOWN_CDP_PORTS) {
+    const { alive, isFigma } = await isCdpAlive(port);
+    if (alive && isFigma) {
+      const targets = await listTargets(port);
+      return { port, targets };
+    }
+  }
+  return null;
+}
+function killFigma() {
+  try {
+    if (process.platform === "darwin") {
+      execSync("pkill -x Figma", { stdio: "ignore" });
+      return true;
+    }
+    if (process.platform === "win32") {
+      execSync("taskkill /IM Figma.exe", { stdio: "ignore" });
+      return true;
+    }
+    execSync("pkill -x figma-linux", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function launchFigmaWithCdp() {
+  const figmaPath = findFigmaPath();
+  if (!figmaPath) {
+    throw new Error(
+      "Figma Desktop is not installed. Download from https://figma.com/downloads"
+    );
+  }
+  const port = await findAvailablePort();
+  log(`Launching Figma Desktop (port ${port})...`);
+  launchFigmaProcess(figmaPath, port);
+  const startTime = Date.now();
+  while (Date.now() - startTime < CDP_WAIT_TIMEOUT_MS) {
+    await new Promise((r) => setTimeout(r, CDP_POLL_INTERVAL_MS));
+    const { alive, isFigma } = await isCdpAlive(port);
+    if (alive && isFigma) {
+      await new Promise((r) => setTimeout(r, 2e3));
+      const targets = await listTargets(port);
+      log("Figma Desktop started");
+      return { port, targets };
+    }
+  }
+  throw new Error(
+    `Figma did not respond on port ${port} within ${CDP_WAIT_TIMEOUT_MS / 1e3}s. Try again.`
+  );
+}
 function launchFigmaProcess(figmaPath, port) {
   if (process.platform === "darwin") {
     spawn2("open", ["-a", figmaPath, "--args", `--remote-debugging-port=${port}`], {
@@ -25304,16 +25357,32 @@ async function handleGetBlueprint(blueprintId, jwt2) {
 }
 function createMcpServer(deps) {
   const server = new Server(
-    { name: "faux-studio", version: "0.3.0" },
+    { name: "faux-studio", version: "0.3.2" },
     { capabilities: { tools: { listChanged: true } } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {
-    const loginTool = {
-      name: "login",
-      description: "Check authentication status and re-authenticate if needed. Use when you get auth errors from other tools.",
-      inputSchema: { type: "object", properties: {}, required: [] }
-    };
-    return { tools: [loginTool, ...deps.tools] };
+    const localTools = [
+      {
+        name: "login",
+        description: "Check authentication status and re-authenticate if needed. Use when you get auth errors from other tools.",
+        inputSchema: { type: "object", properties: {}, required: [] }
+      },
+      {
+        name: "setup_figma",
+        description: "Ensure Figma Desktop is running and connected. Call this before any design work. Checks plugin and CDP transports, launches Figma if needed, or restarts it with the debug port. Idempotent \u2014 safe to call multiple times. Returns connection status and active file info.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            force_restart: {
+              type: "boolean",
+              description: "Restart Figma even if it is already running (e.g., to enable the debug port). Figma auto-recovers open files on restart. Only set this if instructed or if the previous call returned needs_restart."
+            }
+          },
+          required: []
+        }
+      }
+    ];
+    return { tools: [...localTools, ...deps.tools] };
   });
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
@@ -25365,6 +25434,16 @@ function createMcpServer(deps) {
           }
         }
       }
+      if (name === "setup_figma") {
+        log("setup_figma called");
+        const result2 = await deps.setupFigma({
+          force_restart: params.force_restart === true
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result2, null, 2) }],
+          isError: result2.status === "not_installed"
+        };
+      }
       if (name === "get_blueprint") {
         const blueprintId = params.blueprintId;
         if (!blueprintId) throw new Error("Missing required parameter: blueprintId");
@@ -25500,6 +25579,128 @@ async function generateWithAuth(toolName, params) {
     throw err;
   }
 }
+async function setupFigma(params) {
+  if (forceTransport !== "cdp" && pluginServer.hasConnections) {
+    return {
+      status: "ready",
+      transport: "plugin",
+      message: `Connected via plugin.${pluginServer.activeFileId ? ` Active file: ${pluginServer.activeFileId}` : ""} Ready to design.`,
+      activeFile: pluginServer.activeFileId || void 0,
+      pluginFiles: pluginServer.connectedFiles,
+      port: pluginServer.port
+    };
+  }
+  if (forceTransport !== "plugin" && cdpClient?.connected && cdpClient.hasContext) {
+    return {
+      status: "ready",
+      transport: "cdp",
+      message: "Connected via CDP. Ready to design."
+    };
+  }
+  if (forceTransport !== "plugin") {
+    const existing = await probeCdpPorts();
+    if (existing) {
+      const target = findFigmaDesignTarget(existing.targets);
+      if (target) {
+        try {
+          cdpClient?.close();
+          cdpClient = null;
+          const client = new CdpClient();
+          await client.connect(target.webSocketDebuggerUrl);
+          await client.discoverFigmaContext();
+          cdpClient = client;
+          log(`CDP connected: ${target.title}`);
+          return {
+            status: "ready",
+            transport: "cdp",
+            message: `Connected via CDP. Active file: ${target.title}. Ready to design.`,
+            activeFile: target.title,
+            port: existing.port
+          };
+        } catch {
+        }
+      }
+      return {
+        status: "no_design_file",
+        transport: "none",
+        message: "Figma is running with the debug port, but no design file is open. Ask the user to open a .fig file in Figma, then call setup_figma again.",
+        port: existing.port
+      };
+    }
+  }
+  if (isFigmaRunning()) {
+    if (params.force_restart) {
+      log("Restarting Figma with debug port...");
+      killFigma();
+      await new Promise((r) => setTimeout(r, 3e3));
+      try {
+        const conn = await launchFigmaWithCdp();
+        const target = findFigmaDesignTarget(conn.targets);
+        if (target) {
+          try {
+            const client = new CdpClient();
+            await client.connect(target.webSocketDebuggerUrl);
+            await client.discoverFigmaContext();
+            cdpClient = client;
+          } catch {
+          }
+        }
+        return {
+          status: "restarted",
+          transport: target ? "cdp" : "none",
+          message: target ? `Figma restarted with debug port. Connected to: ${target.title}. Ready to design.` : "Figma restarted with debug port. Waiting for a design file to be opened. Call setup_figma again once a file is open.",
+          activeFile: target?.title,
+          port: conn.port
+        };
+      } catch (err) {
+        return {
+          status: "not_installed",
+          transport: "none",
+          message: err instanceof Error ? err.message : "Failed to restart Figma."
+        };
+      }
+    }
+    return {
+      status: "needs_restart",
+      transport: "none",
+      message: "Figma is running but the debug port is not enabled. Figma needs to restart with the debug port for AI tools to work. Figma auto-recovers all open files on restart, so no work will be lost. Ask the user for permission, then call setup_figma again with force_restart: true."
+    };
+  }
+  if (!findFigmaPath()) {
+    return {
+      status: "not_installed",
+      transport: "none",
+      message: "Figma Desktop is not installed. Download from https://figma.com/downloads and install it, then call setup_figma again."
+    };
+  }
+  try {
+    log("Launching Figma Desktop...");
+    const conn = await launchFigmaWithCdp();
+    const target = findFigmaDesignTarget(conn.targets);
+    if (target) {
+      try {
+        const client = new CdpClient();
+        await client.connect(target.webSocketDebuggerUrl);
+        await client.discoverFigmaContext();
+        cdpClient = client;
+      } catch {
+      }
+    }
+    return {
+      status: "launched",
+      transport: target ? "cdp" : "none",
+      message: target ? `Figma launched and connected. Active file: ${target.title}. Ready to design.` : "Figma launched. Open a design file to start designing, then call setup_figma again.",
+      activeFile: target?.title,
+      port: conn.port
+    };
+  } catch (err) {
+    return {
+      status: "not_installed",
+      transport: "none",
+      message: err instanceof Error ? err.message : "Failed to launch Figma."
+    };
+  }
+}
 async function main() {
   try {
     auth = await ensureAuth();
@@ -25557,7 +25758,8 @@ async function main() {
       email: auth.user.email,
       source: auth.source,
       isApiKey: auth.source === "api-key"
-    })
+    }),
+    setupFigma
   });
   await startServer(server);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faux-studio",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "AI-powered Figma design via MCP — connect any AI client to Figma Desktop",
   "type": "module",
   "bin": {