@xiaobuyu/nodesign 0.0.1

package/server/engine/mcp/tools/explain-style.js

@@ -0,0 +1,237 @@
+/**
+ * mcp/tools/explain-style.js — explain_style（2026-08-18）
+ *
+ * ## 这个洞是什么
+ *
+ * `get_computed_styles` 告诉你**结果**（marginBottom: 0px），不告诉你**为什么**。
+ * 浏览器 devtools 的 Styles 面板会把败下阵的声明划掉，一眼就看得出是谁赢了 ——
+ * agent 手里恰恰没有 devtools。
+ *
+ * 真实案例：用户圈出"这里太挤了、很贴底边"。真因是 `.wrap { margin: 0 auto }`
+ * 这条**简写** —— 类选择器优先级高于 `main > section { margin-bottom: 108px }`，
+ * 把所有带 .wrap 的节的下边距清成了 0，全站每一节都在吃这个亏。
+ * 定位过程：computed 报 0px（对的，但只告诉结果）→ 怀疑外边距塌陷 → 怀疑媒体
+ * 查询 → 怀疑变量没解析 → grep 整个 CSS → 都排除后才想到是简写覆盖。
+ * **五六轮工具调用，而 devtools 里这是一眼的事。**
+ *
+ * 这类 bug 在"一份手写 CSS + 后加的工具类"的站点上非常常见 —— 也就是这个平台上
+ * 绝大多数站点。
+ *
+ * ## 实现
+ *
+ * 走 CDP 的 `CSS.getMatchedStylesForNode`：它按级联次序返回命中该元素的全部规则，
+ * 我们从里面挑出跟目标属性有关的声明（**含简写展开**），标出谁赢、谁被压掉、
+ * 各自来自哪条规则。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { resolveCanvasTarget, CANVAS_PATH_DESC, requireBrowsable } from '../../../lib/artifact-target.js';
+import { degradedNote, SITE_DEVICE_W } from './helpers/perception-page.js';
+import { acquireArtifactPage, LIVE_PARAM_DESC } from './helpers/acquire-page.js';
+
+/** 简写 → 它能设置的长手属性（只列常踩的那些，够覆盖真实事故） */
+const SHORTHAND_OF = {
+  margin: ['margin-top', 'margin-right', 'margin-bottom', 'margin-left'],
+  padding: ['padding-top', 'padding-right', 'padding-bottom', 'padding-left'],
+  inset: ['top', 'right', 'bottom', 'left'],
+  border: ['border-width', 'border-style', 'border-color'],
+  'border-width': ['border-top-width', 'border-right-width', 'border-bottom-width', 'border-left-width'],
+  'border-radius': ['border-top-left-radius', 'border-top-right-radius', 'border-bottom-right-radius', 'border-bottom-left-radius'],
+  background: ['background-color', 'background-image', 'background-position', 'background-size', 'background-repeat'],
+  font: ['font-family', 'font-size', 'font-weight', 'font-style', 'line-height'],
+  flex: ['flex-grow', 'flex-shrink', 'flex-basis'],
+  gap: ['row-gap', 'column-gap'],
+  overflow: ['overflow-x', 'overflow-y'],
+  transition: ['transition-property', 'transition-duration', 'transition-timing-function', 'transition-delay'],
+  animation: ['animation-name', 'animation-duration', 'animation-timing-function'],
+  'grid-template': ['grid-template-rows', 'grid-template-columns'],
+  'place-items': ['align-items', 'justify-items'],
+  'place-content': ['align-content', 'justify-content'],
+};
+
+/** 一条声明是否影响目标属性：直接同名，或者是能设置它的简写 */
+function affects(declName, prop) {
+  if (declName === prop) return { hit: true, viaShorthand: null };
+  const longhands = SHORTHAND_OF[declName];
+  if (longhands && longhands.includes(prop)) return { hit: true, viaShorthand: declName };
+  return { hit: false };
+}
+
+export function makeExplainStyleTool({ workspaceRoot, projectId, sessionId }) {
+  return tool(
+    'explain_style',
+    `Explain WHY one CSS property has the value it has: every declaration that
+matched the element, in cascade order, with the winner marked and the losers
+listed — including declarations that came from a SHORTHAND.
+
+get_computed_styles gives you the result; this gives you the reason. Reach for it
+the moment a value is not what your CSS says it should be, instead of guessing
+through margin collapse / media queries / unresolved variables one at a time.
+
+The case this was built for: a section's margin-bottom computed to 0px even
+though the stylesheet said 108px. Cause was ".wrap { margin: 0 auto }" — a
+shorthand on a class selector, higher specificity than "main > section", zeroing
+the bottom margin of every .wrap section on the site. Five or six tool calls to
+find by elimination; one call here.
+
+Note it reports the FIRST element matching the selector.`,
+    {
+      selector: z.string().min(1)
+        .describe('CSS selector — the first match is explained. Plain CSS only (no :has-text, >>, nth=).'),
+      property: z.string().min(1)
+        .describe('The CSS property to explain, e.g. "margin-bottom", "color", "display". Use the longhand name when you can — asking about "margin" tells you less than asking about "margin-bottom".'),
+      path: z.string().optional().describe(CANVAS_PATH_DESC),
+      device: z.enum(['desktop', 'tablet', 'mobile']).optional()
+        .describe('Viewport width, so media queries resolve the way they do at that breakpoint (default desktop 1440).'),
+      live: z.boolean().optional().describe(LIVE_PARAM_DESC),
+    },
+    async ({ selector, property, path: relPath, device, live }) => {
+      const asText = (text, isError = false) => ({ content: [{ type: 'text', text }], ...(isError ? { isError: true } : {}) });
+      const target = await resolveCanvasTarget(workspaceRoot, relPath, sessionId);
+      if (!target) return asText('No page found.', true);
+      const guard = requireBrowsable(target);
+      if (guard) return asText(guard, true);
+
+      const W = SITE_DEVICE_W[device || 'desktop'];
+      const prop = property.trim().toLowerCase();
+
+      let acq;
+      try {
+        acq = await acquireArtifactPage({ projectId, workspaceRoot, target, live, viewport: { width: W, height: 900 } });
+        const page = acq.page;
+        const opened = acq;
+
+        const computed = await page.evaluate(([sel, p]) => {
+          const el = document.querySelector(sel);
+          if (!el) return null;
+          return getComputedStyle(el).getPropertyValue(p);
+        }, [selector, prop]);
+        if (computed === null) return asText(`Selector matched no elements: ${selector}`, true);
+
+        const cdp = await page.context().newCDPSession(page);
+        // styleSheetId → 文件名。同一个 selector 出现在两个文件里时（reset + 组件，
+        // 最常见的那种），光打 `.card` 两行人分不出谁是谁。**必须在 CSS.enable
+        // 之前挂监听** —— 已有的样式表是在 enable 的那一刻补发的。
+        const sheetName = new Map();
+        cdp.on('CSS.styleSheetAdded', (ev) => {
+          // ⚠️ `isInline` 要**先**判：`<style>` 块的 sourceURL 是文档自己的地址，
+          // 按 URL 取名会打出 `page.html?nd=raw` 这种（连我们内部的 raw 参数都漏给
+          // agent 看），而它其实是"页面里那段 <style>"
+          const url = ev?.header?.sourceURL || '';
+          const name = ev?.header?.isInline ? '<style> 内联'
+            : (url ? decodeURIComponent((url.split('?')[0] || url).split('/').pop() || url) : '');
+          if (ev?.header?.styleSheetId) sheetName.set(ev.header.styleSheetId, name);
+        });
+        await cdp.send('DOM.enable');
+        await cdp.send('CSS.enable');
+        const { root } = await cdp.send('DOM.getDocument', { depth: -1 });
+        const { nodeId } = await cdp.send('DOM.querySelector', { nodeId: root.nodeId, selector });
+        if (!nodeId) return asText(`Selector matched no elements: ${selector}`, true);
+        const matched = await cdp.send('CSS.getMatchedStylesForNode', { nodeId });
+
+        // 收集：CDP 的 matchedCSSRules 按**优先级递增**排（最后一条最强）
+        const rows = [];
+        const push = (where, style, extra = {}) => {
+          for (const d of style?.cssProperties ?? []) {
+            if (d.disabled) continue;
+            const a = affects(String(d.name).toLowerCase(), prop);
+            if (!a.hit) continue;
+            // ⚠️ CDP 这一版的 `d.value` **本身就带着** `!important`，再拼一次会打出
+            // `color: red !important !important` —— 看起来像源码里真写了两遍
+            const val = String(d.value).replace(/\s*!\s*important\s*$/i, '');
+            rows.push({
+              where,
+              decl: `${d.name}: ${val}${d.important ? ' !important' : ''}`,
+              important: !!d.important,
+              viaShorthand: a.viaShorthand,
+              ...extra,
+            });
+          }
+        };
+
+        let ruleIdx = 0;
+        for (const m of matched.matchedCSSRules ?? []) {
+          const sel = m.rule?.selectorList?.text ?? '?';
+          const sheet = m.rule?.origin === 'user-agent' ? 'browser default'
+            : (matched.cssKeyframesRules ? null : null);
+          const media = (m.rule?.media ?? []).map(x => x.text).filter(Boolean).join(' and ');
+          const from = sheet || sheetName.get(m.rule?.styleSheetId) || '';
+          push(`${sel}${media ? ` @media ${media}` : ''}${from ? ` [${from}]` : ''}`, m.rule?.style, {
+            origin: m.rule?.origin,
+            ruleIdx: ruleIdx++,   // ⭐ 合并键，见下面那段注释
+          });
+        }
+        if (matched.inlineStyle) push('element inline style="…"', matched.inlineStyle, { inline: true, ruleIdx: 'inline' });
+
+        // 合并同一条规则里的重复条目。CDP 会把简写和它展开出来的长手**都**列一遍
+        // （`.wrap { margin: 0 auto }` 出两条：`margin: 0 auto` + `margin-bottom: 0px`），
+        // 直接打印就是四行里两行是同一件事。留长手那条（它给的是真正生效的值），
+        // 把"来自哪个简写"作为标注挂上去。
+        //
+        // ⛔ 合并键必须是**规则本身**（ruleIdx），不能是 selector 文本。审查实测：
+        // `reset.css` 里 `.card{color:red!important}` 加 `component.css` 里
+        // `.card{color:blue}` —— 两条不同规则碰巧同 selector，按文本合并会折成一条，
+        // `same.decl = r.decl` 留下后者的值（蓝）、`same.important ||=` 又把 red 的
+        // important 标志过继给它，于是工具报「蓝赢」而浏览器画的是红，**真正的赢家
+        // 一行都没出现**。正好命中它的目标人群：手写 CSS 上面又叠了 reset/工具类。
+        const merged = [];
+        for (const r of rows) {
+          const same = merged.find(x => x.ruleIdx === r.ruleIdx);
+          if (!same) { merged.push({ ...r }); continue; }
+          const rIsLonghand = !r.viaShorthand;
+          if (rIsLonghand) {
+            same.decl = r.decl;                      // 长手的值才是生效值
+            same.important = same.important || r.important;
+          } else if (!same.viaShorthand) {
+            same.viaShorthand = r.viaShorthand;      // 把简写来历补到长手那条上
+          }
+          if (r.viaShorthand) same.viaShorthand = r.viaShorthand;
+        }
+        rows.length = 0;
+        rows.push(...merged);
+
+        if (!rows.length) {
+          return asText([
+            `${selector} → ${prop} computes to "${computed}"`,
+            '',
+            'No declaration anywhere sets this property (directly or via a shorthand).',
+            'So the value is inherited or the property\'s initial value — if that surprises you,',
+            'the property you wrote is probably not the one you think controls this.',
+          ].join('\n'));
+        }
+
+        // 赢家：!important 的最后一条 > 普通的最后一条（inline 已经排在最后）
+        const importants = rows.filter(r => r.important);
+        const winner = importants.length ? importants[importants.length - 1] : rows[rows.length - 1];
+
+        const degraded = degradedNote(opened);   // 契约：note 非空必须写进返回文本
+        const lines = [
+          ...(degraded ? [degraded, ''] : []),
+          ...(acq.liveNote ? [acq.liveNote, ''] : []),
+          `${selector} → ${prop} computes to "${computed}"  (viewport ${acq.live ? acq.viewport.width : W}px)`,
+          '',
+          'Declarations that matched, weakest first:',
+        ];
+        for (const r of rows) {
+          const mark = r === winner ? '✅ WINS  ' : '   lost  ';
+          const via = r.viaShorthand
+            ? `   ⭐ via the "${r.viaShorthand}" SHORTHAND — it sets ${prop} even though it does not name it`
+            : '';
+          lines.push(`${mark}${r.decl}\n         from  ${r.where}${via}`);
+        }
+        if (winner.viaShorthand) {
+          lines.push('', `⭐ The winning declaration is a shorthand ("${winner.viaShorthand}"). This is the`
+            + ' single most missable cause of "my CSS says X but the page shows Y": a shorthand on a'
+            + ' higher-specificity selector silently resets longhands you set elsewhere. Fix by using'
+            + ` the longhand there, or by setting ${prop} again after it.`);
+        }
+        return asText(lines.join('\n'));
+      } catch (err) {
+        return asText(`explain_style failed: ${err?.message || String(err)}`, true);
+      } finally {
+        await acq?.release?.();   // 一次性：关浏览器；live：松会话锁
+      }
+    },
+  );
+}

