@pixerate/editor 0.222.2 → 0.223.0

package/dist/{chunk-GI3AVES4.js → chunk-SVHXD2VH.js}

@@ -1,6 +1,6 @@
 import {
   parseSkillFrontmatter
-} from "./chunk-XZB3TJ6K.js";
+} from "./chunk-SAN4SBBS.js";
 import {
   readingTime
 } from "./chunk-EHTX34RE.js";
@@ -12,6 +12,113 @@ import {
   stripPrototypeKeys
 } from "./chunk-HF5QZS7Z.js";
 
+// src/tools/skill-evals.ts
+function listSkillEvals(files) {
+  const out = [];
+  for (const [raw, text] of Object.entries(files)) {
+    const path = raw.replace(/\\/g, "/").replace(/^\.?\//, "");
+    const match = /^([^/]+)\/evals\/[^/]+\.json$/.exec(path);
+    if (match) out.push({ skill: match[1], path, eval: JSON.parse(text) });
+  }
+  return out.sort((a, b) => a.path.localeCompare(b.path));
+}
+function imageEvalFixturePixels(f) {
+  const { width: W, height: H } = f;
+  const data = new Uint8ClampedArray(W * H * 4);
+  for (let y = 0; y < H; y++) {
+    for (let x = 0; x < W; x++) {
+      let rgb = f.background;
+      for (const s of f.shapes) {
+        const inside = s.shape === "rect" ? x >= s.x && x < s.x + s.width && y >= s.y && y < s.y + s.height : ((x + 0.5 - s.x - s.width / 2) / (s.width / 2)) ** 2 + ((y + 0.5 - s.y - s.height / 2) / (s.height / 2)) ** 2 <= 1;
+        if (inside) rgb = s.color;
+      }
+      data.set([...rgb, 255], (y * W + x) * 4);
+    }
+  }
+  return { width: W, height: H, data };
+}
+async function callEvalTool(callTool, { tool, args = {} }) {
+  const res = await callTool(tool, await resolve(callTool, args));
+  if (res.isError) throw new Error(`${tool}: ${res.content?.[0]?.text ?? "tool error"}`);
+  return res.structuredContent;
+}
+async function resolve(callTool, v) {
+  if (Array.isArray(v)) return Promise.all(v.map((x) => resolve(callTool, x)));
+  if (!v || typeof v !== "object") return v;
+  if ("$read" in v) {
+    const { $read, args, path } = v;
+    return at(await callEvalTool(callTool, { tool: $read, args }), path);
+  }
+  const out = {};
+  for (const [k, x] of Object.entries(v)) out[k] = await resolve(callTool, x);
+  return out;
+}
+function at(value, path) {
+  const [key, ...rest] = path.split(".");
+  if (value == null || key === void 0) return value;
+  if (key === "*") return Array.isArray(value) ? rest.length ? value.map((x) => at(x, rest.join("."))) : value : void 0;
+  const next = Array.isArray(value) && /^-\d+$/.test(key) ? value[value.length + Number(key)] : value[key];
+  return rest.length ? at(next, rest.join(".")) : next;
+}
+var isEmpty = (v) => v === null || v === void 0 || v === "" || Array.isArray(v) && v.every(isEmpty);
+function matchesEvalExpectation(actual, expected) {
+  const matches = matchesEvalExpectation;
+  if (expected === null || typeof expected !== "object") return Object.is(actual, expected);
+  if (Array.isArray(expected)) return Array.isArray(actual) && actual.length === expected.length && expected.every((e, i) => matches(actual[i], e));
+  const ops = Object.entries(expected);
+  return ops.every(([key, want]) => {
+    const list = Array.isArray(actual) ? actual : null;
+    switch (key) {
+      case "$min":
+        return typeof actual === "number" && actual >= want;
+      case "$max":
+        return typeof actual === "number" && actual <= want;
+      case "$type":
+        return (actual === null ? "null" : Array.isArray(actual) ? "array" : typeof actual) === want;
+      case "$match": {
+        const [pattern, flags] = Array.isArray(want) ? want : [want, ""];
+        return typeof actual === "string" && new RegExp(pattern, flags).test(actual);
+      }
+      case "$in":
+        return want.some((w) => matches(actual, w));
+      case "$not":
+        return !matches(actual, want);
+      case "$every":
+        return !!list && list.every((a) => matches(a, want));
+      case "$some":
+        return !!list && list.some((a) => matches(a, want));
+      case "$length":
+        return !!list && matches(list.length, want);
+      case "$unique":
+        return !!list && new Set(list.map((a) => JSON.stringify(a))).size === list.length;
+      case "$distinct":
+        return !!list && matches([...new Set(list.map((a) => JSON.stringify(a)))].map((a) => JSON.parse(a)), want);
+      case "$sum":
+        return !!list && list.every((a) => typeof a === "number") && Math.abs(list.reduce((s, a) => s + a, 0) - want) < 1e-6;
+      case "$column": {
+        const [index, m] = want;
+        return !!list && matches(list.map((row) => Array.isArray(row) ? row[index] : void 0), m);
+      }
+      case "$expr":
+        return !!new Function("v", `return (${want});`)(actual);
+      case "$nonEmpty":
+        return !!list && matches(list.filter((a) => !isEmpty(a)), want);
+      default:
+        if (key.startsWith("$")) throw new Error(`Unknown eval operator ${key}.`);
+        return actual !== null && typeof actual === "object" && matches(actual[key], want);
+    }
+  });
+}
+async function failedEvalChecks(callTool, checks) {
+  const failed = [];
+  for (const check of checks) {
+    const result = await callEvalTool(callTool, check).catch((e) => e);
+    if (result instanceof Error) failed.push(`${check.why} (${result.message})`);
+    else if (!matchesEvalExpectation(result, check.expect)) failed.push(`${check.why} (${check.tool} \u2192 ${JSON.stringify(result).slice(0, 400)})`);
+  }
+  return failed;
+}
+
 // src/tools/script.ts
 function toolResultValue(result) {
   if (result.structuredContent) return result.structuredContent;
@@ -27,7 +134,7 @@ function toolResultError(result) {
   const text = result.content.find((b) => b.type === "text");
   return text?.text ?? "The tool failed.";
 }
-var realWait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var realWait = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
 async function runToolScript(source, script, options = {}) {
   const control = options.control ?? { speed: 1, stopped: false };
   const wait = options.wait ?? realWait;
@@ -291,7 +398,7 @@ function createStyleResolver(options) {
     skills.sort((a, b) => a.layerIndex - b.layerIndex || a.info.order - b.info.order || a.info.name.localeCompare(b.info.name));
     return { skills, issues };
   }
-  async function resolve(domainId) {
+  async function resolve2(domainId) {
     requireDomain(domainId);
     const { skills, issues: loadIssues } = await load();
     const issues = [...loadIssues];
@@ -323,7 +430,7 @@ function createStyleResolver(options) {
       const { skills } = await load();
       return skills.filter((s) => opts.domain === void 0 || s.applies.has(opts.domain)).map((s) => s.info);
     },
-    resolve,
+    resolve: resolve2,
     async readFile(name, file) {
       const layer = await winnerLayer(name);
       return layer ? layer.store.read(name, file) : void 0;
@@ -334,7 +441,7 @@ function createStyleResolver(options) {
     },
     async check(domainId, state) {
       const domain = requireDomain(domainId);
-      const style = await resolve(domainId);
+      const style = await resolve2(domainId);
       return { ...runStyleChecks(domain, state, style), style };
     },
     subscribe(listener) {
@@ -472,6 +579,11 @@ function createStyleToolProvider(styles, options = {}) {
 }
 
 export {
+  listSkillEvals,
+  imageEvalFixturePixels,
+  callEvalTool,
+  matchesEvalExpectation,
+  failedEvalChecks,
   toolResultValue,
   toolResultError,
   runToolScript,

package/dist/{chunk-AMX23CSN.cjs → chunk-Z7BVK32C.cjs}

@@ -8,13 +8,22 @@ var _chunk2BSBFBOAcjs = require('./chunk-2BSBFBOA.cjs');
 // src/tools/skills.ts
 function parseSkillFrontmatter(markdown) {
   const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(markdown);
-  if (!match) return { body: markdown };
+  if (!match) return { metadata: {}, body: markdown };
   const fields = {};
+  const metadata = {};
+  const unquote = (value) => value.trim().replace(/^(['"])([\s\S]*)\1$/, "$2");
+  let inMetadata = false;
   for (const line of match[1].split(/\r?\n/)) {
     const kv = /^([A-Za-z_-]+):\s*(.*)$/.exec(line);
-    if (kv) fields[kv[1]] = kv[2].trim().replace(/^(['"])([\s\S]*)\1$/, "$2");
+    if (kv) {
+      fields[kv[1]] = unquote(kv[2]);
+      inMetadata = kv[1] === "metadata" && kv[2].trim() === "";
+      continue;
+    }
+    const nested = inMetadata ? /^\s+([A-Za-z_-]+):\s*(.*)$/.exec(line) : null;
+    if (nested) metadata[nested[1]] = unquote(nested[2]);
   }
-  return { name: fields.name, description: fields.description, body: markdown.slice(match[0].length) };
+  return { name: fields.name, description: fields.description, metadata, body: markdown.slice(match[0].length) };
 }
 var normalize = (path) => path.replace(/\\/g, "/").replace(/^\.?\//, "");
 function listSkills(files) {
@@ -23,8 +32,15 @@ function listSkills(files) {
   for (const path of paths) {
     const [dir, ...rest] = path.split("/");
     if (rest.join("/") !== "SKILL.md") continue;
-    const { description } = parseSkillFrontmatter(_nullishCoalesce(_nullishCoalesce(files[path], () => ( files[`./${path}`])), () => ( "")));
-    skills.set(dir, { name: dir, description: _nullishCoalesce(description, () => ( "")), references: [] });
+    const { description, metadata } = parseSkillFrontmatter(_nullishCoalesce(_nullishCoalesce(files[path], () => ( files[`./${path}`])), () => ( "")));
+    const workflow = metadata.kind === "workflow";
+    skills.set(dir, {
+      name: dir,
+      description: _nullishCoalesce(description, () => ( "")),
+      references: [],
+      kind: workflow ? "workflow" : "reference",
+      ...workflow && metadata.reference ? { reference: metadata.reference } : {}
+    });
   }
   for (const path of paths) {
     const [dir, ...rest] = path.split("/");
@@ -259,11 +275,12 @@ var ToolRegistryView = (_class = class {
       const style = await discovery.styles.resolve(domain);
       return style.skills.length ? { domain, skills: style.skills.length, layers: [...new Set(style.skills.map((s) => s.layer))] } : void 0;
     };
+    const workflowsOf = (set) => set.skill ? skills.filter((s) => s.kind === "workflow" && s.reference === set.skill).map((s) => s.name) : [];
     const tools = [
       {
         name: "list_toolsets",
         title: "List toolsets",
-        description: "Lists the groups of editor tools available here (one per open editor or feature): name, title, what it covers, its agent skill, how many tools it has and whether they are in your tool list (`enabled`: all, some or none). Start here, then call search_tools or enable_tools.",
+        description: "Lists the groups of editor tools available here (one per open editor or feature): name, title, what it covers, its agent skill, its workflow skills (`workflows`: skills for whole jobs done with its tools, such as a cutout or a photo correction), how many tools it has and whether they are in your tool list (`enabled`: all, some or none). Start here, then call search_tools or enable_tools.",
         annotations: READ_ONLY,
         inputSchema: { type: "object", properties: {}, additionalProperties: false },
         handler: async () => {
@@ -275,6 +292,7 @@ var ToolRegistryView = (_class = class {
               ...set.title ? { title: set.title } : {},
               ...set.description ? { description: set.description } : {},
               ...set.skill ? { skill: set.skill } : {},
+              ...workflowsOf(set).length ? { workflows: workflowsOf(set) } : {},
               tools: set.tools.length,
               enabled: enabledState(set),
               ...styles[i] ? { style: styles[i] } : {}
@@ -344,7 +362,7 @@ var ToolRegistryView = (_class = class {
       tools.push({
         name: "get_skill",
         title: "Get skill",
-        description: "Reads an agent skill: the guide to a toolset's tools (when to use each, the working method, pitfalls). Read the skill a toolset names in list_toolsets before working with it. Returns markdown; pass `file` for one of its reference files.",
+        description: "Reads an agent skill: the guide to a toolset's tools (when to use each, the working method, pitfalls). Read the skill a toolset names in list_toolsets before working with it. When the task is one of the jobs in its `workflows` (or in the skill's own Workflow skills section), read that workflow skill too: it has the steps in order and the checks between them. Returns markdown; pass `file` for one of its reference files.",
         annotations: READ_ONLY,
         inputSchema: {
           type: "object",

package/dist/image-editor/index.cjs

@@ -13513,7 +13513,7 @@ var DEPTH_MASK_CONTROLS = [
 // src/image-editor/playback.ts
 var IMAGE_PLAYBACK_KIND = "layer";
 var PAINT = /^(paint_stroke|clone_stamp|heal_brush|spot_heal|dodge|burn|sponge|smudge|blur_stroke|sharpen_stroke|history_brush|set_clone_source|set_clone_transform|fill_pixels|clear_pixels|set_paint|set_retouch_options|load_mixer_brush|clean_mixer_brush)$/;
-var SELECT = /^(make_work_path|add_path|set_path_geometry|rename_path|duplicate_path|delete_path|fill_path|stroke_path|select_region|select_subject|select_by_color|select_all|deselect|invert_selection|select_rect|select_ellipse|select_polygon|quick_select|select_object|select_focus_area|select_sky|select_line|magic_wand|grow_selection|select_similar|reselect|select_layer_transparency|select_color_range|load_selection_from_image|load_selection_from_mask|set_selection_display|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy|stroke_selection|content_aware_fill|copy_pixels|cut_pixels|paste_pixels|save_selection|load_selection_from_channel|set_channel_properties|duplicate_channel|delete_channel|load_channel_from_image|set_quick_mask|path_to_selection|select_text_shape)$/;
+var SELECT = /^(make_work_path|add_path|set_path_geometry|rename_path|duplicate_path|delete_path|fill_path|stroke_path|select_region|select_subject|select_by_color|select_all|deselect|invert_selection|select_rect|select_ellipse|select_polygon|quick_select|select_object|select_focus_area|select_sky|select_line|magic_wand|grow_selection|select_similar|reselect|select_layer_transparency|select_color_range|load_selection_from_image|load_selection_from_mask|set_selection_display|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy|stroke_selection|content_aware_fill|copy_pixels|cut_pixels|paste_pixels|save_selection|load_selection_from_channel|set_channel_properties|duplicate_channel|delete_channel|load_channel_from_image|set_quick_mask|path_to_selection|select_text_shape|compare_selections|edit_selection_step|insert_selection_step|remove_selection_step|freeze_selection|separate_subject)$/;
 var ANNOTATE = /^(add_shape_layer|update_shape|add_shape_component|set_shape_component|remove_shape_component|merge_shape_components|add_text_layer|set_text|set_text_style|set_paragraph_style|set_text_frame|set_text_orientation|convert_text_to_shape)$/;
 var CROP = /^(set_crop|crop_to_selection|reset_crop|set_rotation|flip_image|transform_layer|warp_layer|flip_layer|offset_layer)$/;
 var ADJUST = /^(set_adjustments|add_adjustment_layer|update_adjustment_layer|remove_adjustment_layer|move_adjustment_layer)$/;
@@ -13523,7 +13523,7 @@ function imagePlaybackPanel(tool) {
   if (SELECT.test(tool)) return "select";
   if (ANNOTATE.test(tool)) return "annotate";
   if (CROP.test(tool)) return "crop";
-  if (/layer|effect|filter|smart|group|mask|merge|flatten|profile|colors|proof|light/.test(tool)) return "layers";
+  if (/layer|effect|filter|smart|group|mask|merge|flatten|profile|colors|proof|light|^set_edge_/.test(tool)) return "layers";
   return null;
 }
 function createImagePlaybackLocator(controller) {
@@ -20878,12 +20878,12 @@ async function addLayerOfKind(controller, id, init) {
   throw new Error(`Unknown layer kind "${id}"`);
 }
 function layerPanels(layer, options = {}) {
-  if (!layer) {
-    return [
-      { id: "canvas-size", title: "Composition Size" },
-      { id: "selection", title: "Selection" }
-    ];
-  }
+  const documentPanels = [
+    { id: "selection", title: "Selection" },
+    { id: "channels", title: "Channels" },
+    { id: "paths", title: "Paths" }
+  ];
+  if (!layer) return [{ id: "canvas-size", title: "Composition Size" }, ...documentPanels];
   const panels = [{ id: "properties", title: "Layer Properties" }];
   const effects = () => {
     if (options.effects) panels.push({ id: "provider-effects", title: "Effects" });
@@ -20902,10 +20902,10 @@ function layerPanels(layer, options = {}) {
   } else if (layer.type === "smart" || layer.type === "group") {
     effects();
   }
-  if (layer.mask) {
-    panels.push({ id: "mask", title: "Mask Options" });
+  if (layer.mask || layer.vectorMask) {
+    panels.push({ id: "mask", title: "Mask & Edges" });
   }
-  panels.push({ id: "selection", title: "Selection" });
+  panels.push(...documentPanels);
   return panels;
 }
 
@@ -21975,6 +21975,7 @@ function imageToolPanel(tool) {
   if (tool === "move") return null;
   if (isPaintTool(tool)) return "paint";
   if (tool === "select") return "selection";
+  if (tool === "path-pen" || tool === "path-select" || tool === "direct-select") return "paths";
   if (tool === "crop") return "canvas-size";
   if (tool === "shape" || tool === "type") return tool;
   return null;

package/dist/image-editor/index.js

@@ -13513,7 +13513,7 @@ var DEPTH_MASK_CONTROLS = [
 // src/image-editor/playback.ts
 var IMAGE_PLAYBACK_KIND = "layer";
 var PAINT = /^(paint_stroke|clone_stamp|heal_brush|spot_heal|dodge|burn|sponge|smudge|blur_stroke|sharpen_stroke|history_brush|set_clone_source|set_clone_transform|fill_pixels|clear_pixels|set_paint|set_retouch_options|load_mixer_brush|clean_mixer_brush)$/;
-var SELECT = /^(make_work_path|add_path|set_path_geometry|rename_path|duplicate_path|delete_path|fill_path|stroke_path|select_region|select_subject|select_by_color|select_all|deselect|invert_selection|select_rect|select_ellipse|select_polygon|quick_select|select_object|select_focus_area|select_sky|select_line|magic_wand|grow_selection|select_similar|reselect|select_layer_transparency|select_color_range|load_selection_from_image|load_selection_from_mask|set_selection_display|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy|stroke_selection|content_aware_fill|copy_pixels|cut_pixels|paste_pixels|save_selection|load_selection_from_channel|set_channel_properties|duplicate_channel|delete_channel|load_channel_from_image|set_quick_mask|path_to_selection|select_text_shape)$/;
+var SELECT = /^(make_work_path|add_path|set_path_geometry|rename_path|duplicate_path|delete_path|fill_path|stroke_path|select_region|select_subject|select_by_color|select_all|deselect|invert_selection|select_rect|select_ellipse|select_polygon|quick_select|select_object|select_focus_area|select_sky|select_line|magic_wand|grow_selection|select_similar|reselect|select_layer_transparency|select_color_range|load_selection_from_image|load_selection_from_mask|set_selection_display|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy|stroke_selection|content_aware_fill|copy_pixels|cut_pixels|paste_pixels|save_selection|load_selection_from_channel|set_channel_properties|duplicate_channel|delete_channel|load_channel_from_image|set_quick_mask|path_to_selection|select_text_shape|compare_selections|edit_selection_step|insert_selection_step|remove_selection_step|freeze_selection|separate_subject)$/;
 var ANNOTATE = /^(add_shape_layer|update_shape|add_shape_component|set_shape_component|remove_shape_component|merge_shape_components|add_text_layer|set_text|set_text_style|set_paragraph_style|set_text_frame|set_text_orientation|convert_text_to_shape)$/;
 var CROP = /^(set_crop|crop_to_selection|reset_crop|set_rotation|flip_image|transform_layer|warp_layer|flip_layer|offset_layer)$/;
 var ADJUST = /^(set_adjustments|add_adjustment_layer|update_adjustment_layer|remove_adjustment_layer|move_adjustment_layer)$/;
@@ -13523,7 +13523,7 @@ function imagePlaybackPanel(tool) {
   if (SELECT.test(tool)) return "select";
   if (ANNOTATE.test(tool)) return "annotate";
   if (CROP.test(tool)) return "crop";
-  if (/layer|effect|filter|smart|group|mask|merge|flatten|profile|colors|proof|light/.test(tool)) return "layers";
+  if (/layer|effect|filter|smart|group|mask|merge|flatten|profile|colors|proof|light|^set_edge_/.test(tool)) return "layers";
   return null;
 }
 function createImagePlaybackLocator(controller) {
@@ -20878,12 +20878,12 @@ async function addLayerOfKind(controller, id, init) {
   throw new Error(`Unknown layer kind "${id}"`);
 }
 function layerPanels(layer, options = {}) {
-  if (!layer) {
-    return [
-      { id: "canvas-size", title: "Composition Size" },
-      { id: "selection", title: "Selection" }
-    ];
-  }
+  const documentPanels = [
+    { id: "selection", title: "Selection" },
+    { id: "channels", title: "Channels" },
+    { id: "paths", title: "Paths" }
+  ];
+  if (!layer) return [{ id: "canvas-size", title: "Composition Size" }, ...documentPanels];
   const panels = [{ id: "properties", title: "Layer Properties" }];
   const effects = () => {
     if (options.effects) panels.push({ id: "provider-effects", title: "Effects" });
@@ -20902,10 +20902,10 @@ function layerPanels(layer, options = {}) {
   } else if (layer.type === "smart" || layer.type === "group") {
     effects();
   }
-  if (layer.mask) {
-    panels.push({ id: "mask", title: "Mask Options" });
+  if (layer.mask || layer.vectorMask) {
+    panels.push({ id: "mask", title: "Mask & Edges" });
   }
-  panels.push({ id: "selection", title: "Selection" });
+  panels.push(...documentPanels);
   return panels;
 }
 
@@ -21975,6 +21975,7 @@ function imageToolPanel(tool) {
   if (tool === "move") return null;
   if (isPaintTool(tool)) return "paint";
   if (tool === "select") return "selection";
+  if (tool === "path-pen" || tool === "path-select" || tool === "direct-select") return "paths";
   if (tool === "crop") return "canvas-size";
   if (tool === "shape" || tool === "type") return tool;
   return null;

package/dist/image-editor/layers/panel.d.cts

@@ -156,7 +156,11 @@ export interface LayerPanelsOptions {
  *
  * `properties` ("Layer Properties") is first for every layer and includes the layer's Layer Style
  * (drop shadow, stroke, glow…: `layerEffectsPanel`) for layers that can take one, with or without a
- * provider. There is no separate `effects` (Layer Effects) or `smart-filters` panel. `selection`
- * is last for every layer, and with no active layer follows `canvas-size`.
+ * provider. There is no separate `effects` (Layer Effects) or `smart-filters` panel. `mask`
+ * ("Mask & Edges": a vector mask's per-segment edges and the layer's edge colour) shows for a layer
+ * with a painted or vector mask. The document's panels end the list for every layer, and with no
+ * active layer follow `canvas-size`: `selection` (the selection tools and Refine Edge), `channels`
+ * and `paths`. A host that lays out its own sidebar from these gets every panel the editor's own
+ * `ImageEditor` shows.
  */
 export declare function layerPanels(layer: ImageLayer | null, options?: LayerPanelsOptions): LayerPanelDescriptor[];

package/dist/image-editor/layers/panel.d.ts

@@ -156,7 +156,11 @@ export interface LayerPanelsOptions {
  *
  * `properties` ("Layer Properties") is first for every layer and includes the layer's Layer Style
  * (drop shadow, stroke, glow…: `layerEffectsPanel`) for layers that can take one, with or without a
- * provider. There is no separate `effects` (Layer Effects) or `smart-filters` panel. `selection`
- * is last for every layer, and with no active layer follows `canvas-size`.
+ * provider. There is no separate `effects` (Layer Effects) or `smart-filters` panel. `mask`
+ * ("Mask & Edges": a vector mask's per-segment edges and the layer's edge colour) shows for a layer
+ * with a painted or vector mask. The document's panels end the list for every layer, and with no
+ * active layer follow `canvas-size`: `selection` (the selection tools and Refine Edge), `channels`
+ * and `paths`. A host that lays out its own sidebar from these gets every panel the editor's own
+ * `ImageEditor` shows.
  */
 export declare function layerPanels(layer: ImageLayer | null, options?: LayerPanelsOptions): LayerPanelDescriptor[];

package/dist/tools/index.cjs

@@ -8,12 +8,12 @@
 
 
 
-var _chunkU4QN36YTcjs = require('../chunk-U4QN36YT.cjs');
 
 
 
 
 
+var _chunkBDT2IYXKcjs = require('../chunk-BDT2IYXK.cjs');
 
 
 
@@ -34,7 +34,12 @@ var _chunkU4QN36YTcjs = require('../chunk-U4QN36YT.cjs');
 
 
 
-var _chunkAMX23CSNcjs = require('../chunk-AMX23CSN.cjs');
+
+
+
+
+
+var _chunkZ7BVK32Ccjs = require('../chunk-Z7BVK32C.cjs');
 
 
 
@@ -189,4 +194,9 @@ var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
 
 
 
-exports.AgentPlayback = _chunk3SLBXKAWcjs.AgentPlayback; exports.CAPTURE_EXCLUDE_SELECTOR = _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkSVFEVKLFcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkSVFEVKLFcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkAMX23CSNcjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkAMX23CSNcjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkSVFEVKLFcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkSVFEVKLFcjs.MCP_TOOL_VIEW_EDITOR; exports.PRESENCE_COLORS = _chunkK7ENM55Pcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkK7ENM55Pcjs.PerformanceQueue; exports.PresenceStore = _chunkK7ENM55Pcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkAMX23CSNcjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkAMX23CSNcjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkAMX23CSNcjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkAMX23CSNcjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkAMX23CSNcjs.ToolRegistry; exports.ToolRegistryError = _chunkAMX23CSNcjs.ToolRegistryError; exports.ToolRegistryView = _chunkAMX23CSNcjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkAMX23CSNcjs.baseToolName; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkAMX23CSNcjs.connectToolBridge; exports.createAgentPlayback = _chunk3SLBXKAWcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkK7ENM55Pcjs.createInstantPresenceClock; exports.createMcpServer = _chunkAMX23CSNcjs.createMcpServer; exports.createPlaybackToolProvider = _chunk3SLBXKAWcjs.createPlaybackToolProvider; exports.createStyleResolver = _chunkU4QN36YTcjs.createStyleResolver; exports.createStyleToolProvider = _chunkU4QN36YTcjs.createStyleToolProvider; exports.createToolRegistry = _chunkAMX23CSNcjs.createToolRegistry; exports.derivePlaybackSteps = _chunk3SLBXKAWcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkAMX23CSNcjs.errorResult; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkills = _chunkAMX23CSNcjs.listSkills; exports.locatePlaybackChrome = _chunk3SLBXKAWcjs.locatePlaybackChrome; exports.memoryStyleStore = _chunkU4QN36YTcjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkAMX23CSNcjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkU4QN36YTcjs.parseStyleDomains; exports.playbackRectFromClient = _chunk3SLBXKAWcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk3SLBXKAWcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk3SLBXKAWcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkAMX23CSNcjs.readSkillFile; exports.readingTime = _chunk3SLBXKAWcjs.readingTime; exports.realPresenceClock = _chunkK7ENM55Pcjs.realPresenceClock; exports.renderStyle = _chunkU4QN36YTcjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkU4QN36YTcjs.runStyleChecks; exports.runToolScript = _chunkU4QN36YTcjs.runToolScript; exports.searchTokens = _chunkAMX23CSNcjs.searchTokens; exports.searchTools = _chunkAMX23CSNcjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkAMX23CSNcjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkAMX23CSNcjs.toToolResult; exports.toolResultError = _chunkU4QN36YTcjs.toolResultError; exports.toolResultValue = _chunkU4QN36YTcjs.toolResultValue; exports.toolsetInstructions = _chunkAMX23CSNcjs.toolsetInstructions; exports.toolsetName = _chunkAMX23CSNcjs.toolsetName; exports.trackPresenceDrag = _chunkK7ENM55Pcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkK7ENM55Pcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk3SLBXKAWcjs.unionRects; exports.unknownToolMessage = _chunkAMX23CSNcjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;
+
+
+
+
+
+exports.AgentPlayback = _chunk3SLBXKAWcjs.AgentPlayback; exports.CAPTURE_EXCLUDE_SELECTOR = _chunkSVFEVKLFcjs.CAPTURE_EXCLUDE_SELECTOR; exports.CAPTURE_OVERLAY_SELECTORS = _chunkSVFEVKLFcjs.CAPTURE_OVERLAY_SELECTORS; exports.EDITOR_CANVAS_TOOLS = _chunkSVFEVKLFcjs.EDITOR_CANVAS_TOOLS; exports.EDITOR_MCP_TOOLS = _chunkSVFEVKLFcjs.EDITOR_MCP_TOOLS; exports.EDITOR_PROMPT_TOOLS = _chunkSVFEVKLFcjs.EDITOR_PROMPT_TOOLS; exports.EDIT_OPERATION_REQUIRED_ARGUMENTS = _chunkSVFEVKLFcjs.EDIT_OPERATION_REQUIRED_ARGUMENTS; exports.EXPORT_EXCLUDED_SELECTORS = _chunkSVFEVKLFcjs.EXPORT_EXCLUDED_SELECTORS; exports.JSON_RPC_ERRORS = _chunkZ7BVK32Ccjs.JSON_RPC_ERRORS; exports.MCP_PROTOCOL_VERSIONS = _chunkZ7BVK32Ccjs.MCP_PROTOCOL_VERSIONS; exports.MCP_TOOL_CANVAS_ADD_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_ADD_NODE; exports.MCP_TOOL_CANVAS_CONNECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_CONNECT; exports.MCP_TOOL_CANVAS_HIGHLIGHT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_HIGHLIGHT; exports.MCP_TOOL_CANVAS_LAYOUT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_LAYOUT; exports.MCP_TOOL_CANVAS_REMOVE_NODES = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_REMOVE_NODES; exports.MCP_TOOL_CANVAS_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_SELECT; exports.MCP_TOOL_CANVAS_UPDATE_NODE = _chunkSVFEVKLFcjs.MCP_TOOL_CANVAS_UPDATE_NODE; exports.MCP_TOOL_EDIT_CANVAS = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_CANVAS; exports.MCP_TOOL_EDIT_PROMPT = _chunkSVFEVKLFcjs.MCP_TOOL_EDIT_PROMPT; exports.MCP_TOOL_GET_EDITOR_STATE = _chunkSVFEVKLFcjs.MCP_TOOL_GET_EDITOR_STATE; exports.MCP_TOOL_PROMPT_INSERT_TEXT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_INSERT_TEXT; exports.MCP_TOOL_PROMPT_REPLACE_RANGE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_REPLACE_RANGE; exports.MCP_TOOL_PROMPT_SELECT = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SELECT; exports.MCP_TOOL_PROMPT_SET_VARIABLE = _chunkSVFEVKLFcjs.MCP_TOOL_PROMPT_SET_VARIABLE; exports.MCP_TOOL_VIEW_EDITOR = _chunkSVFEVKLFcjs.MCP_TOOL_VIEW_EDITOR; exports.PRESENCE_COLORS = _chunkK7ENM55Pcjs.PRESENCE_COLORS; exports.PerformanceQueue = _chunkK7ENM55Pcjs.PerformanceQueue; exports.PresenceStore = _chunkK7ENM55Pcjs.PresenceStore; exports.TOOL_BRIDGE_DEFAULT_PORT = _chunkZ7BVK32Ccjs.TOOL_BRIDGE_DEFAULT_PORT; exports.TOOL_BRIDGE_PROTOCOL = _chunkZ7BVK32Ccjs.TOOL_BRIDGE_PROTOCOL; exports.TOOL_DISCOVERY_TOOLS = _chunkZ7BVK32Ccjs.TOOL_DISCOVERY_TOOLS; exports.TOOL_NAMESPACE_SEPARATOR = _chunkZ7BVK32Ccjs.TOOL_NAMESPACE_SEPARATOR; exports.ToolRegistry = _chunkZ7BVK32Ccjs.ToolRegistry; exports.ToolRegistryError = _chunkZ7BVK32Ccjs.ToolRegistryError; exports.ToolRegistryView = _chunkZ7BVK32Ccjs.ToolRegistryView; exports.UNSAFE_JSON_KEYS = _chunk2BSBFBOAcjs.UNSAFE_JSON_KEYS; exports.baseToolName = _chunkZ7BVK32Ccjs.baseToolName; exports.callEvalTool = _chunkBDT2IYXKcjs.callEvalTool; exports.captureInputSchema = _chunkN2FGYZ4Qcjs.captureInputSchema; exports.captureOutputSize = _chunkN2FGYZ4Qcjs.captureOutputSize; exports.cloneElementWithStyles = _chunkSVFEVKLFcjs.cloneElementWithStyles; exports.connectToolBridge = _chunkZ7BVK32Ccjs.connectToolBridge; exports.createAgentPlayback = _chunk3SLBXKAWcjs.createAgentPlayback; exports.createCaptureTool = _chunkN2FGYZ4Qcjs.createCaptureTool; exports.createCaptureToolProvider = _chunkN2FGYZ4Qcjs.createCaptureToolProvider; exports.createElementCaptureSurface = _chunkSVFEVKLFcjs.createElementCaptureSurface; exports.createInstantPresenceClock = _chunkK7ENM55Pcjs.createInstantPresenceClock; exports.createMcpServer = _chunkZ7BVK32Ccjs.createMcpServer; exports.createPlaybackToolProvider = _chunk3SLBXKAWcjs.createPlaybackToolProvider; exports.createStyleResolver = _chunkBDT2IYXKcjs.createStyleResolver; exports.createStyleToolProvider = _chunkBDT2IYXKcjs.createStyleToolProvider; exports.createToolRegistry = _chunkZ7BVK32Ccjs.createToolRegistry; exports.derivePlaybackSteps = _chunk3SLBXKAWcjs.derivePlaybackSteps; exports.elementToSvg = _chunkSVFEVKLFcjs.elementToSvg; exports.errorResult = _chunkZ7BVK32Ccjs.errorResult; exports.failedEvalChecks = _chunkBDT2IYXKcjs.failedEvalChecks; exports.imageEvalFixturePixels = _chunkBDT2IYXKcjs.imageEvalFixturePixels; exports.isUnsafeJsonKey = _chunk2BSBFBOAcjs.isUnsafeJsonKey; exports.listSkillEvals = _chunkBDT2IYXKcjs.listSkillEvals; exports.listSkills = _chunkZ7BVK32Ccjs.listSkills; exports.locatePlaybackChrome = _chunk3SLBXKAWcjs.locatePlaybackChrome; exports.matchesEvalExpectation = _chunkBDT2IYXKcjs.matchesEvalExpectation; exports.memoryStyleStore = _chunkBDT2IYXKcjs.memoryStyleStore; exports.parseSkillFrontmatter = _chunkZ7BVK32Ccjs.parseSkillFrontmatter; exports.parseStyleDomains = _chunkBDT2IYXKcjs.parseStyleDomains; exports.playbackRectFromClient = _chunk3SLBXKAWcjs.playbackRectFromClient; exports.playbackRefsFromArgs = _chunk3SLBXKAWcjs.playbackRefsFromArgs; exports.playbackRefsFromResult = _chunk3SLBXKAWcjs.playbackRefsFromResult; exports.rasterizeElement = _chunkSVFEVKLFcjs.rasterizeElement; exports.readSkillFile = _chunkZ7BVK32Ccjs.readSkillFile; exports.readingTime = _chunk3SLBXKAWcjs.readingTime; exports.realPresenceClock = _chunkK7ENM55Pcjs.realPresenceClock; exports.renderStyle = _chunkBDT2IYXKcjs.renderStyle; exports.resolveCaptureRequest = _chunkN2FGYZ4Qcjs.resolveCaptureRequest; exports.runStyleChecks = _chunkBDT2IYXKcjs.runStyleChecks; exports.runToolScript = _chunkBDT2IYXKcjs.runToolScript; exports.searchTokens = _chunkZ7BVK32Ccjs.searchTokens; exports.searchTools = _chunkZ7BVK32Ccjs.searchTools; exports.stripPrototypeKeys = _chunk2BSBFBOAcjs.stripPrototypeKeys; exports.summarize = _chunkZ7BVK32Ccjs.summarize; exports.toCapturedImageData = _chunkN2FGYZ4Qcjs.toCapturedImageData; exports.toToolResult = _chunkZ7BVK32Ccjs.toToolResult; exports.toolResultError = _chunkBDT2IYXKcjs.toolResultError; exports.toolResultValue = _chunkBDT2IYXKcjs.toolResultValue; exports.toolsetInstructions = _chunkZ7BVK32Ccjs.toolsetInstructions; exports.toolsetName = _chunkZ7BVK32Ccjs.toolsetName; exports.trackPresenceDrag = _chunkK7ENM55Pcjs.trackPresenceDrag; exports.tweenPresenceCursor = _chunkK7ENM55Pcjs.tweenPresenceCursor; exports.unionCaptureRects = _chunkN2FGYZ4Qcjs.unionCaptureRects; exports.unionRects = _chunk3SLBXKAWcjs.unionRects; exports.unknownToolMessage = _chunkZ7BVK32Ccjs.unknownToolMessage; exports.validateJsonSchema = _chunkWOFXZ3XUcjs.validateJsonSchema;

package/dist/tools/index.d.cts

@@ -17,6 +17,7 @@ export * from './dom-capture.cjs';
 export * from './view.cjs';
 export * from './search.cjs';
 export * from './skills.cjs';
+export * from './skill-evals.cjs';
 export * from './safe-json.cjs';
 export * from './presence.cjs';
 export * from './playback.cjs';

package/dist/tools/index.d.ts

@@ -17,6 +17,7 @@ export * from './dom-capture.js';
 export * from './view.js';
 export * from './search.js';
 export * from './skills.js';
+export * from './skill-evals.js';
 export * from './safe-json.js';
 export * from './presence.js';
 export * from './playback.js';

package/dist/tools/index.js

@@ -1,6 +1,11 @@
 import {
+  callEvalTool,
   createStyleResolver,
   createStyleToolProvider,
+  failedEvalChecks,
+  imageEvalFixturePixels,
+  listSkillEvals,
+  matchesEvalExpectation,
   memoryStyleStore,
   parseStyleDomains,
   renderStyle,
@@ -8,7 +13,7 @@ import {
   runToolScript,
   toolResultError,
   toolResultValue
-} from "../chunk-GI3AVES4.js";
+} from "../chunk-SVHXD2VH.js";
 import {
   JSON_RPC_ERRORS,
   MCP_PROTOCOL_VERSIONS,
@@ -34,7 +39,7 @@ import {
   toolsetInstructions,
   toolsetName,
   unknownToolMessage
-} from "../chunk-XZB3TJ6K.js";
+} from "../chunk-SAN4SBBS.js";
 import {
   AgentPlayback,
   createAgentPlayback,
@@ -139,6 +144,7 @@ export {
   ToolRegistryView,
   UNSAFE_JSON_KEYS,
   baseToolName,
+  callEvalTool,
   captureInputSchema,
   captureOutputSize,
   cloneElementWithStyles,
@@ -156,9 +162,13 @@ export {
   derivePlaybackSteps,
   elementToSvg,
   errorResult,
+  failedEvalChecks,
+  imageEvalFixturePixels,
   isUnsafeJsonKey,
+  listSkillEvals,
   listSkills,
   locatePlaybackChrome,
+  matchesEvalExpectation,
   memoryStyleStore,
   parseSkillFrontmatter,
   parseStyleDomains,

package/dist/tools/skill-evals.d.cts

@@ -0,0 +1,102 @@
+/**
+ * The evals that workflow skills ship in `skills/<name>/evals/*.json`, for any harness to run.
+ *
+ * An eval is a task a model would be given (`prompt`), the document it starts from
+ * (`fixture`), the checks that decide whether the job was done (`checks`: a read tool, its
+ * arguments and what its result must match) and one known-good answer (`solution`: the tool
+ * calls an expert would make). The package's own tests prove each eval with its `solution`; an
+ * agent harness builds the fixture, gives its model the `prompt` in place of the solution, then
+ * runs `failedEvalChecks`. The format is described in `skills/README.md`.
+ */
+import type { McpToolResult } from './registry.cjs';
+export interface SkillEvalToolCall {
+    tool: string;
+    args?: Record<string, unknown>;
+}
+export interface SkillEvalCheck extends SkillEvalToolCall {
+    /** What the check is for, shown when it fails. */
+    why: string;
+    expect: unknown;
+}
+export interface SkillEval {
+    prompt: string;
+    fixture: SpreadsheetEvalFixture | ImageEvalFixture | VectorEvalFixture | PaintEvalFixture | VideoEvalFixture;
+    checks: SkillEvalCheck[];
+    solution: SkillEvalToolCall[];
+}
+export interface SpreadsheetEvalFixture {
+    editor: 'spreadsheet';
+    /** Raw inputs from A1, row by row, typed as a person would (`'` forces text). */
+    rows: Array<Array<string | number | boolean | null>>;
+}
+export interface ImageEvalFixture {
+    editor: 'image';
+    width: number;
+    height: number;
+    /** RGB background. */
+    background: [number, number, number];
+    /** Shapes painted over it in order, with RGB colours. */
+    shapes: Array<{
+        shape: 'rect' | 'ellipse';
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        color: [number, number, number];
+    }>;
+}
+export interface VectorEvalFixture {
+    editor: 'vector';
+    width: number;
+    height: number;
+    /** Commands that build the starting artwork, run in order (`"$0.id"` refers to an earlier result). */
+    setup?: Array<{
+        id: string;
+        params?: Record<string, unknown>;
+    }>;
+}
+export interface PaintEvalFixture {
+    editor: 'paint';
+    width: number;
+    height: number;
+    /** Tool calls that prepare the canvas (paper, layers, strokes), run in order. */
+    setup?: SkillEvalToolCall[];
+}
+export interface VideoEvalFixture {
+    editor: 'video';
+    /** Tool calls that build the starting project (settings, assets, clips, markers), run in order. */
+    setup?: SkillEvalToolCall[];
+}
+/** One eval file of a skill. */
+export interface SkillEvalFile {
+    skill: string;
+    /** Path relative to the skills directory, e.g. `pixerate-image-selection-masking/evals/local-adjustment.json`. */
+    path: string;
+    eval: SkillEval;
+}
+/**
+ * The evals in a set of skill files (paths relative to the skills directory, contents as text,
+ * like `SkillFiles` but including `evals/*.json`), sorted by path.
+ */
+export declare function listSkillEvals(files: Readonly<Record<string, string>>): SkillEvalFile[];
+/** The RGBA pixels of an image fixture: shapes painted over the background in order. */
+export declare function imageEvalFixturePixels(f: ImageEvalFixture): {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+};
+/** Calls a tool by the bare name an eval uses; the harness maps it to its own names if it must. */
+export type SkillEvalToolCaller = (tool: string, args: Record<string, unknown>) => Promise<McpToolResult>;
+/** Calls one eval tool step (resolving `$read` arguments); throws with the tool's error text. */
+export declare function callEvalTool(callTool: SkillEvalToolCaller, { tool, args }: SkillEvalToolCall): Promise<unknown>;
+/**
+ * Whether `actual` matches `expected`. Objects match key by key (other keys are ignored),
+ * arrays element by element with the same length, other values exactly. Operators:
+ * `$min` / `$max` (numbers), `$type`, `$match` (a regular expression, or `[pattern, flags]`), `$in`, `$not`,
+ * `$every` / `$some` (array elements), `$length`, `$unique`, `$distinct` (the distinct
+ * values), `$sum`, `$column: [index, matcher]` (one column of a 2D array), `$nonEmpty`
+ * (the array without empty cells or rows) and `$expr` (a JavaScript expression over `v`).
+ */
+export declare function matchesEvalExpectation(actual: unknown, expected: unknown): boolean;
+/** The checks that fail, each as its `why` with what the tool returned (or its error). */
+export declare function failedEvalChecks(callTool: SkillEvalToolCaller, checks: readonly SkillEvalCheck[]): Promise<string[]>;