@tempad-dev/mcp 0.3.11 → 0.3.12

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as SOCK_PATH, c as log, i as RUNTIME_DIR, n as LOCK_PATH, o as ensureDir, r as PACKAGE_VERSION } from "./shared-H4sL6Ltt.mjs";
+import { a as SOCK_PATH, c as log, i as RUNTIME_DIR, n as LOCK_PATH, o as ensureDir, r as PACKAGE_VERSION } from "./shared-cWtEAcwU.mjs";
 import { spawn } from "node:child_process";
 import { connect } from "node:net";
 import { join } from "node:path";

package/dist/hub.mjs

@@ -1,4 +1,4 @@
-import { a as SOCK_PATH, c as log, i as RUNTIME_DIR, o as ensureDir, r as PACKAGE_VERSION, s as ensureFile, t as ASSET_DIR } from "./shared-H4sL6Ltt.mjs";
+import { a as SOCK_PATH, c as log, i as RUNTIME_DIR, o as ensureDir, r as PACKAGE_VERSION, s as ensureFile, t as ASSET_DIR } from "./shared-cWtEAcwU.mjs";
 import { createServer } from "node:net";
 import { join } from "node:path";
 import { URL as URL$1 } from "node:url";
@@ -3893,6 +3893,15 @@ const MCP_ASSET_URI_PREFIX = "asset://tempad/";
 const MCP_ASSET_URI_TEMPLATE = `${MCP_ASSET_URI_PREFIX}{hash}`;
 const MCP_HASH_HEX_LENGTH = 8;
 const MCP_HASH_PATTERN = new RegExp(`^[a-f0-9]{${MCP_HASH_HEX_LENGTH}}$`, "i");