package/server/engine/mcp/tools/export-handoff.js

@@ -0,0 +1,133 @@
+/**
+ * mcp/tools/export-handoff.js — export_handoff MCP tool
+ *
+ * agent 觉得设计到了交付时机时主动调，把 canvas.html / spec.json /
+ * assets / chat-history / README 打包成 handoff.zip。
+ *
+ * 复用 server/api/exports.js 的 buildHandoffZip pipeline，agent 端和
+ * 用户按钮路径输出一致。
+ *
+ * 输出位置：写到 workspace/exports/handoff-<ts>.zip。agent 不能直接给
+ * 用户文件，所以告诉用户路径，用户从前端 UI 看到 / 下载。
+ *
+ * 调用约定（agent 端）：
+ *   mcp__nodesign__export_handoff
+ *     notes?: string  可选记录"为什么这个时机交付"
+ */
+
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { buildHandoffZip } from '../../../api/exports.js';
+import { getProject, listRunsForProject } from '../../../projects/store.js';
+import { resolveCanvasTarget, CANVAS_PATH_DESC } from '../../../lib/artifact-target.js';
+
+/**
+ * @param {object} deps
+ * @param {string} deps.workspaceRoot
+ * @param {string} [deps.projectId]
+ * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
+ */
+export function makeExportHandoffTool({ workspaceRoot, sharedRoot, projectId, sessionId, ctx }) {
+  return tool(
+    'export_handoff',
+    `Build a handoff zip: the artifact's source, the assets it actually
+references, and a README that says what it is, how to run it, and — for a
+mock-data app — which backend endpoints the recipient needs to implement.
+
+Use this when the work is done and the user wants to take it away. The point of
+this package is that **someone else can pick the project up and keep building**;
+it is not the "give me a pretty file to look at" path (that's the export menu's
+PDF / single-page HTML).
+
+The zip is written to workspace/exports/handoff-<timestamp>.zip. After building,
+tell the user the path so they can download it via the UI.
+
+Use this tool when:
+- The artifact meets the brief and you've verified it (e.g., via screenshot_canvas)
+- The user says "give me the files" / "package it up" / "I want to host this myself"
+
+Do NOT use this tool when:
+- The work is still in iteration
+- The artifact doesn't exist yet (nothing has been written)`,
+    {
+      notes: z
+        .string()
+        .optional()
+        .describe('Optional notes about why exporting now (gets logged but not in the zip)'),
+      path: z.string().optional().describe(CANVAS_PATH_DESC),
+    },
+    async ({ notes, path: relPath }) => {
+      try {
+        let projectMeta = null;
+        let runs = [];
+        if (projectId) {
+          try {
+            projectMeta = getProject(projectId);
+            runs = listRunsForProject(projectId);
+          } catch { /* DB not available 或 project 已删 */ }
+        }
+
+        // 2026-07-28：这里以前少传了 sharedRoot（签名是 (sessionRoot, sharedRoot, opts)），
+        // opts 被当成 sharedRoot —— 导出的 zip 里 assets 全空、元数据全 unknown。
+        const target = await resolveCanvasTarget(workspaceRoot, relPath, sessionId);
+        if (!target.ok) return { content: [{ type: 'text', text: target.message }], isError: true };
+        const buf = await buildHandoffZip(workspaceRoot, sharedRoot || workspaceRoot, {
+          projectId: projectMeta?.id || projectId || 'unknown',
+          projectName: projectMeta?.name || 'design',
+          skillId: projectMeta?.skillId,
+          sessionId,
+          runs,
+          deckPath: target.relPath,
+        });
+
+        const exportDir = path.join(workspaceRoot, 'exports');
+        await fs.mkdir(exportDir, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        // 名字不能再叫 relPath：它会遮蔽入参 relPath，而上面 resolveCanvasTarget
+        // 已经读过那个入参 —— 同一个块里先读后声明 = TDZ，整个工具每次调用必炸
+        const zipRel = `exports/handoff-${stamp}.zip`;
+        const absPath = path.join(workspaceRoot, zipRel);
+        await fs.writeFile(absPath, buf);
+
+        try {
+          ctx?.emit?.({
+            type: 'run.export_built',
+            format: 'handoff',
+            path: zipRel,
+            sizeBytes: buf.length,
+            notes: notes || null,
+          });
+          // 打完包直接进用户的下载列表，不用他再去导出菜单里翻（2026-07-28）
+          ctx?.emit?.({
+            type: 'run.download_ready',
+            url: `/api/projects/${encodeURIComponent(projectId || '')}`
+              + `/sessions/${encodeURIComponent(sessionId || '')}`
+              + `/exports/file/${encodeURIComponent(path.basename(zipRel))}`,
+            filename: path.basename(zipRel),
+            sizeBytes: buf.length,
+            count: 1,
+            note: notes || '工程交付包',
+          });
+        } catch { /* emit fail-safe */ }
+
+        return {
+          content: [{
+            type: 'text',
+            text: `Handoff zip built: ${zipRel} (${(buf.length / 1024).toFixed(1)} KB), deck = ${target.relPath}. `
+              + `Tell the user the package is ready — they can download it from the UI's export menu.`,
+          }],
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: 'text',
+            text: `Export handoff failed: ${err?.message || String(err)}`,
+          }],
+          isError: true,
+        };
+      }
+    },
+  );
+}

