figma-relai 0.7.3 → 0.7.5

package/dist/{chunk-BEGACSIP.js → chunk-BRUWHN2A.js}

@@ -10,13 +10,16 @@ import {
   __export
 } from "./chunk-2H7UOFLK.js";
 
+// src/version.ts
+var VERSION = "0.7.5";
+
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 function createServer() {
   return new McpServer(
     {
       name: "Relai",
-      version: "0.7.3"
+      version: VERSION
     },
     {
       instructions: `
@@ -866,10 +869,12 @@ var FileIdentityError = class extends Error {
 };
 async function resolveFileIdentity(sendCommand) {
   const probe = await sendCommand("get_file_identity", {});
-  if (probe?.identity?.fileKey) return probe.identity;
+  const cached = probe?.identity?.fileKey ? probe.identity : null;
+  if (cached && cached.by === VERSION) return cached;
   const rootName = probe?.rootName ?? "";
   const candidates = probe?.candidates ?? [];
   if (candidates.length === 0) {
+    if (cached) return cached;
     throw new FileIdentityError(
       "This file publishes no components, so its key cannot be resolved from the plugin (figma.fileKey is private-plugin-only)."
     );
@@ -904,7 +909,8 @@ async function resolveFileIdentity(sendCommand) {
   const file = await figmaApi(token, `/files/${main.fileKey}?branch_data=true&depth=1`);
   const identity = {
     fileKey: main.fileKey,
-    fileName: typeof file.json.name === "string" ? file.json.name : rootName
+    fileName: typeof file.json.name === "string" ? file.json.name : rootName,
+    by: VERSION
   };
   if (rootName && rootName !== identity.fileName) {
     const branches = file.json.branches ?? [];
@@ -1885,7 +1891,7 @@ import { z as z12 } from "zod";
 function register11(server, sendCommand) {
   server.tool(
     "import_from_library",
-    "Import a component, style, or variable from an enabled team library by its key. Component keys come from the design system or get_local_components; imported components can then be instantiated with manage_components.",
+    "Import a component, style, or variable from an enabled team library by its key. Keys come from get_design_system's libraryCatalog, which resolves each library this file draws from and lists everything it publishes \u2014 not just what the file already uses. If the library you want is not in that catalog, it is listed under librariesNotCatalogued with what to do about it. Imported components can then be instantiated with manage_components.",
     {
       kind: z12.enum(["component", "style", "variable"]),
       key: z12.string().describe("Library key")
@@ -2195,13 +2201,15 @@ function register15(server, sendCommand) {
 var design_system_exports = {};
 __export(design_system_exports, {
   discoverLibraryFiles: () => discoverLibraryFiles,
+  librariesNotCatalogued: () => librariesNotCatalogued,
+  probeFailureNote: () => probeFailureNote,
   register: () => register16
 });
 import { z as z17 } from "zod";
 function register16(server, sendCommand) {
   server.tool(
     "get_design_system",
-    "Inventory the design system available to this file \u2014 call this BEFORE building UI, then prefer instantiating existing components (manage_components action:instantiate takes local and library keys) and binding existing variables over drawing raw shapes. Reports: local components/styles/variable collections with usage counts, remote components/styles the file already uses, enabled libraries' variable collections, and \u2014 with a token stored (`npx figma-relai login`) \u2014 the FULL published catalog of every library this file consumes, resolved automatically. What the file already uses is never the whole library: a component the file has not placed yet is invisible until this catalog is read. Results are cached per session \u2014 pass refresh:true after big library changes.",
+    "Inventory the design system available to this file \u2014 call this BEFORE building UI, then prefer instantiating existing components (manage_components action:instantiate takes local and library keys) and binding existing variables over drawing raw shapes. Reports: local components/styles/variable collections with usage counts, remote components/styles the file already uses, enabled libraries' variable collections, and \u2014 with a token stored (`npx figma-relai login`) \u2014 the FULL published catalog of every library this file consumes, resolved automatically. What the file already uses is never the whole library: a component the file has not placed yet is invisible until this catalog is read. A library the file has drawn from NOTHING at all cannot be resolved either \u2014 those are named under librariesNotCatalogued, with the one step that fixes it. Results are cached per session \u2014 pass refresh:true after big library changes.",
     {
       refresh: z17.boolean().optional().describe("Rescan instead of using the session cache"),
       libraryFileUrl: z17.string().optional().describe(
@@ -2217,6 +2225,10 @@ function register16(server, sendCommand) {
           12e4
         );
         data.libraryCatalog = await fetchLibraryCatalogs(libraryFileUrl, data);
+        if (!libraryFileUrl) {
+          const missed = librariesNotCatalogued(data);
+          if (missed.length) data.librariesNotCatalogued = missedNote(missed);
+        }
         const truncNotes = [];
         const components = data.components;
         for (const [group, entry] of Object.entries(components ?? {})) {
@@ -2308,9 +2320,10 @@ function apiFor(token) {
     return { ok: res.ok, status: res.status, json };
   };
 }
-function authFailure(statuses) {
-  if (statuses.length === 0 || !statuses.every((s) => s === 401 || s === 403)) return null;
-  return "Figma rejected the token on every probe (401/403) \u2014 it is expired or lacks the file content read scope. Re-run `npx -y figma-relai@latest login`, then retry.";
+function probeFailureNote(statuses) {
+  const denied = statuses.filter((s) => s === 401 || s === 403).length;
+  if (denied === 0) return null;
+  return denied === statuses.length ? "Figma rejected the token on every probe (401/403) \u2014 it is expired or lacks the file content read scope. Re-run `npx -y figma-relai@latest login`, then retry." : `Figma refused ${denied} of ${statuses.length} probes with 401/403 \u2014 the token works, but it cannot read the libraries this file draws from (they belong to a team or organisation it has no access to). Ask for access to that library file, or pass libraryFileUrl for one you can read.`;
 }
 var metaOf = (r) => r.json.meta ?? {};
 async function discoverLibraryFiles(api, scan) {
@@ -2334,7 +2347,7 @@ async function discoverLibraryFiles(api, scan) {
     }
   }
   if (found.size === 0) {
-    const denied = authFailure(statuses);
+    const denied = probeFailureNote(statuses);
     if (denied) throw new Error(denied);
   }
   return [...found].map(([fileKey, via]) => ({ fileKey, via }));
@@ -2376,6 +2389,29 @@ async function catalogOne(api, fileKey) {
     }))
   };
 }
+function librariesNotCatalogued(data) {
+  const catalog = data.libraryCatalog;
+  if (!catalog?.libraries) return [];
+  const norm = (s) => s.trim().toLowerCase();
+  const seen = new Set(catalog.libraries.map((l) => norm(l.name ?? "")));
+  const enabled = data.variables?.libraryCollections;
+  const names = /* @__PURE__ */ new Set();
+  for (const c of enabled ?? []) {
+    const name = c.libraryName?.trim();
+    if (name && !seen.has(norm(name))) names.add(name);
+  }
+  return [...names];
+}
+function missedNote(names) {
+  return {
+    libraries: names,
+    why: "Enabled, but absent from the catalog above \u2014 usually because this file has not placed a single component or style from them, so there is no key to resolve their file from.",
+    // The remedy is the designer's, not the agent's: one instance is enough,
+    // and only while the scan runs — the keys it yields stay valid after.
+    how: "Ask the designer to drag any one component from that library onto the canvas (any page), then call this tool again with refresh:true. The instance can be deleted once the catalog is read \u2014 the keys remain valid. Or pass libraryFileUrl with the library file's figma.com URL.",
+    ignoreIf: "A library that publishes only variables always lands here; its contents are already in variables.libraryCollections."
+  };
+}
 async function fetchLibraryCatalogs(libraryFileUrl, scan) {
   const token = loadToken();
   if (!token) {
@@ -2396,8 +2432,9 @@ async function fetchLibraryCatalogs(libraryFileUrl, scan) {
       return { note: err.message };
     }
     if (!targets.length) {
+      const remote = (scan.components?.remoteUsed?.items?.length ?? 0) + (scan.styles?.remoteUsed?.items?.length ?? 0);
       return {
-        note: "No library file could be resolved from the keys this file holds \u2014 every candidate 404'd (unpublished, or from a library this token cannot read). Pass libraryFileUrl explicitly."
+        note: remote ? "No library file could be resolved from the keys this file holds \u2014 every candidate 404'd (unpublished, or from a library this token cannot read). Pass libraryFileUrl explicitly." : "This file uses no remote components or styles, so there is no key to resolve a library from. Either it draws from none, or it publishes its own \u2014 check components.local. Pass libraryFileUrl to catalog a specific library anyway."
       };
     }
   }
@@ -4433,6 +4470,7 @@ function registerPrompts(server) {
 }
 
 export {
+  VERSION,
   createServer,
   FIGMA_COMMANDS,
   RelayCore,
@@ -4444,4 +4482,4 @@ export {
   listToolCatalog,
   registerPrompts
 };
-//# sourceMappingURL=chunk-BEGACSIP.js.map
+//# sourceMappingURL=chunk-BRUWHN2A.js.map