@tempad-dev/mcp 0.5.0 → 0.6.0

package/README.md

@@ -28,7 +28,7 @@ Supported tools/resources:
 
 Notes:
 
-- When a selection is too large for the `get_code` budget, TemPad Dev may return a shell response instead of failing. The shell keeps the current node wrapper and lists omitted direct child ids in an inline code comment so agents can request them one by one.
+- Tool responses use a shared `64 KiB` inline budget measured on the `CallToolResult` body. When a selection is too large for the `get_code` budget, TemPad Dev may return a shell response instead of failing. The shell keeps the current node wrapper and lists omitted direct child ids in an inline code comment so agents can request them one by one. The accompanying warning stays lightweight and only points agents to that comment.
 - Assets are ephemeral and tool-linked; image/SVG bytes are downloaded via HTTP `asset.url` from tool results.
 - Asset resources are not exposed via MCP `resources/list`/`resources/read`.
 - The HTTP fallback URL uses `/assets/{hash}` and may include an image extension (for example `/assets/{hash}.png`). Both forms are accepted.
@@ -47,4 +47,4 @@ Optional environment variables:
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 18.20.0+

package/README.zh-Hans.md

@@ -26,6 +26,7 @@
 
 说明：
 
+- 工具响应共用 `64 KiB` 的 inline budget，按 `CallToolResult` 整体响应体积计算。若选区过大而超出 `get_code` 的预算，TemPad Dev 可能返回 shell response 而不是直接失败。shell 会保留当前节点的包裹结构，并在内联代码注释中列出被省略的直接子节点 id，方便 agent 逐个继续拉取；配套 warning 只保留最小化的提示信息，用来指向这条注释。
 - 资源是临时且与工具调用关联的；图片/SVG 请直接使用工具结果中的 HTTP `asset.url` 下载。
 - MCP 不再暴露 `resources/list` / `resources/read` 用于 asset 内容读取。
 - HTTP 回退 URL 使用 `/assets/{hash}`，也可能带图片扩展名（例如 `/assets/{hash}.png`），两种形式都支持。
@@ -44,4 +45,4 @@
 
 ## 要求
 
-- Node.js 18+
+- Node.js 18.20.0+

package/dist/cli.mjs

@@ -1,11 +1,10 @@
 #!/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-C_kjQL67.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-C9V2G_pC.mjs";
 import { spawn } from "node:child_process";
 import { connect } from "node:net";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import lockfile from "proper-lockfile";
-
 //#region src/cli.ts
 let activeSocket = null;
 let shuttingDown = false;