+const TEMPAD_MCP_ERROR_CODES = {
+	NO_ACTIVE_EXTENSION: "NO_ACTIVE_EXTENSION",
+	EXTENSION_TIMEOUT: "EXTENSION_TIMEOUT",
+	EXTENSION_DISCONNECTED: "EXTENSION_DISCONNECTED",
+	INVALID_SELECTION: "INVALID_SELECTION",
+	NODE_NOT_VISIBLE: "NODE_NOT_VISIBLE",
+	ASSET_SERVER_NOT_CONFIGURED: "ASSET_SERVER_NOT_CONFIGURED",
+	TRANSPORT_NOT_CONNECTED: "TRANSPORT_NOT_CONNECTED"
+};
 const RegisteredMessageSchema = object({
 	type: literal("registered"),
 	id: string()
@@ -4162,7 +4171,6 @@ function createAssetHttpServer(store) {
 				if (existingPath !== filePath) try {
 					renameSync(existingPath, filePath);
 					existing.filePath = filePath;
-					existingPath = filePath;
 				} catch (error) {
 					log.warn({
 						error,
@@ -4433,18 +4441,23 @@ function createAssetStore(options = {}) {
 
 //#endregion
 //#region src/instructions.md?raw
-var instructions_default = "You are connected to a Figma design file via the MCP server. Convert design elements into production code, preserving design intent while fitting the user’s codebase conventions.\n\n- Start from `get_code` as the baseline (omit `nodeId` to use the current single selection), then refactor to match project conventions (components, styling system, file structure, naming). Treat `get_code` as authoritative.\n- If `get_code` returns a `depth-cap` warning, call `get_code` again once per listed `nodeId` to fetch each omitted subtree.\n- Layout confidence:\n  - If `data-hint-auto-layout=\"inferred\"` appears, layout may be less certain. You can call `get_structure` or `get_screenshot` with a specific `nodeId` (both accept `nodeId`, otherwise they use the current single selection) to improve layout understanding, but keep `get_code` as the baseline.\n  - Otherwise, assume layout is explicit and implement directly from `get_code`.\n- If `data-hint-design-component` plus repetition supports it, extract reusable components/variants aligned with project patterns. Do not preserve hint strings in output.\n- Tokens: `get_code.tokens` is a single map keyed by canonical token name. Multi‑mode values use `${collectionName}:${modeName}` keys. Nodes with explicit overrides include `data-hint-variable-mode=\"Collection=Mode;Collection=Mode\"`; use this to pick the correct mode for a given node. Collection names are assumed unique.\n- Assets: follow the project’s existing conventions/practices (icon system, asset pipeline, import/path rules, optimization) to decide how to represent and reference assets. If `get_code` uses resource URIs, you may replace them with the project’s canonical references when appropriate without changing rendering.\n- Do not output any `data-*` attributes returned by `get_code` (they are hints only).\n- For SVG/vector assets: use the exact provided asset, preserving `path` data, `viewBox`, and full SVG structure. Never redraw or approximate vectors.\n";
+var instructions_default = "You are connected to a Figma design file via TemPad Dev MCP.\n\nTreat tool outputs as design facts. Refactor only to match the user’s repo conventions; do not invent key style values.\n\nRules:\n\n- Never output any `data-hint-*` attributes from tool outputs (hints only).\n- If `get_code` warns `depth-cap`, call `get_code` again for each listed `nodeId` before implementing.\n- Use `get_structure` / `get_screenshot` only to resolve layout/overlap/masks/effects uncertainty. Screenshots are for visual verification only; do not derive numeric values from pixels.\n- Tokens: `get_code.tokens` keys are canonical names (`--...`). Multi‑mode values use `${collectionName}:${modeName}`. Nodes may hint per-node overrides via `data-hint-variable-mode=\"Collection=Mode;...\"`.\n- Assets: fetch bytes via `resources/read` using `resourceUri` when possible; fall back to `asset.url` for large blobs. Preserve SVG/vector assets exactly; never redraw vectors.\n";
 
 //#endregion
 //#region src/request.ts
 const pendingCalls = /* @__PURE__ */ new Map();
+function createToolError(code, message) {
+	const err = new Error(message);
+	err.code = code;
+	return err;
+}
 function register(extensionId, timeout) {
 	const requestId = nanoid();
 	return {
 		promise: new Promise((resolve$1, reject$1) => {
 			const timer = setTimeout(() => {
 				pendingCalls.delete(requestId);
-				reject$1(/* @__PURE__ */ new Error(`Extension did not respond within ${timeout / 1e3}s.`));
+				reject$1(createToolError(TEMPAD_MCP_ERROR_CODES.EXTENSION_TIMEOUT, `Extension did not respond within ${timeout / 1e3}s.`));
 			}, timeout);
 			pendingCalls.set(requestId, {
 				resolve: resolve$1,
@@ -4479,7 +4492,7 @@ function cleanupForExtension(extensionId) {
 		const { timer, reject: fail, extensionId: extId } = call;
 		if (extId === extensionId) {
 			clearTimeout(timer);
-			fail(/* @__PURE__ */ new Error("Extension disconnected before providing a result."));
+			fail(createToolError(TEMPAD_MCP_ERROR_CODES.EXTENSION_DISCONNECTED, "Extension disconnected before providing a result."));
 			pendingCalls.delete(reqId);
 			log.warn({
 				reqId,
@@ -4509,44 +4522,71 @@ function hubTool(definition) {
 const TOOL_DEFS = [
 	extTool({
 		name: "get_code",
-		description: "Get a high-fidelity code snapshot for a nodeId/current selection (omit nodeId to use the current single selection), including assets/tokens and codegen plugin/config. Start here, then refactor into your component/styling/file/naming conventions; strip any data-* hints. Treat get_code as authoritative. If warnings include depth-cap, call get_code again once per listed nodeId to fetch each omitted subtree. If any data-hint-auto-layout=\"inferred\" appears, you may call get_structure or get_screenshot with a nodeId (both accept nodeId; omit it to use the current single selection) to confirm hierarchy/overlap, but keep get_code as the baseline. Use data-hint-design-component plus repetition to decide on reusable components. Replace resource URIs with your canonical asset system as needed. Tokens: get_code.tokens is a single map keyed by canonical token name; multi-mode values use `${collectionName}:${modeName}` keys. Nodes with explicit mode overrides include data-hint-variable-mode=\"Collection=Mode;Collection=Mode\". Collection names are assumed unique.",
+		description: "High-fidelity code snapshot for nodeId/current single selection (omit nodeId to use selection): JSX/Vue markup + Tailwind-like classes, plus assets/tokens metadata and codegen config. Start here, then refactor into repo conventions while preserving values/intent; strip any data-hint-* attributes (hints only). If warnings include depth-cap, call get_code again for each listed nodeId. If warnings include auto-layout (inferred), use get_structure/get_screenshot to confirm hierarchy/overlap (do not derive numeric values from pixels). Tokens are keyed by canonical names like `--color-primary` (multi-mode keys use `${collection}:${mode}`; node overrides may appear as data-hint-variable-mode).",
 		parameters: GetCodeParametersSchema,
 		target: "extension",
 		format: createCodeToolResponse
 	}),
 	extTool({
 		name: "get_token_defs",
-		description: "Resolve canonical token names to values (including modes) for tokens referenced by get_code. Use this to map into your design token/theming system, including responsive tokens.",
+		description: "Resolve canonical token names to literal values (optionally including all modes) for tokens referenced by get_code.",
 		parameters: GetTokenDefsParametersSchema,
 		target: "extension",
 		exposed: false
 	}),
 	extTool({
 		name: "get_screenshot",
-		description: "Capture a rendered screenshot for a nodeId/current selection for visual verification. Useful for confirming layering/overlap/masks/shadows/translucency when auto-layout hints are none/inferred.",
+		description: "Capture a rendered PNG screenshot for nodeId/current single selection for visual verification (layering/overlap/masks/effects).",
 		parameters: GetScreenshotParametersSchema,
 		target: "extension",
 		format: createScreenshotToolResponse
 	}),
 	extTool({
 		name: "get_structure",
-		description: "Get a structural + geometry outline for a nodeId/current selection to understand hierarchy and layout intent. Use when auto-layout hints are none/inferred or you need explicit bounds for refactors/component extraction.",
+		description: "Get a structural + geometry outline for nodeId/current single selection to understand hierarchy and layout intent.",
 		parameters: GetStructureParametersSchema,
 		target: "extension"
 	}),
 	hubTool({
 		name: "get_assets",
-		description: "Resolve asset hashes to downloadable URLs/URIs for assets referenced by get_code, preserving vectors exactly. Pull bytes before routing through your asset/icon pipeline.",
+		description: "Resolve asset hashes to downloadable URLs/URIs for assets referenced by tool responses (preserve vectors exactly).",
 		parameters: GetAssetsParametersSchema,
 		target: "hub",
 		outputSchema: GetAssetsResultSchema,
 		exposed: false
 	})
 ];
+function extractToolErrorCode(error) {
+	if (!error || typeof error !== "object") return void 0;
+	if ("code" in error && typeof error.code === "string") return error.code;
+	if ("cause" in error) {
+		const cause = error.cause;
+		if (cause && typeof cause === "object") {
+			const causeCode = cause.code;
+			if (typeof causeCode === "string") return causeCode;
+		}
+	}
+}
+function extractToolErrorMessage(error) {
+	if (error instanceof Error) return error.message || "Unknown error occurred.";
+	if (typeof error === "string") return error;
+	if (error && typeof error === "object") {
+		const candidate = error;
+		if (typeof candidate.message === "string" && candidate.message.trim()) return candidate.message;
+	}
+	return "Unknown error occurred.";
+}
 function createToolErrorResponse(toolName, error) {
+	const message = extractToolErrorMessage(error);
+	const code = extractToolErrorCode(error);
 	return { content: [{
 		type: "text",
-		text: `Tool "${toolName}" failed: ${error instanceof Error ? error.message || "Unknown error occurred." : typeof error === "string" ? error : "Unknown error occurred."}`
+		text: `Tool "${toolName}" failed: ${message}${(() => {
+			const help = [];
+			if (code === TEMPAD_MCP_ERROR_CODES.NO_ACTIVE_EXTENSION || code === TEMPAD_MCP_ERROR_CODES.EXTENSION_TIMEOUT || code === TEMPAD_MCP_ERROR_CODES.EXTENSION_DISCONNECTED || code === TEMPAD_MCP_ERROR_CODES.ASSET_SERVER_NOT_CONFIGURED || code === TEMPAD_MCP_ERROR_CODES.TRANSPORT_NOT_CONNECTED || /no active tempad dev extension/i.test(message) || /asset server url is not configured/i.test(message) || /mcp transport is not connected/i.test(message) || /websocket/i.test(message)) help.push("Troubleshooting:", "- In Figma, open TemPad Dev panel and enable MCP (Preferences → MCP server).", "- If multiple Figma tabs are open, click the MCP badge to activate this tab.", "- Keep the Figma tab active/foreground while running MCP tools.");
+			if (code === TEMPAD_MCP_ERROR_CODES.INVALID_SELECTION || code === TEMPAD_MCP_ERROR_CODES.NODE_NOT_VISIBLE || /select exactly one visible node/i.test(message) || /no visible node found/i.test(message)) help.push("Tip: Select exactly one visible node, or pass nodeId.");
+			return help.length ? `\n\n${help.join("\n")}` : "";
+		})()}`
 	}] };
 }
 function formatBytes$1(bytes) {
@@ -4662,6 +4702,30 @@ function enrichToolDefinition(tool) {
 	}
 }
 const TOOL_DEFINITIONS = TOOL_DEFS.map((tool) => enrichToolDefinition(tool));
+function createCodedError(code, message) {
+	const err = new Error(message);
+	err.code = code;
+	return err;
+}
+function coerceToolError(error) {
+	if (error instanceof Error) return error;
+	if (typeof error === "string") return new Error(error);
+	if (error && typeof error === "object") {
+		const candidate = error;
+		const message = typeof candidate.message === "string" ? candidate.message : safeStringify(error);
+		const err = new Error(message);
+		if (typeof candidate.code === "string") err.code = candidate.code;
+		return err;
+	}
+	return new Error(String(error));
+}
+function safeStringify(input) {
+	try {
+		return JSON.stringify(input);
+	} catch {
+		return String(input);
+	}
+}
 function hasFormatter(tool) {
 	return tool.target === "extension" && "format" in tool;
 }
@@ -4793,7 +4857,7 @@ function registerProxiedTool(tool) {
 		try {
 			const parsedArgs = schema.parse(args);
 			const activeExt = extensions.find((e) => e.active);
-			if (!activeExt) throw new Error("No active TemPad Dev extension available.");
+			if (!activeExt) throw createCodedError(TEMPAD_MCP_ERROR_CODES.NO_ACTIVE_EXTENSION, "No active TemPad Dev extension available.");
 			const { promise, requestId } = register(activeExt.id, toolTimeoutMs);
 			const message = {
 				type: "toolCall",
@@ -5098,7 +5162,7 @@ wss.on("connection", (ws) => {
 				break;
 			case "toolResult": {
 				const { id, payload, error } = msg;
-				if (error) reject(id, error instanceof Error ? error : new Error(String(error)));
+				if (error) reject(id, coerceToolError(error));
 				else resolve(id, payload);
 				break;
 			}