package/server/engine/mcp/tools/expose-tweaks.js

@@ -0,0 +1,149 @@
+/**
+ * mcp/tools/expose-tweaks.js — expose_tweaks MCP tool
+ *
+ * agent 看完 deck 内容后，把这份 deck 专属的"可调参数控制台"暴露成 schema，
+ * 写到 spec.json 的 spec.tweaks 字段。前端 TweaksPanel 读 schema 渲染
+ * sliders / color picker / segmented，拖动直接改 iframe :root CSS variable
+ * 实时预览（不落盘）；用户点 Apply 触发新 chat run，让 agent 把当前数值固化
+ * 进 canvas.html 的 :root。
+ *
+ * spec.json 结构：
+ *   spec.tweaks = {
+ *     version: 1,
+ *     controls: [{ id, type, label, target_var?, target_class_on?, ... }],
+ *     updatedAt, updatedBy: 'agent',
+ *   }
+ *
+ * 触发时机（详见 SKILL.md "Tweaks 暴露协议"）：
+ *   - 写完 deck 主动暴露 5-8 个核心可调参数
+ *   - 用户问"哪些可以调"时
+ *   - 用户在前端点了 Apply 时把 inline style 固化进 :root（这种 case agent
+ *     除了写 canvas.html 还应该 expose_tweaks 更新 default 值）
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { mutateSpecJson } from '../../../projects/workspace.js';
+
+const ControlSchema = z.object({
+  id: z.string().min(1).max(64).regex(/^[a-z0-9_-]+$/, 'id must be kebab/snake case'),
+  type: z.enum(['slider', 'color', 'segmented', 'toggle', 'select']),
+  label: z.string().min(1).max(80),
+  description: z.string().max(200).optional(),
+  target_var: z
+    .string()
+    .regex(/^--[a-zA-Z0-9-]+$/, 'target_var must be a CSS custom property starting with --')
+    .optional(),
+  target_class_on: z.string().optional(),
+  // A6.2：CSS selector 限定 control 影响范围。不传默认 ":root"（全局）。
+  // 例：'section[data-page="1"]' / '[data-layout="hero-split"]'（layout 名由 agent
+  // 按隐喻自由命名）。配合 SKILL.md HTML 规范的"per-page scoped override"教学
+  // （让"封面字号"slider 不牵连内页字号）。前端 TweaksPanel 应用时
+  // doc.querySelector(scope) 找元素在它身上 setProperty 而不是 :root。
+  target_scope: z
+    .string()
+    .max(120)
+    .optional()
+    .describe('CSS selector for scope (e.g. \'section[data-page="1"]\'); default ":root" applies globally. Use to limit one control to one page / one layout type.'),
+  min: z.number().optional(),
+  max: z.number().optional(),
+  step: z.number().optional(),
+  default: z.union([z.string(), z.number(), z.boolean()]),
+  unit: z.string().max(8).optional().describe('Suffix appended to numeric value, e.g. "px", "%"'),
+  options: z.array(z.object({
+    label: z.string(),
+    value: z.union([z.string(), z.number()]),
+  })).optional(),
+});
+
+/**
+ * @param {object} deps
+ * @param {string} deps.workspaceRoot
+ * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
+ */
+export function makeExposeTweaksTool({ workspaceRoot, ctx }) {
+  return tool(
+    'expose_tweaks',
+    `Expose a "tweaks schema" for the current deck — a list of UI controls
+(slider, color picker, segmented control, toggle, select) that the user can
+drag in the frontend to live-tweak the design without going through chat.
+
+Each control points at a CSS custom property (target_var, must start with --)
+or a class to toggle on root (target_class_on). Frontend renders the controls,
+binds onChange to set CSS variable on iframe :root for instant preview.
+
+Use this tool when:
+- You finished writing/editing canvas.html and want to expose 5-8 most
+  valuable tunables (hero font size, accent color, layout density, etc.)
+- The user asks "what can I adjust"
+- After the user clicks Apply on the frontend Tweaks panel — re-expose with
+  updated default values matching what was just baked into :root
+
+The schema is merged into spec.json's spec.tweaks field. Pass replace=true
+to wipe existing controls; default false merges by id.
+
+Frontend will refresh once it sees run.tweaks_exposed event.`,
+    {
+      controls: z.array(ControlSchema).min(1).max(20).describe('Tweak controls to expose'),
+      replace: z
+        .boolean()
+        .optional()
+        .describe('If true, replace all existing controls; default false merges by id'),
+    },
+    async ({ controls, replace }) => {
+      try {
+        if (!workspaceRoot) {
+          return {
+            content: [{ type: 'text', text: 'No workspace bound; cannot expose tweaks.' }],
+            isError: true,
+          };
+        }
+
+        // 串行 read-modify-write 防 spec.json 三路并发覆盖（详见 workspace.js mutateSpecJson）
+        let merged;
+        await mutateSpecJson(workspaceRoot, (spec) => {
+          const existing = (spec.tweaks && Array.isArray(spec.tweaks.controls))
+            ? spec.tweaks.controls
+            : [];
+          if (replace) {
+            merged = controls;
+          } else {
+            const byId = new Map(existing.map(c => [c.id, c]));
+            for (const c of controls) byId.set(c.id, c);
+            merged = [...byId.values()];
+          }
+          spec.tweaks = {
+            version: 1,
+            controls: merged,
+            updatedAt: new Date().toISOString(),
+            updatedBy: 'agent',
+          };
+        });
+
+        try {
+          ctx?.emit?.({
+            type: 'run.tweaks_exposed',
+            count: merged.length,
+            added: controls.length,
+            replaced: !!replace,
+          });
+        } catch { /* emit fail-safe */ }
+
+        return {
+          content: [{
+            type: 'text',
+            text: `Exposed ${controls.length} tweak control(s); spec.tweaks now has ${merged.length} total.`,
+          }],
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: 'text',
+            text: `expose_tweaks failed: ${err?.message || String(err)}`,
+          }],
+          isError: true,
+        };
+      }
+    },
+  );
+}