@@ -141,7 +140,7 @@ async function main() {
 	}
 }
 main();
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport type { ChildProcess } from 'node:child_process'\nimport type { Socket } from 'node:net'\n\nimport { spawn } from 'node:child_process'\nimport { connect } from 'node:net'\nimport { join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport lockfile from 'proper-lockfile'\n\nimport { PACKAGE_VERSION, log, LOCK_PATH, RUNTIME_DIR, SOCK_PATH, ensureDir } from './shared'\n\nlet activeSocket: Socket | null = null\nlet shuttingDown = false\n\nfunction closeActiveSocket() {\n  if (!activeSocket) return\n  try {\n    activeSocket.end()\n  } catch {\n    // ignore\n  }\n  try {\n    activeSocket.destroy()\n  } catch {\n    // ignore\n  }\n  activeSocket = null\n}\n\nfunction shutdownCli(reason: string) {\n  if (shuttingDown) return\n  shuttingDown = true\n  log.info(`${reason} Shutting down CLI.`)\n  closeActiveSocket()\n  process.exit(0)\n}\n\nprocess.on('SIGINT', () => shutdownCli('SIGINT received.'))\nprocess.on('SIGTERM', () => shutdownCli('SIGTERM received.'))\n\nconst HUB_STARTUP_TIMEOUT = 5000\nconst CONNECT_RETRY_DELAY = 200\nconst FAILED_RESTART_DELAY = 5000\nconst HERE = fileURLToPath(new URL('.', import.meta.url))\nconst HUB_ENTRY = join(HERE, 'hub.mjs')\n\nensureDir(RUNTIME_DIR)\n\nfunction bridge(socket: Socket): Promise<void> {\n  return new Promise((resolve) => {\n    log.info('Bridge established with Hub. Forwarding I/O.')\n    activeSocket = socket\n\n    const onStdinEnd = () => {\n      shutdownCli('Consumer stream ended.')\n    }\n    process.stdin.once('end', onStdinEnd)\n\n    const onSocketClose = () => {\n      log.warn('Connection to Hub lost. Attempting to reconnect...')\n      activeSocket = null\n      process.stdin.removeListener('end', onStdinEnd)\n      process.stdin.unpipe(socket)\n      socket.unpipe(process.stdout)\n      socket.removeAllListeners()\n      resolve()\n    }\n    socket.once('close', onSocketClose)\n    socket.on('error', (err) => log.warn({ err }, 'Socket error occurred.'))\n\n    // The `{ end: false }` option prevents stdin from closing the socket.\n    process.stdin.pipe(socket, { end: false }).pipe(process.stdout)\n  })\n}\n\nfunction connectHub(): Promise<Socket> {\n  return new Promise((resolve, reject) => {\n    const socket = connect(SOCK_PATH)\n    socket.on('connect', () => {\n      socket.removeAllListeners('error')\n      resolve(socket)\n    })\n    socket.on('error', reject)\n  })\n}\n\nasync function connectWithRetry(timeout: number): Promise<Socket> {\n  const startTime = Date.now()\n  let delay = CONNECT_RETRY_DELAY\n  while (Date.now() - startTime < timeout) {\n    try {\n      return await connectHub()\n    } catch (err: unknown) {\n      if (\n        err &&\n        typeof err === 'object' &&\n        'code' in err &&\n        (err.code === 'ENOENT' || err.code === 'ECONNREFUSED')\n      ) {\n        const remainingTime = timeout - (Date.now() - startTime)\n        const waitTime = Math.min(delay, remainingTime)\n        if (waitTime <= 0) break\n        await new Promise((r) => setTimeout(r, waitTime))\n        delay = Math.min(delay * 1.5, 1000)\n      } else {\n        throw err\n      }\n    }\n  }\n  throw new Error(`Failed to connect to Hub within ${timeout}ms.`)\n}\n\nfunction startHub(): ChildProcess {\n  log.info('Spawning new Hub process...')\n  return spawn(process.execPath, [HUB_ENTRY], {\n    detached: true,\n    stdio: 'ignore'\n  })\n}\n\nasync function tryBecomeLeaderAndStartHub(): Promise<Socket> {\n  let releaseLock: (() => Promise<void>) | undefined\n  try {\n    releaseLock = await lockfile.lock(LOCK_PATH, {\n      retries: { retries: 5, factor: 1.2, minTimeout: 50 },\n      stale: 15000\n    })\n  } catch {\n    log.info('Another process is starting the Hub. Waiting...')\n    return connectWithRetry(HUB_STARTUP_TIMEOUT)\n  }\n\n  log.info('Acquired lock. Starting Hub as the leader...')\n  let child: ChildProcess | null = null\n  try {\n    try {\n      return await connectHub()\n    } catch {\n      // If the Hub is not running, we proceed to start it.\n      log.info('Hub not running. Proceeding to start it...')\n    }\n    child = startHub()\n    child.on('error', (err) => log.error({ err }, 'Hub child process error.'))\n    const socket = await connectWithRetry(HUB_STARTUP_TIMEOUT)\n    child.unref()\n    return socket\n  } catch (err: unknown) {\n    log.error({ err }, 'Failed to start or connect to the Hub.')\n    if (child && !child.killed) {\n      log.warn(`Killing stale Hub process (PID: ${child.pid})...`)\n      child.kill('SIGTERM')\n    }\n    throw err\n  } finally {\n    if (releaseLock) await releaseLock()\n  }\n}\n\nasync function main() {\n  log.info({ version: PACKAGE_VERSION }, 'TemPad MCP Client starting...')\n\n  while (true) {\n    try {\n      const socket = await connectHub().catch(() => {\n        log.info('Hub not running. Initiating startup sequence...')\n        return tryBecomeLeaderAndStartHub()\n      })\n      await bridge(socket)\n      log.info('Bridge disconnected. Restarting connection process...')\n    } catch (err: unknown) {\n      log.error(\n        { err },\n        `Connection attempt failed. Retrying in ${FAILED_RESTART_DELAY / 1000}s...`\n      )\n      await new Promise((r) => setTimeout(r, FAILED_RESTART_DELAY))\n    }\n  }\n}\n\nmain()\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport type { ChildProcess } from 'node:child_process'\nimport type { Socket } from 'node:net'\n\nimport { spawn } from 'node:child_process'\nimport { connect } from 'node:net'\nimport { join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport lockfile from 'proper-lockfile'\n\nimport { PACKAGE_VERSION, log, LOCK_PATH, RUNTIME_DIR, SOCK_PATH, ensureDir } from './shared'\n\nlet activeSocket: Socket | null = null\nlet shuttingDown = false\n\nfunction closeActiveSocket() {\n  if (!activeSocket) return\n  try {\n    activeSocket.end()\n  } catch {\n    // ignore\n  }\n  try {\n    activeSocket.destroy()\n  } catch {\n    // ignore\n  }\n  activeSocket = null\n}\n\nfunction shutdownCli(reason: string) {\n  if (shuttingDown) return\n  shuttingDown = true\n  log.info(`${reason} Shutting down CLI.`)\n  closeActiveSocket()\n  process.exit(0)\n}\n\nprocess.on('SIGINT', () => shutdownCli('SIGINT received.'))\nprocess.on('SIGTERM', () => shutdownCli('SIGTERM received.'))\n\nconst HUB_STARTUP_TIMEOUT = 5000\nconst CONNECT_RETRY_DELAY = 200\nconst FAILED_RESTART_DELAY = 5000\nconst HERE = fileURLToPath(new URL('.', import.meta.url))\nconst HUB_ENTRY = join(HERE, 'hub.mjs')\n\nensureDir(RUNTIME_DIR)\n\nfunction bridge(socket: Socket): Promise<void> {\n  return new Promise((resolve) => {\n    log.info('Bridge established with Hub. Forwarding I/O.')\n    activeSocket = socket\n\n    const onStdinEnd = () => {\n      shutdownCli('Consumer stream ended.')\n    }\n    process.stdin.once('end', onStdinEnd)\n\n    const onSocketClose = () => {\n      log.warn('Connection to Hub lost. Attempting to reconnect...')\n      activeSocket = null\n      process.stdin.removeListener('end', onStdinEnd)\n      process.stdin.unpipe(socket)\n      socket.unpipe(process.stdout)\n      socket.removeAllListeners()\n      resolve()\n    }\n    socket.once('close', onSocketClose)\n    socket.on('error', (err) => log.warn({ err }, 'Socket error occurred.'))\n\n    // The `{ end: false }` option prevents stdin from closing the socket.\n    process.stdin.pipe(socket, { end: false }).pipe(process.stdout)\n  })\n}\n\nfunction connectHub(): Promise<Socket> {\n  return new Promise((resolve, reject) => {\n    const socket = connect(SOCK_PATH)\n    socket.on('connect', () => {\n      socket.removeAllListeners('error')\n      resolve(socket)\n    })\n    socket.on('error', reject)\n  })\n}\n\nasync function connectWithRetry(timeout: number): Promise<Socket> {\n  const startTime = Date.now()\n  let delay = CONNECT_RETRY_DELAY\n  while (Date.now() - startTime < timeout) {\n    try {\n      return await connectHub()\n    } catch (err: unknown) {\n      if (\n        err &&\n        typeof err === 'object' &&\n        'code' in err &&\n        (err.code === 'ENOENT' || err.code === 'ECONNREFUSED')\n      ) {\n        const remainingTime = timeout - (Date.now() - startTime)\n        const waitTime = Math.min(delay, remainingTime)\n        if (waitTime <= 0) break\n        await new Promise((r) => setTimeout(r, waitTime))\n        delay = Math.min(delay * 1.5, 1000)\n      } else {\n        throw err\n      }\n    }\n  }\n  throw new Error(`Failed to connect to Hub within ${timeout}ms.`)\n}\n\nfunction startHub(): ChildProcess {\n  log.info('Spawning new Hub process...')\n  return spawn(process.execPath, [HUB_ENTRY], {\n    detached: true,\n    stdio: 'ignore'\n  })\n}\n\nasync function tryBecomeLeaderAndStartHub(): Promise<Socket> {\n  let releaseLock: (() => Promise<void>) | undefined\n  try {\n    releaseLock = await lockfile.lock(LOCK_PATH, {\n      retries: { retries: 5, factor: 1.2, minTimeout: 50 },\n      stale: 15000\n    })\n  } catch {\n    log.info('Another process is starting the Hub. Waiting...')\n    return connectWithRetry(HUB_STARTUP_TIMEOUT)\n  }\n\n  log.info('Acquired lock. Starting Hub as the leader...')\n  let child: ChildProcess | null = null\n  try {\n    try {\n      return await connectHub()\n    } catch {\n      // If the Hub is not running, we proceed to start it.\n      log.info('Hub not running. Proceeding to start it...')\n    }\n    child = startHub()\n    child.on('error', (err) => log.error({ err }, 'Hub child process error.'))\n    const socket = await connectWithRetry(HUB_STARTUP_TIMEOUT)\n    child.unref()\n    return socket\n  } catch (err: unknown) {\n    log.error({ err }, 'Failed to start or connect to the Hub.')\n    if (child && !child.killed) {\n      log.warn(`Killing stale Hub process (PID: ${child.pid})...`)\n      child.kill('SIGTERM')\n    }\n    throw err\n  } finally {\n    if (releaseLock) await releaseLock()\n  }\n}\n\nasync function main() {\n  log.info({ version: PACKAGE_VERSION }, 'TemPad MCP Client starting...')\n\n  while (true) {\n    try {\n      const socket = await connectHub().catch(() => {\n        log.info('Hub not running. Initiating startup sequence...')\n        return tryBecomeLeaderAndStartHub()\n      })\n      await bridge(socket)\n      log.info('Bridge disconnected. Restarting connection process...')\n    } catch (err: unknown) {\n      log.error(\n        { err },\n        `Connection attempt failed. Retrying in ${FAILED_RESTART_DELAY / 1000}s...`\n      )\n      await new Promise((r) => setTimeout(r, FAILED_RESTART_DELAY))\n    }\n  }\n}\n\nmain()\n"],"mappings":"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"}

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-C_kjQL67.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-C9V2G_pC.mjs";
 import { createServer } from "node:net";
 import { join } from "node:path";
 import { URL } from "node:url";
@@ -11,7 +11,6 @@ import { WebSocketServer } from "ws";
 import { createHash } from "node:crypto";
 import { createServer as createServer$1 } from "node:http";
 import { Transform, pipeline } from "node:stream";
-
 //#region ../shared/dist/index.js
 const MCP_PORT_CANDIDATES = [
 	6220,
@@ -19,12 +18,12 @@ const MCP_PORT_CANDIDATES = [
 	8127
 ];
 const MCP_MAX_PAYLOAD_BYTES = 4 * 1024 * 1024;
+const MCP_TOOL_INLINE_BUDGET_BYTES = 64 * 1024;
 const MCP_TOOL_TIMEOUT_MS = 15e3;
 const MCP_AUTO_ACTIVATE_GRACE_MS = 1500;
 const MCP_MAX_ASSET_BYTES = 8 * 1024 * 1024;
 const MCP_ASSET_TTL_MS = 720 * 60 * 60 * 1e3;
-const MCP_HASH_HEX_LENGTH = 8;
-const MCP_HASH_PATTERN = new RegExp(`^[a-f0-9]{${MCP_HASH_HEX_LENGTH}}$`, "i");
+const MCP_HASH_PATTERN = new RegExp(`^[a-f0-9]{8}$`, "i");
 const TEMPAD_MCP_ERROR_CODES = {
 	NO_ACTIVE_EXTENSION: "NO_ACTIVE_EXTENSION",
 	EXTENSION_TIMEOUT: "EXTENSION_TIMEOUT",
@@ -34,6 +33,107 @@ const TEMPAD_MCP_ERROR_CODES = {
 	ASSET_SERVER_NOT_CONFIGURED: "ASSET_SERVER_NOT_CONFIGURED",
 	TRANSPORT_NOT_CONNECTED: "TRANSPORT_NOT_CONNECTED"
 };
+const SERVER_NAME = "tempad-dev";
+const SERVER_COMMAND = "npx";
+const SERVER_ARGS = ["-y", "@tempad-dev/mcp@latest"];
+const stdioConfig = {
+	type: "stdio",
+	command: SERVER_COMMAND,
+	args: [...SERVER_ARGS]
+};
+const commandConfig = {
+	command: SERVER_COMMAND,
+	args: [...SERVER_ARGS]
+};
+function toBase64(input) {
+	if (typeof globalThis.btoa === "function") return globalThis.btoa(input);
+	const bufferLike = globalThis.Buffer;
+	if (bufferLike) return bufferLike.from(input, "utf8").toString("base64");
+	throw new Error("Base64 encoding not supported in this environment.");
+}
+function buildVscodeDeepLink() {
+	return `vscode:mcp/install?${encodeURIComponent(JSON.stringify({
+		name: SERVER_NAME,
+		...stdioConfig
+	}))}`;
+}
+function buildCursorConfigBase64() {
+	return encodeURIComponent(toBase64(JSON.stringify(commandConfig)));
+}
+function buildCursorDeepLink() {
+	return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(SERVER_NAME)}&config=${buildCursorConfigBase64()}`;
+}
+function buildTraeDeepLink(protocol) {
+	return `${protocol}://trae.ai-ide/mcp-import?type=stdio&name=${encodeURIComponent(SERVER_NAME)}&config=${buildCursorConfigBase64()}`;
+}
+function buildWindsurfConfigSnippet() {
+	return JSON.stringify({ mcpServers: { [SERVER_NAME]: commandConfig } }, null, 2);
+}
+function buildCodexConfigSnippet() {
+	return [
+		`[mcp_servers.${SERVER_NAME}]`,
+		`command = ${JSON.stringify(SERVER_COMMAND)}`,
+		`args = [${SERVER_ARGS.map((arg) => JSON.stringify(arg)).join(", ")}]`
+	].join("\n");
+}
+function buildCliCommand(prefix) {
+	const args = `${SERVER_COMMAND} ${SERVER_ARGS.join(" ")}`;
+	if (prefix === "claude") return `claude mcp add --transport stdio "${SERVER_NAME}" -- ${args}`;
+	return `codex mcp add "${SERVER_NAME}" -- ${args}`;
+}
+[...SERVER_ARGS];
+JSON.stringify({ [SERVER_NAME]: commandConfig }, null, 2);
+const MCP_CLIENTS_BY_ID = {
+	vscode: {
+		id: "vscode",
+		name: "VS Code",
+		brandColor: "#0098ff",
+		supportsDeepLink: true,
+		deepLink: buildVscodeDeepLink()
+	},
+	cursor: {
+		id: "cursor",
+		name: "Cursor",
+		brandColor: ["#000", "#fff"],
+		supportsDeepLink: true,
+		deepLink: buildCursorDeepLink()
+	},
+	windsurf: {
+		id: "windsurf",
+		name: "Windsurf",
+		brandColor: ["#0B100F", "#F0F3F2"],
+		supportsDeepLink: false,
+		copyText: buildWindsurfConfigSnippet(),
+		copyKind: "config"
+	},
+	claude: {
+		id: "claude",
+		name: "Claude Code",
+		brandColor: "#D97757",
+		supportsDeepLink: false,
+		copyText: buildCliCommand("claude"),
+		copyKind: "command"
+	},
+	codex: {
+		id: "codex",
+		name: "Codex CLI",
+		brandColor: ["#0d0d0d", "#fff"],
+		supportsDeepLink: false,
+		copyText: buildCliCommand("codex"),
+		copyKind: "command",
+		alternateCopyText: buildCodexConfigSnippet(),
+		alternateCopyKind: "config"
+	},
+	trae: {
+		id: "trae",
+		name: "TRAE",
+		brandColor: ["#0fdc78", "#32f08c"],
+		supportsDeepLink: true,
+		deepLink: buildTraeDeepLink("trae"),
+		fallbackDeepLink: buildTraeDeepLink("trae-cn")
+	}
+};
+MCP_CLIENTS_BY_ID.vscode, MCP_CLIENTS_BY_ID.cursor, MCP_CLIENTS_BY_ID.windsurf, MCP_CLIENTS_BY_ID.claude, MCP_CLIENTS_BY_ID.codex, MCP_CLIENTS_BY_ID.trae;
 const RegisteredMessageSchema = z.object({
 	type: z.literal("registered"),
 	id: z.string()
@@ -54,7 +154,7 @@ const ToolCallMessageSchema = z.object({
 	id: z.string(),
 	payload: ToolCallPayloadSchema
 });
-const MessageToExtensionSchema = z.discriminatedUnion("type", [
+z.discriminatedUnion("type", [
 	RegisteredMessageSchema,
 	StateMessageSchema,
 	ToolCallMessageSchema
@@ -67,6 +167,78 @@ const ToolResultMessageSchema = z.object({
 	error: z.unknown().optional()
 });
 const MessageFromExtensionSchema = z.discriminatedUnion("type", [ActivateMessageSchema, ToolResultMessageSchema]);
+const ENCODER = new TextEncoder();
+function utf8Bytes(value) {
+	return ENCODER.encode(serializeUtf8Value(value)).length;
+}
+function measureCallToolResultBytes(result) {
+	return utf8Bytes(result);
+}
+function buildGetCodeToolResult(payload) {
+	const summary = [];
+	const codeSize = utf8Bytes(payload.code);
+	summary.push(`Generated \`${payload.lang}\` snippet (${formatBytes(codeSize)}).`);
+	if (payload.warnings?.length) summary.push(...payload.warnings.map((warning) => warning.message));
+	summary.push(payload.assets?.length ? `Assets attached: ${payload.assets.length}. Download bytes from each asset.url.` : "No binary assets were attached to this response.");
+	const tokenCount = payload.tokens ? Object.keys(payload.tokens).length : 0;
+	if (tokenCount) summary.push(`Token references included: ${tokenCount}.`);
+	summary.push("Read structuredContent for the full code string and metadata.");
+	return buildTextToolResult(summary.join("\n"), payload);
+}
+function buildGetStructureToolResult(payload) {
+	const roots = payload.roots.length;
+	const nodeCount = countOutlineNodes(payload.roots);
+	return buildTextToolResult(`${roots === 0 ? "No structure nodes were returned." : `Returned structure outline with ${formatCount(roots, "root")} and ${formatCount(nodeCount, "node")}.`}\nRead structuredContent for the full outline payload.`, payload);
+}
+function buildGetTokenDefsToolResult(payload) {
+	const count = Object.keys(payload).length;
+	return buildTextToolResult(`${count === 0 ? "No token definitions were resolved." : `Resolved ${formatCount(count, "token definition")}.`}\nRead structuredContent for token values and aliases.`, payload);
+}
+function buildGetScreenshotToolResult(payload) {
+	return buildTextToolResult(`${describeScreenshot(payload)} - Download: ${payload.asset.url}`, payload);
+}
+function buildGetAssetsToolResult(payload) {
+	const summary = [];
+	summary.push(payload.assets.length ? `Resolved ${formatCount(payload.assets.length, "asset")}.` : "No assets were resolved for the requested hashes.");
+	if (payload.missing.length) summary.push(`Missing: ${payload.missing.join(", ")}`);
+	summary.push("Download bytes from each asset.url.");
+	return buildTextToolResult(summary.join("\n"), payload);
+}
+function buildTextToolResult(text, structuredContent) {
+	return {
+		content: [{
+			type: "text",
+			text
+		}],
+		structuredContent
+	};
+}
+function serializeUtf8Value(value) {
+	if (typeof value === "string") return value;
+	return JSON.stringify(value, null, 0) ?? "undefined";
+}
+function countOutlineNodes(nodes) {
+	let count = 0;
+	const stack = [...nodes];
+	while (stack.length) {
+		const current = stack.pop();
+		if (!current) continue;
+		count += 1;
+		if (current.children?.length) stack.push(...current.children);
+	}
+	return count;
+}
+function formatBytes(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function formatCount(count, singular) {
+	return `${count} ${count === 1 ? singular : `${singular}s`}`;
+}
+function describeScreenshot(result) {
+	return `Screenshot ${result.width}x${result.height} @${result.scale}x (${formatBytes(result.bytes)})`;
+}
 const AssetDescriptorSchema = z.object({
 	hash: z.string().min(1),
 	url: z.string().url(),
@@ -80,7 +252,7 @@ const GetCodeParametersSchema = z.object({
 	nodeId: z.string().describe("Optional target node id; omit to use the current single selection when pulling the baseline snapshot.").optional(),
 	preferredLang: z.enum(["jsx", "vue"]).describe("Preferred output language to bias the snapshot; otherwise uses the design’s hint/detected language, then falls back to JSX.").optional(),
 	resolveTokens: z.boolean().describe("Inline token values instead of references for quick renders; default false returns token metadata so you can map into your theming system. When true, values are resolved per-node (mode-aware).").optional(),
-	vectorMode: z.enum(["smart", "snapshot"]).describe("Vector output mode. `smart` (default) emits inline themeable single-color SVGs and asset-backed fixed-color vectors as the tool default. `snapshot` preserves vector assets for fidelity. Final vector delivery may still be adapted to the Host app’s SVG policy.").optional()
+	vectorMode: z.enum(["smart", "snapshot"]).describe("Vector output mode. `smart` (default) emits `<svg data-src=\"...\">` placeholders in code and preserves themeable instance color on the emitted SVG root markup for downstream adaptation; if asset upload fails after export, the tool may inline the SVG as a fallback to preserve source of truth. `snapshot` preserves vector assets for fidelity. Final vector delivery may still be adapted to the Host app’s SVG policy.").optional()
 });
 const GetTokenDefsParametersSchema = z.object({
 	names: z.array(z.string().regex(/^--[a-zA-Z0-9-_]+$/)).min(1).describe("Canonical token names (CSS variable form) from Object.keys(get_code.tokens) or your own list to resolve, e.g., --color-primary."),
@@ -96,10 +268,9 @@ const GetAssetsResultSchema = z.object({
 	assets: z.array(AssetDescriptorSchema),
 	missing: z.array(z.string().min(1))
 });
-
 //#endregion
 //#region src/asset-utils.ts
-const HASH_FILENAME_PATTERN = new RegExp(`^([a-f0-9]{${MCP_HASH_HEX_LENGTH}})(?:\\.[a-z0-9]+)?$`, "i");
+const HASH_FILENAME_PATTERN = new RegExp(`^([a-f0-9]{8})(?:\\.[a-z0-9]+)?$`, "i");
 const MIME_EXTENSION_OVERRIDES = new Map([["image/jpeg", "jpg"]]);
 const SAFE_IMAGE_EXTENSION_PATTERN = /^[a-z0-9-]+$/;
 function normalizeMimeType(mimeType) {
@@ -126,7 +297,6 @@ function getHashFromAssetFilename(filename) {
 	const match = HASH_FILENAME_PATTERN.exec(filename);
 	return match ? match[1] : null;
 }
-
 //#endregion
 //#region src/config.ts
 function parsePositiveInt(envValue, fallback) {
@@ -159,11 +329,10 @@ function getMcpServerConfig() {
 		assetTtlMs: resolveAssetTtlMs()
 	};
 }
-
 //#endregion
 //#region src/asset-http-server.ts
 const LOOPBACK_HOST = "127.0.0.1";
-const HASH_HEX_PATTERN = new RegExp(`^[a-f0-9]{${MCP_HASH_HEX_LENGTH}}$`, "i");
+const HASH_HEX_PATTERN = new RegExp(`^[a-f0-9]{8}$`, "i");
 const { maxAssetSizeBytes } = getMcpServerConfig();
 function createAssetHttpServer(store) {
 	const server = createServer$1(handleRequest);
@@ -367,7 +536,7 @@ function createAssetHttpServer(store) {
 				}
 				return;
 			}
-			if (hasher.digest("hex").slice(0, MCP_HASH_HEX_LENGTH) !== hash) {
+			if (hasher.digest("hex").slice(0, 8) !== hash) {
 				cleanup();
 				sendError(res, 400, "Hash Mismatch");
 				return;
@@ -420,7 +589,6 @@ function createAssetHttpServer(store) {
 		getBaseUrl
 	};
 }
-
 //#endregion
 //#region src/asset-store.ts
 const INDEX_FILENAME = "assets.json";
@@ -581,11 +749,9 @@ function createAssetStore(options = {}) {
 		flush
 	};
 }
-
 //#endregion
 //#region src/instructions.md?raw
-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- If `get_code` warns `shell`, read the inline code comment for omitted direct child ids, then call `get_code` for those ids in order and fill the results back into the returned shell.\n- Use `get_structure` only to resolve layout/overlap uncertainty; do not derive numeric values from images.\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- Vectors: `vectorMode=smart` is the default. Treat the emitted markup as the source of truth for the current response, but adapt final vector delivery to the Host app's existing SVG policy when integrating: existing icon/component primitives, import-time SVG transforms, inline SVG, or asset-backed `<img>`.\n- Themeable vectors: `themeable=true` means the SVG can safely adopt one contextual color channel, typically via `currentColor` driven by the wrapper/component `color` style or token. It does not mean the SVG exposes multiple independent color parameters.\n- Assets: download bytes via `asset.url`. Asset resources are not exposed via MCP `resources/read`. Use `asset.themeable` only when an SVG still needs repo asset handling after you account for the Host app's vector policy.\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`, keep the returned parent code as composition evidence and use returned `data-hint-id` values to choose narrower `get_code` follow-ups.\n- If `get_code` warns `shell`, read the inline code comment for omitted direct child ids, then call `get_code` for those ids in order and fill the results back into the returned shell.\n- Use `get_structure` only to resolve layout/overlap uncertainty; do not derive numeric values from images.\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- Vectors: `vectorMode=smart` is the default. Treat the emitted markup as the source of truth for the current response; vector code is emitted as `<svg data-src=\"...\">` placeholders, but if asset upload fails after export the tool may inline the SVG as a fallback to preserve source of truth.\n- Themeable vectors: `themeable=true` means the SVG can safely adopt one contextual color channel. In `smart` mode, that color is typically already evidenced on the emitted `svg` root markup for the placeholder. It does not mean the SVG exposes multiple independent color parameters.\n- Assets: download bytes via `asset.url`. Asset resources are not exposed via MCP `resources/read`. Use `asset.themeable` only when an SVG still needs repo asset handling after you account for the Host app's vector policy.\n";
 //#endregion
 //#region src/request.ts
 const pendingCalls = /* @__PURE__ */ new Map();
@@ -653,9 +819,23 @@ function cleanupAll() {
 	});
 	pendingCalls.clear();
 }
-
 //#endregion
 //#region src/tools.ts
+const CONNECTIVITY_ERROR_CODES = new Set([
+	TEMPAD_MCP_ERROR_CODES.NO_ACTIVE_EXTENSION,
+	TEMPAD_MCP_ERROR_CODES.EXTENSION_TIMEOUT,
+	TEMPAD_MCP_ERROR_CODES.EXTENSION_DISCONNECTED,
+	TEMPAD_MCP_ERROR_CODES.ASSET_SERVER_NOT_CONFIGURED,
+	TEMPAD_MCP_ERROR_CODES.TRANSPORT_NOT_CONNECTED
+]);
+const SELECTION_ERROR_CODES = new Set([TEMPAD_MCP_ERROR_CODES.INVALID_SELECTION, TEMPAD_MCP_ERROR_CODES.NODE_NOT_VISIBLE]);
+const CONNECTIVITY_TROUBLESHOOTING_LINES = [
+	"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."
+];
+const SELECTION_TROUBLESHOOTING_LINE = "Tip: Select exactly one visible node, or pass nodeId.";
 function getRecordProperty$1(record, key) {
 	if (!record || typeof record !== "object") return;
 	return Reflect.get(record, key);
@@ -669,7 +849,7 @@ function hubTool(definition) {
 const TOOL_DEFS = [
 	extTool({
 		name: "get_code",
-		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. `vectorMode=smart` (default) emits inline themeable single-color SVGs and asset-backed fixed-color vectors as the tool default; `vectorMode=snapshot` preserves vector assets for fidelity. Host apps should still refactor vector delivery to repo policy where needed (existing icon/component primitives, import-time SVG transforms, inline SVG, or asset-backed `<img>`). SVG asset metadata may include `themeable=true`, meaning the exported asset can safely adopt one contextual color channel. 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 shell, read the inline comment for omitted direct child ids and fetch them in order. If warnings include auto-layout (inferred), use get_structure 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).",
+		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. `vectorMode=smart` (default) emits `<svg data-src=\"...\">` placeholders in code and preserves themeable instance color on the emitted SVG root markup for downstream adaptation; if asset upload fails after export, the tool may inline the SVG as a fallback to preserve source of truth. `vectorMode=snapshot` preserves vector assets for fidelity. Host apps should still refactor vector delivery to repo policy where needed (existing icon/component primitives, import-time SVG transforms, inline SVG, or asset-backed SVG usage). SVG asset metadata may include `themeable=true`, meaning the exported asset can safely adopt one contextual color channel. Start here, then refactor into repo conventions while preserving values/intent; strip any data-hint-* attributes (hints only). If warnings include depth-cap, use returned data-hint-id values to continue with narrower get_code calls. If warnings include shell, read the inline comment for omitted direct child ids and fetch them in order. If warnings include auto-layout (inferred), use get_structure 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
@@ -679,6 +859,7 @@ const TOOL_DEFS = [
 		description: "Resolve canonical token names to literal values (optionally including all modes) for tokens referenced by get_code.",
 		parameters: GetTokenDefsParametersSchema,
 		target: "extension",
+		format: createTokenDefsToolResponse,
 		exposed: false
 	}),
 	extTool({
@@ -693,7 +874,8 @@ const TOOL_DEFS = [
 		name: "get_structure",
 		description: "Get a compact structural + geometry outline for nodeId/current single selection to understand hierarchy and layout intent.",
 		parameters: GetStructureParametersSchema,
-		target: "extension"
+		target: "extension",
+		format: createStructureToolResponse
 	}),
 	hubTool({
 		name: "get_assets",
@@ -726,53 +908,37 @@ function createToolErrorResponse(toolName, error) {
 		isError: true,
 		content: [{
 			type: "text",
-			text: `Tool "${toolName}" failed${code ? ` [${code}]` : ""}: ${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")}` : "";
-			})()}`
+			text: `Tool "${toolName}" failed${code ? ` [${code}]` : ""}: ${message}${buildTroubleshootingText(code, message)}`
 		}]
 	};
 }
-function formatBytes(bytes) {
-	if (bytes < 1024) return `${bytes} B`;
-	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+function buildTroubleshootingText(code, message) {
+	const help = [];
+	if (isConnectivityToolError(code, message)) help.push(...CONNECTIVITY_TROUBLESHOOTING_LINES);
+	if (isSelectionToolError(code, message)) help.push(SELECTION_TROUBLESHOOTING_LINE);
+	return help.length ? `\n\n${help.join("\n")}` : "";
+}
+function isConnectivityToolError(code, message) {
+	return (code ? CONNECTIVITY_ERROR_CODES.has(code) : false) || /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);
+}
+function isSelectionToolError(code, message) {
+	return (code ? SELECTION_ERROR_CODES.has(code) : false) || /select exactly one visible node/i.test(message) || /no visible node found/i.test(message);
 }
 function createCodeToolResponse(payload) {
 	if (!isCodeResult(payload)) throw new Error("Invalid get_code payload received from extension.");
-	const summary = [];
-	const codeSize = Buffer.byteLength(payload.code, "utf8");
-	summary.push(`Generated \`${payload.lang}\` snippet (${formatBytes(codeSize)}).`);
-	if (payload.warnings?.length) {
-		const warningText = payload.warnings.map((warning) => warning.message).join(" ");
-		summary.push(warningText);
-	}
-	summary.push(payload.assets?.length ? `Assets attached: ${payload.assets.length}. Download bytes from each asset.url.` : "No binary assets were attached to this response.");
-	const tokenCount = payload.tokens ? Object.keys(payload.tokens).length : 0;
-	if (tokenCount) summary.push(`Token references included: ${tokenCount}.`);
-	summary.push("Read structuredContent for the full code string and asset metadata.");
-	return {
-		content: [{
-			type: "text",
-			text: summary.join("\n")
-		}],
-		structuredContent: payload
-	};
+	return toCallToolResult(buildGetCodeToolResult(payload));
+}
+function createStructureToolResponse(payload) {
+	if (!isStructureResult(payload)) throw new Error("Invalid get_structure payload received from extension.");
+	return toCallToolResult(buildGetStructureToolResult(payload));
+}
+function createTokenDefsToolResponse(payload) {
+	if (!isTokenDefsResult(payload)) throw new Error("Invalid get_token_defs payload received from extension.");
+	return toCallToolResult(buildGetTokenDefsToolResult(payload));
 }
 function createScreenshotToolResponse(payload) {
 	if (!isScreenshotResult(payload)) throw new Error("Invalid get_screenshot payload received from extension.");
-	return {
-		content: [{
-			type: "text",
-			text: `${describeScreenshot(payload)} - Download: ${payload.asset.url}`
-		}],
-		structuredContent: payload
-	};
-}
-function describeScreenshot(result) {
-	return `Screenshot ${result.width}x${result.height} @${result.scale}x (${formatBytes(result.bytes)})`;
+	return toCallToolResult(buildGetScreenshotToolResult(payload));
 }
 function isScreenshotResult(payload) {
 	if (typeof payload !== "object" || !payload) return false;
@@ -784,6 +950,21 @@ function isCodeResult(payload) {
 	const candidate = payload;
 	return typeof candidate.code === "string" && typeof candidate.lang === "string" && (candidate.assets === void 0 || Array.isArray(candidate.assets));
 }
+function isStructureResult(payload) {
+	if (typeof payload !== "object" || !payload) return false;
+	const candidate = payload;
+	return Array.isArray(candidate.roots);
+}
+function isTokenDefsResult(payload) {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return false;
+	for (const value of Object.values(payload)) {
+		if (!value || typeof value !== "object") return false;
+		const token = value;
+		if (typeof token.kind !== "string") return false;
+		if (token.value === void 0) return false;
+	}
+	return true;
+}
 function coercePayloadToToolResponse(payload) {
 	if (payload && typeof payload === "object" && Array.isArray(payload.content)) return payload;
 	return { content: [{
@@ -791,7 +972,31 @@ function coercePayloadToToolResponse(payload) {
 		text: typeof payload === "string" ? payload : JSON.stringify(payload, null, 2)
 	}] };
 }
-
+function createAssetsToolResponse(payload) {
+	return toCallToolResult(buildGetAssetsToolResult(payload));
+}
+function createInlineBudgetExceededToolResponse(toolName, actualBytes) {
+	return {
+		isError: true,
+		content: [{
+			type: "text",
+			text: `Tool "${toolName}" exceeded the 64 KiB inline budget (${actualBytes} UTF-8 bytes > ${MCP_TOOL_INLINE_BUDGET_BYTES}). ${getBudgetRetryGuidance(toolName)}`
+		}]
+	};
+}
+function toCallToolResult(result) {
+	return result;
+}
+function getBudgetRetryGuidance(toolName) {
+	switch (toolName) {
+		case "get_code": return "Reduce selection size or request a smaller nodeId subtree and retry.";
+		case "get_structure": return "Reduce selection size or pass a smaller depth and retry.";
+		case "get_token_defs": return "Reduce requested names or split them into smaller batches and retry.";
+		case "get_screenshot": return "Reduce selection size or scale and retry.";
+		case "get_assets": return "Request fewer hashes in a single call and retry.";
+		default: return "Retry with a narrower request.";
+	}
+}
 //#endregion
 //#region src/hub.ts
 const SHUTDOWN_TIMEOUT = 2e3;
@@ -903,7 +1108,7 @@ function createMcpServer() {
 	const mcp = new McpServer({
 		name: "tempad-dev-mcp",
 		version: PACKAGE_VERSION
-	}, instructions_default ? { instructions: instructions_default } : void 0);
+	}, { instructions: instructions_default });
 	const registered = [];
 	for (const tool of TOOL_DEFINITIONS) {
 		if ("exposed" in tool && tool.exposed === false) continue;
@@ -983,18 +1188,30 @@ function registerLocalTool(mcp, tool) {
 	registerToolFn(tool.name, registrationOptions, registerHandler);
 }
 function createToolResponse(toolName, payload) {
-	const definition = getToolDefinition(toolName);
-	if (definition && hasFormatter(definition)) try {
-		const formatter = definition.format;
-		return formatter(payload);
-	} catch (error) {
+	const rawResult = (() => {
+		const definition = getToolDefinition(toolName);
+		if (definition && hasFormatter(definition)) try {
+			const formatter = definition.format;
+			return formatter(payload);
+		} catch (error) {
+			log.warn({
+				tool: toolName,
+				error
+			}, "Failed to format tool result; returning raw payload.");
+			return coercePayloadToToolResponse(payload);
+		}
+		return coercePayloadToToolResponse(payload);
+	})();
+	const resultBytes = measureCallToolResultBytes(rawResult);
+	if (resultBytes > 65536) {
 		log.warn({
 			tool: toolName,
-			error
-		}, "Failed to format tool result; returning raw payload.");
-		return coercePayloadToToolResponse(payload);
+			resultBytes,
+			inlineBudgetBytes: MCP_TOOL_INLINE_BUDGET_BYTES
+		}, "Tool result exceeded inline budget; returning compact error response.");
+		return createInlineBudgetExceededToolResponse(toolName, resultBytes);
 	}
-	return coercePayloadToToolResponse(payload);
+	return rawResult;
 }
 async function handleGetAssets({ hashes }) {
 	if (hashes.length > 100) throw new Error("Too many hashes requested. Limit is 100.");
@@ -1005,21 +1222,10 @@ async function handleGetAssets({ hashes }) {
 		return false;
 	});
 	const found = new Set(records.map((record) => record.hash));
-	const payload = GetAssetsResultSchema.parse({
+	return createAssetsToolResponse(GetAssetsResultSchema.parse({
 		assets: records.map((record) => buildAssetDescriptor(record)),
 		missing: unique.filter((hash) => !found.has(hash))
-	});
-	const summary = [];
-	summary.push(payload.assets.length ? `Resolved ${payload.assets.length} asset${payload.assets.length === 1 ? "" : "s"}.` : "No assets were resolved for the requested hashes.");
-	if (payload.missing.length) summary.push(`Missing: ${payload.missing.join(", ")}`);
-	summary.push("Download bytes from each asset.url.");
-	return {
-		content: [{
-			type: "text",
-			text: summary.join("\n")
-		}],
-		structuredContent: payload
-	};
+	}));
 }
 function getActiveId() {
 	return extensions.find((e) => e.active)?.id ?? null;
@@ -1271,7 +1477,7 @@ wss.on("connection", (ws) => {
 log.info({ port: selectedWsPort }, "WebSocket server ready.");
 process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=hub.mjs.map