@shwfed/config 2.3.8 → 2.3.10

package/dist/mcp.mjs

@@ -1,5 +1,9 @@
 #!/usr/bin/env node
 import process$2 from "node:process";
+import { createServer } from "node:http";
+import { stat, readFile } from "node:fs/promises";
+import { resolve as resolve$1, sep } from "node:path";
+import { fileURLToPath } from "node:url";
 var util$2;
 (function(util2) {
   util2.assertEqual = (_) => {
@@ -3721,7 +3725,7 @@ function slugify(input) {
 }
 const captureStackTrace = "captureStackTrace" in Error ? Error.captureStackTrace : (..._args) => {
 };
-function isObject$3(data) {
+function isObject$4(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 const allowsEval = /* @__PURE__ */ cached$1(() => {
@@ -3740,7 +3744,7 @@ const allowsEval = /* @__PURE__ */ cached$1(() => {
   }
 });
 function isPlainObject$1(o) {
-  if (isObject$3(o) === false)
+  if (isObject$4(o) === false)
     return false;
   const ctor = o.constructor;
   if (ctor === void 0)
@@ -3748,7 +3752,7 @@ function isPlainObject$1(o) {
   if (typeof ctor !== "function")
     return true;
   const prot = ctor.prototype;
-  if (isObject$3(prot) === false)
+  if (isObject$4(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;
@@ -5311,7 +5315,7 @@ const $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
     }
     return propValues;
   });
-  const isObject2 = isObject$3;
+  const isObject2 = isObject$4;
   const catchall = def.catchall;
   let value;
   inst._zod.parse = (payload, ctx) => {
@@ -5444,7 +5448,7 @@ const $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def)
     return (payload, ctx) => fn(shape, payload, ctx);
   };
   let fastpass;
-  const isObject2 = isObject$3;
+  const isObject2 = isObject$4;
   const jit = !globalConfig.jitless;
   const allowsEval$1 = allowsEval;
   const fastEnabled = jit && allowsEval$1.value;
@@ -5576,7 +5580,7 @@ const $ZodDiscriminatedUnion = /* @__PURE__ */ $constructor("$ZodDiscriminatedUn
   });
   inst._zod.parse = (payload, ctx) => {
     const input = payload.value;
-    if (!isObject$3(input)) {
+    if (!isObject$4(input)) {
       payload.issues.push({
         code: "invalid_type",
         expected: "object",
@@ -15398,7 +15402,7 @@ function requireCompile() {
     }
   }
   compile$1.compileSchema = compileSchema;
-  function resolveRef(root, baseId, ref2) {
+  function resolveRef2(root, baseId, ref2) {
     var _a2;
     ref2 = (0, resolve_1.resolveUrl)(this.opts.uriResolver, baseId, ref2);
     const schOrFunc = root.refs[ref2];
@@ -15415,7 +15419,7 @@ function requireCompile() {
       return;
     return root.refs[ref2] = inlineOrCompile.call(this, _sch);
   }
-  compile$1.resolveRef = resolveRef;
+  compile$1.resolveRef = resolveRef2;
   function inlineOrCompile(sch) {
     if ((0, resolve_1.inlineRef)(sch.schema, this.opts.inlineRefs))
       return sch.schema;
@@ -20717,6 +20721,111 @@ class StdioServerTransport {
     });
   }
 }
+const ASSETS_DIR = fileURLToPath(new URL("./preview/", import.meta.url));
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".mjs": "application/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".map": "application/json; charset=utf-8"
+};
+function mimeFor(path) {
+  const dot = path.lastIndexOf(".");
+  if (dot === -1) return "application/octet-stream";
+  return MIME[path.slice(dot).toLowerCase()] ?? "application/octet-stream";
+}
+let server$1 = null;
+let serverUrl = null;
+let currentConfig = null;
+async function assetsAvailable() {
+  try {
+    const s = await stat(resolve$1(ASSETS_DIR, "index.html"));
+    return s.isFile();
+  } catch {
+    return false;
+  }
+}
+function injectConfig(html, config2) {
+  const json = JSON.stringify(config2).replace(/</g, "\\u003c");
+  const script = `<script>window.__SHWFED_PREVIEW_CONFIG__ = ${json};<\/script>`;
+  const marker = '<script type="module"';
+  const idx = html.indexOf(marker);
+  if (idx === -1) return html.replace("</head>", `${script}</head>`);
+  return `${html.slice(0, idx)}${script}${html.slice(idx)}`;
+}
+async function handleRequest(url) {
+  const cleanPath = url.split("?")[0].split("#")[0];
+  const route = cleanPath === "/" || cleanPath === "" ? "/index.html" : cleanPath;
+  const absolute = resolve$1(ASSETS_DIR, `.${route}`);
+  const root = ASSETS_DIR.endsWith(sep) ? ASSETS_DIR : `${ASSETS_DIR}${sep}`;
+  if (absolute !== ASSETS_DIR.replace(/\/$/, "") && !absolute.startsWith(root)) {
+    return { status: 403, headers: { "content-type": "text/plain" }, body: "forbidden" };
+  }
+  try {
+    const file = await readFile(absolute);
+    if (route === "/index.html") {
+      const injected = injectConfig(file.toString("utf8"), currentConfig);
+      return {
+        status: 200,
+        headers: { "content-type": MIME[".html"], "cache-control": "no-store" },
+        body: injected
+      };
+    }
+    return {
+      status: 200,
+      headers: { "content-type": mimeFor(route), "cache-control": "no-store" },
+      body: file
+    };
+  } catch {
+    return { status: 404, headers: { "content-type": "text/plain" }, body: "not found" };
+  }
+}
+async function startPreview(config2) {
+  if (!await assetsAvailable()) {
+    throw new Error(
+      `Preview assets not found at ${ASSETS_DIR}. The package's preview bundle is missing — reinstall @shwfed/config or run \`vite build --config vite.preview.config.ts\` if working from source.`
+    );
+  }
+  currentConfig = config2;
+  if (server$1 && serverUrl) return { url: serverUrl };
+  const next = createServer((req, res) => {
+    handleRequest(req.url ?? "/").then((result) => {
+      res.writeHead(result.status, result.headers);
+      res.end(result.body);
+    }).catch((err) => {
+      res.writeHead(500, { "content-type": "text/plain" });
+      res.end(err instanceof Error ? err.message : String(err));
+    });
+  });
+  await new Promise((resolve2, reject) => {
+    next.once("error", reject);
+    next.listen(0, "127.0.0.1", () => resolve2());
+  });
+  next.unref();
+  const addr = next.address();
+  const port = typeof addr === "object" && addr ? addr.port : 0;
+  server$1 = next;
+  serverUrl = `http://127.0.0.1:${port}/`;
+  return { url: serverUrl };
+}
+async function stopPreview() {
+  if (!server$1) return { stopped: false };
+  const closing = server$1;
+  server$1 = null;
+  serverUrl = null;
+  currentConfig = null;
+  await new Promise((resolve2) => closing.close(() => resolve2()));
+  return { stopped: true };
+}
 const isFunction$2 = (input) => typeof input === "function";
 const dual = function(arity, body) {
   if (typeof arity === "function") {
@@ -20854,8 +20963,8 @@ const isNotUndefined = (input) => input !== void 0;
 const isNotNull = (input) => input !== null;
 const isNever = (_) => false;
 const isRecordOrArray = (input) => typeof input === "object" && input !== null;
-const isObject$2 = (input) => isRecordOrArray(input) || isFunction$1(input);
-const hasProperty = /* @__PURE__ */ dual(2, (self2, property) => isObject$2(self2) && property in self2);
+const isObject$3 = (input) => isRecordOrArray(input) || isFunction$1(input);
+const hasProperty = /* @__PURE__ */ dual(2, (self2, property) => isObject$3(self2) && property in self2);
 const isTagged = /* @__PURE__ */ dual(2, (self2, tag2) => hasProperty(self2, "_tag") && self2["_tag"] === tag2);
 const isNullable = (input) => input === null || input === void 0;
 const isNotNullable = (input) => input !== null && input !== void 0;
@@ -21292,7 +21401,7 @@ function formatUnknown(input, options) {
       seen.add(v);
       return `${v.constructor.name}(${go2(Array.from(v), d)})`;
     }
-    if (isObject$2(v)) {
+    if (isObject$3(v)) {
       if (seen.has(v)) return CIRCULAR;
       seen.add(v);
       const keys2 = ownKeys(v);
@@ -21837,7 +21946,7 @@ const dedupeWith = /* @__PURE__ */ dual(2, (self2, isEquivalent) => {
   return [];
 });
 const dedupe = (self2) => dedupeWith(self2, equivalence());
-const join$2 = /* @__PURE__ */ dual(2, (self2, sep) => fromIterable$6(self2).join(sep));
+const join$2 = /* @__PURE__ */ dual(2, (self2, sep2) => fromIterable$6(self2).join(sep2));
 const getKeysForIndexSignature = (input, parameter) => {
   switch (parameter._tag) {
     case "StringKeyword":
@@ -26336,7 +26445,7 @@ const capture = (obj, span2) => {
   }
   return obj;
 };
-const die$2 = (defect) => isObject$2(defect) && !(spanSymbol in defect) ? withFiberRuntime$1((fiber) => failCause$5(die$3(capture(defect, currentSpanFromFiber(fiber))))) : failCause$5(die$3(defect));
+const die$2 = (defect) => isObject$3(defect) && !(spanSymbol in defect) ? withFiberRuntime$1((fiber) => failCause$5(die$3(capture(defect, currentSpanFromFiber(fiber))))) : failCause$5(die$3(defect));
 const dieMessage$1 = (message2) => failCauseSync$1(() => die$3(new RuntimeException$1(message2)));
 const either$1 = (self2) => matchEffect(self2, {
   onFailure: (e) => succeed$8(left(e)),
@@ -26346,7 +26455,7 @@ const exit$1 = (self2) => matchCause$1(self2, {
   onFailure: exitFailCause$1,
   onSuccess: exitSucceed$1
 });
-const fail$5 = (error2) => isObject$2(error2) && !(spanSymbol in error2) ? withFiberRuntime$1((fiber) => failCause$5(fail$6(capture(error2, currentSpanFromFiber(fiber))))) : failCause$5(fail$6(error2));
+const fail$5 = (error2) => isObject$3(error2) && !(spanSymbol in error2) ? withFiberRuntime$1((fiber) => failCause$5(fail$6(capture(error2, currentSpanFromFiber(fiber))))) : failCause$5(fail$6(error2));
 const failSync = (evaluate2) => flatMap$5(sync$2(evaluate2), fail$5);
 const failCause$5 = (cause) => {
   const effect2 = new EffectPrimitiveFailure(OP_FAILURE);
@@ -26481,7 +26590,7 @@ const sync$2 = (thunk) => {
   effect2.effect_instruction_i0 = thunk;
   return effect2;
 };
-const tap$1 = /* @__PURE__ */ dual((args2) => args2.length === 3 || args2.length === 2 && !(isObject$2(args2[1]) && "onlyEffect" in args2[1]), (self2, f) => flatMap$5(self2, (a) => {
+const tap$1 = /* @__PURE__ */ dual((args2) => args2.length === 3 || args2.length === 2 && !(isObject$3(args2[1]) && "onlyEffect" in args2[1]), (self2, f) => flatMap$5(self2, (a) => {
   const b = typeof f === "function" ? f(a) : f;
   if (isEffect$1(b)) {
     return as$1(b, a);
@@ -34947,7 +35056,7 @@ const go$1 = (ast, isDecoding) => {
     case "SymbolKeyword":
       return fromRefinement(ast, isSymbol);
     case "ObjectKeyword":
-      return fromRefinement(ast, isObject$2);
+      return fromRefinement(ast, isObject$3);
     case "Enums":
       return fromRefinement(ast, (u) => ast.enums.some(([_, value]) => value === u));
     case "TemplateLiteral": {
@@ -36414,7 +36523,7 @@ function compactUnion(members) {
   }
   return out;
 }
-const pick = /* @__PURE__ */ dual((args2) => isObject$2(args2[0]), (s, ...keys2) => {
+const pick = /* @__PURE__ */ dual((args2) => isObject$3(args2[0]), (s, ...keys2) => {
   const out = {};
   for (const k of keys2) {
     if (k in s) {
@@ -36423,7 +36532,7 @@ const pick = /* @__PURE__ */ dual((args2) => isObject$2(args2[0]), (s, ...keys2)
   }
   return out;
 });
-const omit = /* @__PURE__ */ dual((args2) => isObject$2(args2[0]), (s, ...keys2) => {
+const omit = /* @__PURE__ */ dual((args2) => isObject$3(args2[0]), (s, ...keys2) => {
   const out = {
     ...s
   };
@@ -36507,7 +36616,7 @@ const decodeUnknownEither = (schema2, options) => {
   const decodeUnknownEither2 = decodeUnknownEither$1(schema2, options);
   return (u, overrideOptions) => mapLeft(decodeUnknownEither2(u, overrideOptions), parseError$1);
 };
-const isSchema = (u) => hasProperty(u, TypeId$3) && isObject$2(u[TypeId$3]);
+const isSchema = (u) => hasProperty(u, TypeId$3) && isObject$3(u[TypeId$3]);
 function getDefaultLiteralAST(literals) {
   return isMembers(literals) ? Union$1.make(mapMembers(literals, (literal2) => new Literal$1(literal2))) : new Literal$1(literals[0]);
 }
@@ -40962,14 +41071,14 @@ function registerFunctions(registry2) {
       throw evaluationError("invalid_regular_expression", `Invalid regular expression: ${b}`);
     }
   });
-  functionOverload("string.split(string): list<string>", (s, sep) => s.split(sep));
-  functionOverload("string.split(string, number): list<string>", (s, sep, l) => {
+  functionOverload("string.split(string): list<string>", (s, sep2) => s.split(sep2));
+  functionOverload("string.split(string, number): list<string>", (s, sep2, l) => {
     const limit2 = toNum(l);
     if (limit2 === 0) return [];
-    const parts2 = s.split(sep);
+    const parts2 = s.split(sep2);
     if (limit2 < 0 || parts2.length <= limit2) return parts2;
     const limited = parts2.slice(0, limit2 - 1);
-    limited.push(parts2.slice(limit2 - 1).join(sep));
+    limited.push(parts2.slice(limit2 - 1).join(sep2));
     return limited;
   });
   functionOverload("list<string>.join(): string", (v) => {
@@ -40984,7 +41093,7 @@ function registerFunctions(registry2) {
     }
     return arr.join("");
   });
-  functionOverload("list<string>.join(string): string", (v, sep) => {
+  functionOverload("list<string>.join(string): string", (v, sep2) => {
     const arr = v;
     for (let i = 0; i < arr.length; i++) {
       if (typeof arr[i] !== "string") {
@@ -40994,7 +41103,7 @@ function registerFunctions(registry2) {
         );
       }
     }
-    return arr.join(sep);
+    return arr.join(sep2);
   });
   const textEncoder = new TextEncoder();
   const textDecoder = new TextDecoder("utf8");
@@ -81787,7 +81896,9 @@ function schema$H(_configure) {
     // This button's entire behaviour: the op-requests it bubbles up the
     // component tree on click. Stored on the button itself — there is no
     // host-level trigger field any more.
-    triggers: optional(Triggers)
+    triggers: optional(Triggers.annotations({
+      description: '按列表顺序执行；关闭弹窗类操作的 target 是承载该弹窗的按钮实例（如行操作里的"模态窗口"按钮），而非弹窗本身'
+    }))
   });
 }
 const __vite_glob_0_5$3 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -87711,7 +87822,7 @@ function _class(obj) {
 function isString(obj) {
   return _class(obj) === "[object String]";
 }
-function isObject$1(obj) {
+function isObject$2(obj) {
   return _class(obj) === "[object Object]";
 }
 function isRegExp(obj) {
@@ -87838,7 +87949,7 @@ function compile(self2) {
     }
     const compiled = { validate: null, link: null };
     self2.__compiled__[name] = compiled;
-    if (isObject$1(val)) {
+    if (isObject$2(val)) {
       if (isRegExp(val.validate)) {
         compiled.validate = createValidator(val.validate);
       } else if (isFunction(val.validate)) {
@@ -91215,7 +91326,7 @@ const __vite_glob_0_7 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.def
   toColumnDef: toColumnDef$5,
   type: type$c
 }, Symbol.toStringTag, { value: "Module" }));
-const isObject = (value) => {
+const isObject$1 = (value) => {
   const type2 = typeof value;
   return value !== null && (type2 === "object" || type2 === "function");
 };
@@ -91393,7 +91504,7 @@ function normalizePath(path) {
   return [];
 }
 function getProperty(object2, path, value) {
-  if (!isObject(object2) || typeof path !== "string" && !Array.isArray(path)) {
+  if (!isObject$1(object2) || typeof path !== "string" && !Array.isArray(path)) {
     return value === void 0 ? object2 : value;
   }
   const pathArray = normalizePath(path);
@@ -92971,17 +93082,163 @@ function validateConfig(input) {
 function getSchema() {
   return make$2(pageSchema);
 }
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const branchesOf = (node) => {
+  const list2 = node.anyOf ?? node.oneOf;
+  if (!Array.isArray(list2)) return void 0;
+  return list2.filter(isObject);
+};
+const typeEnumOf = (branch) => {
+  const props = isObject(branch.properties) ? branch.properties : void 0;
+  const typeProp = props && isObject(props.type) ? props.type : void 0;
+  const en = typeProp?.enum;
+  return Array.isArray(en) ? en.filter((v) => typeof v === "string") : [];
+};
+const compatDateOf = (branch) => {
+  const props = isObject(branch.properties) ? branch.properties : void 0;
+  const cd = props && isObject(props.compatibilityDate) ? props.compatibilityDate : void 0;
+  const en = cd?.enum;
+  if (Array.isArray(en) && typeof en[0] === "string") return en[0];
+  return void 0;
+};
+const resolveRef = (node, root) => {
+  if (!isObject(node) || typeof node.$ref !== "string") return node;
+  const ref2 = node.$ref;
+  if (!ref2.startsWith("#/")) return node;
+  const parts2 = ref2.slice(2).split("/");
+  let cur = root;
+  for (const raw of parts2) {
+    const key = raw.replace(/~1/g, "/").replace(/~0/g, "~");
+    if (!isObject(cur)) return node;
+    cur = cur[key];
+  }
+  return cur;
+};
+const parseSegment = (raw) => {
+  let s = raw;
+  const array2 = s.endsWith("[]");
+  if (array2) s = s.slice(0, -2);
+  const at = s.indexOf("@");
+  if (at >= 0) return { name: s.slice(0, at), pin: s.slice(at + 1), array: array2 };
+  return { name: s, array: array2 };
+};
+const describeOptions = (node) => {
+  const branches = branchesOf(node);
+  if (branches) {
+    const grouped = /* @__PURE__ */ new Map();
+    for (const b of branches) {
+      for (const t of typeEnumOf(b)) {
+        const dates = grouped.get(t) ?? [];
+        const d = compatDateOf(b);
+        if (d) dates.push(d);
+        grouped.set(t, dates);
+      }
+    }
+    if (grouped.size === 0) return "<unnamed union branches>";
+    return [...grouped.entries()].map(([t, ds]) => ds.length > 1 ? `${t} (${ds.sort().join(", ")})` : t).join(", ");
+  }
+  if (isObject(node.properties)) {
+    const keys2 = Object.keys(node.properties);
+    return keys2.length ? keys2.join(", ") : "<no properties>";
+  }
+  if (node.type === "array") return "[]";
+  return `<${node.type ?? "unknown"}>`;
+};
+function narrowSchema(root, path) {
+  const segments = path.split("/").map((s) => s.trim()).filter(Boolean);
+  let node = root;
+  const walked = [];
+  for (const raw of segments) {
+    node = resolveRef(node, root);
+    if (!isObject(node)) {
+      return {
+        ok: false,
+        error: `can't descend into non-object at '${walked.join("/")}'`,
+        atPath: walked.join("/"),
+        options: ""
+      };
+    }
+    const { name, pin, array: array2 } = parseSegment(raw);
+    const branches = branchesOf(node);
+    if (branches) {
+      const matches = branches.filter((b) => typeEnumOf(b).includes(name));
+      if (matches.length === 0) {
+        return {
+          ok: false,
+          error: `no '${name}' branch at '${walked.join("/") || "<root>"}'`,
+          atPath: walked.join("/"),
+          options: describeOptions(node)
+        };
+      }
+      let picked;
+      if (pin) {
+        const pinned = matches.find((b) => compatDateOf(b) === pin);
+        if (!pinned) {
+          const dates = matches.map(compatDateOf).filter(Boolean).join(", ");
+          return {
+            ok: false,
+            error: `no '${name}@${pin}' — available compatibilityDates: ${dates || "<none>"}`,
+            atPath: walked.join("/"),
+            options: dates
+          };
+        }
+        picked = pinned;
+      } else {
+        picked = matches.reduce((best, cur) => {
+          const a = compatDateOf(best) ?? "";
+          const b = compatDateOf(cur) ?? "";
+          return b > a ? cur : best;
+        });
+      }
+      const d = compatDateOf(picked);
+      walked.push(d ? `${name}@${d}` : name);
+      node = picked;
+    } else if (isObject(node.properties) && name in node.properties) {
+      walked.push(raw.replace(/\[\]$/, ""));
+      node = node.properties[name];
+    } else {
+      return {
+        ok: false,
+        error: `can't resolve '${name}' at '${walked.join("/") || "<root>"}'`,
+        atPath: walked.join("/"),
+        options: describeOptions(node)
+      };
+    }
+    if (array2) {
+      node = resolveRef(node, root);
+      if (!isObject(node) || node.type !== "array" || node.items === void 0) {
+        return {
+          ok: false,
+          error: `'${name}' is not an array`,
+          atPath: walked.join("/"),
+          options: ""
+        };
+      }
+      walked[walked.length - 1] = `${walked[walked.length - 1]}[]`;
+      node = node.items;
+    }
+  }
+  node = resolveRef(node, root);
+  return { ok: true, schema: node, resolvedPath: walked.join("/") };
+}
 const server = new McpServer({
   name: "@shwfed/config",
   version: "0.1.0"
 }, {
-  instructions: "Tools for authoring ShwfedConfig JSON. Use `get_schema` once to learn the shape, then iterate with `validate_config` until it returns `{ valid: true }`."
+  instructions: [
+    "Tools for authoring ShwfedConfig JSON. Use `get_schema` once to learn the shape, then iterate with `validate_config` until it returns `{ valid: true }`. Optionally call `preview_config` to render the result in the user's browser via a localhost-only playground; `stop_preview` shuts it down.",
+    "",
+    "Versioned types (`type` + `compatibilityDate`): the same `type` may appear at multiple `compatibilityDate`s with DIFFERENT contracts — they are not interchangeable. Rules:",
+    "1. When creating a new entry, ALWAYS pick the LATEST `compatibilityDate` available for that `type` in the schema. Do not select an older one because it looks simpler or familiar.",
+    "2. When editing an existing config that uses an older `compatibilityDate`, prefer migrating it to the latest version (translate its fields into the newer contract) and tell the user you did so, instead of preserving the old version silently.",
+    "3. Never mix versions of the same `type` across a single config when the latest covers the use case."
+  ].join("\n")
 });
 server.registerTool("validate_config", {
   title: "Validate ShwfedConfig JSON",
   description: "Validates a candidate ShwfedConfig JSON value against the Effect Schema. Returns `{ valid: true }` on success, or `{ valid: false, message, issues: [{ path, message, tag }] }` on failure. CEL expressions are accepted as strings without evaluation.",
   inputSchema: {
-    config: unknown().describe("The candidate ShwfedConfig JSON value")
+    config: looseObject({}).describe("The candidate ShwfedConfig JSON value")
   }
 }, async ({ config: config2 }) => {
   const result = validateConfig(config2);
@@ -92993,12 +93250,81 @@ server.registerTool("validate_config", {
 });
 server.registerTool("get_schema", {
   title: "Get ShwfedConfig JSON Schema",
-  description: "Returns the JSON Schema (draft-07) describing the full ShwfedConfig shape, including every registered page block, form field, action button, and table column type."
-}, async () => {
+  description: [
+    "Returns the JSON Schema (draft-07) describing the ShwfedConfig shape. The same `type` may be published at multiple `compatibilityDate` values with incompatible contracts; for new entries always select the latest `compatibilityDate` for that `type`, and prefer migrating older entries to it.",
+    "",
+    "Pass `path` to narrow into a sub-schema and avoid pulling the full schema into context. Path syntax (`/`-separated because type names contain dots):",
+    "  - `foo`           step into `properties.foo`",
+    "  - `foo[]`         step into an array's `items` after resolving `foo`",
+    "  - `<type>`        on a union, pick the branch whose `type` discriminator matches; if multiple `compatibilityDate` versions exist, picks the latest",
+    "  - `<type>@<date>` pin to a specific compatibilityDate",
+    "Example: `blocks[]/com.shwfed.block.table/columns[]/com.shwfed.table.column.switch`. On a bad segment the error lists the legal next steps."
+  ].join("\n"),
+  inputSchema: {
+    path: string$1().optional().describe("Optional `/`-separated path to narrow into. Omit to return the full schema.")
+  }
+}, async ({ path }) => {
   const schema2 = getSchema();
+  if (!path) {
+    return {
+      content: [{ type: "text", text: JSON.stringify(schema2, null, 2) }],
+      structuredContent: schema2
+    };
+  }
+  const result = narrowSchema(schema2, path);
+  if (!result.ok) {
+    const payload2 = { error: result.error, atPath: result.atPath, options: result.options };
+    return {
+      content: [{ type: "text", text: JSON.stringify(payload2, null, 2) }],
+      structuredContent: payload2,
+      isError: true
+    };
+  }
+  const payload = { path: result.resolvedPath, schema: result.schema };
   return {
-    content: [{ type: "text", text: JSON.stringify(schema2, null, 2) }],
-    structuredContent: schema2
+    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    structuredContent: payload
+  };
+});
+server.registerTool("preview_config", {
+  title: "Preview ShwfedConfig in browser",
+  description: "Boots a localhost-only preview server (127.0.0.1) that renders the given ShwfedConfig in a real browser using the package's shipped components. Returns the URL for the user to open. The config is validated first; invalid configs are rejected without starting the server. Subsequent calls hot-swap the rendered config and return the same URL — the user reloads the tab to see updates. The preview only knows about components shipped by this package; user-defined extensions in their host app are not visible here. CEL variables (e.g. `token`) are user-managed in the page itself — the agent never sees their values.",
+  inputSchema: {
+    config: looseObject({}).describe("The ShwfedConfig JSON value to render")
+  }
+}, async ({ config: config2 }) => {
+  const validation2 = validateConfig(config2);
+  if (!validation2.valid) {
+    return {
+      content: [{ type: "text", text: JSON.stringify(validation2, null, 2) }],
+      structuredContent: validation2,
+      isError: true
+    };
+  }
+  try {
+    const { url } = await startPreview(config2);
+    const payload = { url, hint: "Open the URL in a browser. Reload the tab after each preview_config call to pick up changes." };
+    return {
+      content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+      structuredContent: payload
+    };
+  } catch (err) {
+    const message2 = err instanceof Error ? err.message : String(err);
+    return {
+      content: [{ type: "text", text: message2 }],
+      structuredContent: { error: message2 },
+      isError: true
+    };
+  }
+});
+server.registerTool("stop_preview", {
+  title: "Stop the ShwfedConfig preview server",
+  description: "Shuts down the localhost preview server if one is running. Safe to call when nothing is running — returns `{ stopped: false }` in that case."
+}, async () => {
+  const result = await stopPreview();
+  return {
+    content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    structuredContent: result
   };
 });
 const transport = new StdioServerTransport();

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "shwfed",
   "configKey": "shwfed",
-  "version": "2.3.8",
+  "version": "2.3.10",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/preview/assets/config-2R4XkSGs.js

@@ -0,0 +1 @@
+import{d as y,b as R,ab as U,o as V,c as z,f as x,g as t,w as n,u as s,h as i,j as u,k as c,l as d,_ as p,ac as g,i as f,t as _,F as D,v as F,T as $,x as C,y as H,$ as S}from"./index-OUd02U3g.js";const L={class:"flex flex-col gap-3"},N={class:"grid grid-cols-2 gap-3"},B={class:"flex items-start gap-2"},M={class:"grid grid-cols-2 gap-3"},I=y({name:"ShwfedHttpDownloadActionConfig",__name:"config",props:{modelValue:{required:!0},modelModifiers:{}},emits:["update:modelValue"],setup(b){const l=R(b,"modelValue"),E=U(()=>{}),m=a=>C(E,a)??a,r=a=>H(E,a),j=["onSuccess","onWarning","onError","onInfo"],h=S({get:()=>l.value.template?.request??"",set:a=>{l.value={...l.value,template:{...l.value.template,request:a}}}}),w=S({get:()=>l.value.template?.download??"",set:a=>{const e=l.value.template??{request:""};if(a.length===0){const{download:o,...v}=e;l.value={...l.value,template:v}}else l.value={...l.value,template:{...e,download:a}}}});function q(a){const e={...l.value};a.length===0?delete e.messageExpression:e.messageExpression=a,l.value=e}function T(a){const e={...l.value};a.length===0?delete e.resultExpression:e.resultExpression=a,l.value=e}function k(a,e){const o={...l.value};e.length===0?Reflect.deleteProperty(o,a):o[a]=e,l.value=o}return(a,e)=>(V(),z("div",L,[x("div",N,[t(s(p),{orientation:"vertical"},{default:n(()=>[t(s(i),{class:"text-xs text-zinc-500"},{tooltip:n(()=>[t(s(c),{source:r("template")??"返回 `HttpRequest` 的 CEL 表达式；未配置「下载请求」时直接下载其响应",block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),default:n(()=>[e[2]||(e[2]=u(" 请求 ",-1))]),_:1}),t(s(d),{"model-value":h.value,multiline:"",placeholder:"例：http.get('https://api.example.com/files/123')","result-type":"HttpRequest",class:"min-h-16","onUpdate:modelValue":e[0]||(e[0]=o=>h.value=o)},null,8,["model-value"])]),_:1}),t(s(p),{orientation:"vertical"},{default:n(()=>[t(s(i),{class:"text-xs text-zinc-500"},{tooltip:n(()=>[t(s(c),{source:"可选的第二步：用第一步响应 `json` 中的凭据构造真正的下载请求，例如 `json.data.key`",block:"",class:"prose prose-sm prose-zinc"})]),default:n(()=>[e[3]||(e[3]=u(" 下载请求 ",-1))]),_:1}),t(s(d),{"model-value":w.value,multiline:"",placeholder:"例：http.get('https://api.example.com/download').query('key', json.data.key)","result-type":"HttpRequest","extra-vars":{json:s(g)},class:"min-h-16","onUpdate:modelValue":e[1]||(e[1]=o=>w.value=o)},null,8,["model-value","extra-vars"])]),_:1})]),x("div",B,[t(s(p),{orientation:"vertical",class:"flex-1 basis-0 min-w-0"},{default:n(()=>[t(s(i),{class:"text-xs text-zinc-500"},f({default:n(()=>[u(" "+_(m("messageExpression")),1)]),_:2},[r("messageExpression")?{name:"tooltip",fn:n(()=>[t(s(c),{source:r("messageExpression"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),t(s(d),{"model-value":l.value.messageExpression??"",placeholder:"例：string(json.message)","result-type":"string","extra-vars":{json:s(g)},"onUpdate:modelValue":q},null,8,["model-value","extra-vars"])]),_:1}),t(s(p),{orientation:"vertical",class:"flex-1 basis-0 min-w-0"},{default:n(()=>[t(s(i),{class:"text-xs text-zinc-500"},f({default:n(()=>[u(" "+_(m("resultExpression")),1)]),_:2},[r("resultExpression")?{name:"tooltip",fn:n(()=>[t(s(c),{source:r("resultExpression"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),t(s(d),{"model-value":l.value.resultExpression??"",placeholder:"例：json.code == 0 ? 'success' : 'error'","result-type":"string","extra-vars":{json:s(g)},"onUpdate:modelValue":T},null,8,["model-value","extra-vars"])]),_:1})]),x("div",M,[(V(),z(D,null,F(j,o=>t(s(p),{key:o,orientation:"vertical",class:"min-w-0"},{default:n(()=>[t(s(i),{class:"text-xs text-zinc-500"},f({default:n(()=>[u(" "+_(m(o)),1)]),_:2},[r(o)?{name:"tooltip",fn:n(()=>[t(s(c),{source:r(o),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),t($,{triggers:l.value[o]??[],"onUpdate:triggers":v=>k(o,v)},null,8,["triggers","onUpdate:triggers"])]),_:2},1024)),64))])]))}});export{I as default};

package/dist/preview/assets/config-BxzDT_57.js

@@ -0,0 +1 @@
+import{d as V,b as w,z as F,c as v,g as e,w as n,u as s,f as _,F as U,v as j,o as E,h as c,i as u,j as d,t as p,k as m,l as f,_ as x,T as k,x as N,y as R}from"./index-OUd02U3g.js";const D={class:"flex flex-col gap-3"},H={class:"flex items-start gap-2"},$={class:"grid grid-cols-2 gap-3"},B=V({name:"ShwfedHttpRequestActionConfig",__name:"config",props:{modelValue:{required:!0},modelModifiers:{}},emits:["update:modelValue"],setup(h){const o=w(h,"modelValue"),g=F(()=>{}),i=t=>N(g,t)??t,r=t=>R(g,t),S=["onSuccess","onWarning","onError","onInfo"];function T(t){const l={...o.value};t.length===0?delete l.messageExpression:l.messageExpression=t,o.value=l}function b(t){const l={...o.value};t.length===0?delete l.resultExpression:l.resultExpression=t,o.value=l}function y(t,l){const a={...o.value};l.length===0?Reflect.deleteProperty(a,t):a[t]=l,o.value=a}return(t,l)=>(E(),v("div",D,[e(s(x),{orientation:"vertical"},{default:n(()=>[e(s(c),{class:"text-xs text-zinc-500"},u({default:n(()=>[d(" "+p(i("expression")),1)]),_:2},[r("expression")?{name:"tooltip",fn:n(()=>[e(s(m),{source:r("expression"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(s(f),{"model-value":o.value.expression,multiline:"",placeholder:"例：http.post('/api/foo').body({ id: row.id })","result-type":"HttpRequest",class:"min-h-16","onUpdate:modelValue":l[0]||(l[0]=a=>o.value={...o.value,expression:a})},null,8,["model-value"])]),_:1}),_("div",H,[e(s(x),{orientation:"vertical",class:"flex-1 basis-0 min-w-0"},{default:n(()=>[e(s(c),{class:"text-xs text-zinc-500"},u({default:n(()=>[d(" "+p(i("messageExpression")),1)]),_:2},[r("messageExpression")?{name:"tooltip",fn:n(()=>[e(s(m),{source:r("messageExpression"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(s(f),{"model-value":o.value.messageExpression??"",placeholder:"例：string(json.message)","result-type":"string","extra-vars":{json:{type:"dyn",label:"HTTP 响应体（已解析 JSON）"}},"onUpdate:modelValue":T},null,8,["model-value"])]),_:1}),e(s(x),{orientation:"vertical",class:"flex-1 basis-0 min-w-0"},{default:n(()=>[e(s(c),{class:"text-xs text-zinc-500"},u({default:n(()=>[d(" "+p(i("resultExpression")),1)]),_:2},[r("resultExpression")?{name:"tooltip",fn:n(()=>[e(s(m),{source:r("resultExpression"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(s(f),{"model-value":o.value.resultExpression??"",placeholder:"例：json.code == 0 ? 'success' : 'error'","result-type":"string","extra-vars":{json:{type:"dyn",label:"HTTP 响应体（已解析 JSON）"}},"onUpdate:modelValue":b},null,8,["model-value"])]),_:1})]),_("div",$,[(E(),v(U,null,j(S,a=>e(s(x),{key:a,orientation:"vertical",class:"min-w-0"},{default:n(()=>[e(s(c),{class:"text-xs text-zinc-500"},u({default:n(()=>[d(" "+p(i(a)),1)]),_:2},[r(a)?{name:"tooltip",fn:n(()=>[e(s(m),{source:r(a),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(k,{triggers:o.value[a]??[],"onUpdate:triggers":z=>y(a,z)},null,8,["triggers","onUpdate:triggers"])]),_:2},1024)),64))])]))}});export{B as default};

package/dist/preview/assets/config-CyScbxXy.js

@@ -0,0 +1 @@
+import{d as _,b as y,B as x,A as b,c,f as i,g as n,w as o,u as a,o as l,C as v,I as u,D as g,E as D,F as h,v as w,e as B,G as C,t as p,H as S}from"./index-OUd02U3g.js";const $={class:"flex flex-col gap-3"},k={class:"flex-1"},E={class:"ml-auto text-xs tabular-nums text-zinc-400"},I=_({name:"ShwfedPrototypeActionConfig",__name:"config",props:{modelValue:{required:!0},modelModifiers:{}},emits:["update:modelValue"],setup(m){const r=y(m,"modelValue"),f=(()=>{const s=new Map;for(const e of x){if(e.type===b||e.deprecated)continue;const t=s.get(e.type);(!t||e.compatibilityDate>t.compatibilityDate)&&s.set(e.type,{type:e.type,compatibilityDate:e.compatibilityDate,name:e.metadata.name,icon:e.metadata.icon})}return[...s.values()].sort((e,t)=>e.name.localeCompare(t.name,"zh"))})();function d(s,e){r.value={type:s,compatibilityDate:e}}return(s,e)=>(l(),c("div",$,[e[0]||(e[0]=i("p",{class:"text-xs text-zinc-500"}," 原型按钮点击后无任何副作用，用于占位。选择下方任意类型可将其转换为正式按钮 —— 此转换仅能进行一次。 ",-1)),n(a(S),null,{default:o(()=>[n(a(v),{align:"inline-start"},{default:o(()=>[n(a(u),{icon:"fluent:arrow-swap-20-regular"})]),_:1}),n(a(g),null,{default:o(()=>[n(a(D),null,{default:o(()=>[(l(!0),c(h,null,w(a(f),t=>(l(),B(a(C),{key:t.type,value:t.type,onSelect:V=>d(t.type,t.compatibilityDate)},{default:o(()=>[n(a(u),{icon:t.icon,class:"size-4 shrink-0"},null,8,["icon"]),i("span",k,p(t.name),1),i("span",E,p(t.compatibilityDate),1)]),_:2},1032,["value","onSelect"]))),128))]),_:1})]),_:1})]),_:1})]))}});export{I as default};

package/dist/preview/assets/config-HdWYFZ09.js

@@ -0,0 +1 @@
+import{d as x,b as k,aG as g,c as S,g as e,w as o,u as t,o as V,h as r,i as m,j as d,t as f,k as p,a5 as w,_,m as $,x as h,y}from"./index-OUd02U3g.js";const z={class:"flex flex-col gap-4"},C=x({name:"ShwfedMarkdownItemConfig",__name:"config",props:{modelValue:{required:!0},modelModifiers:{}},emits:["update:modelValue"],setup(v){const a=k(v,"modelValue"),c=g(),u=l=>h(c,l)??l,s=l=>y(c,l);return(l,n)=>(V(),S("div",z,[e(t(_),{orientation:"vertical"},{default:o(()=>[e(t(r),{class:"text-xs text-zinc-500"},m({default:o(()=>[d(" "+f(u("name")),1)]),_:2},[s("name")?{name:"tooltip",fn:o(()=>[e(t(p),{source:s("name"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(t(w),{"model-value":a.value.name,placeholder:"仅用于编辑器内识别","onUpdate:modelValue":n[0]||(n[0]=i=>a.value={...a.value,name:String(i)})},null,8,["model-value"])]),_:1}),e(t(_),{orientation:"vertical"},{default:o(()=>[e(t(r),{class:"text-xs text-zinc-500"},m({default:o(()=>[d(" "+f(u("content")),1)]),_:2},[s("content")?{name:"tooltip",fn:o(()=>[e(t(p),{source:s("content"),block:"",class:"prose prose-sm prose-zinc"},null,8,["source"])]),key:"0"}:void 0]),1024),e(t($),{markdown:"",multiline:"","model-value":a.value.content,"onUpdate:modelValue":n[1]||(n[1]=i=>a.value={...a.value,content:i})},null,8,["model-value"])]),_:1})]))}});export{C as default};