@jay-framework/aiditor 0.20.0 → 0.22.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import * as _jay_framework_dev_server from '@jay-framework/dev-server';
 import * as _jay_framework_fullstack_component from '@jay-framework/fullstack-component';
 import { JayFile } from '@jay-framework/fullstack-component';
+import { AddMenuCatalogLintWarning, AddMenuItem, AddMenuPresentation, AddMenuBrowseSize } from '@jay-framework/plugin-validator';
+export { AddMenuItem, AddMenuPresentation } from '@jay-framework/plugin-validator';
 import { PluginSetupContext, PluginSetupResult } from '@jay-framework/stack-server-runtime';
 export { aiditorPage, aiditorShell } from './index.client.js';
 import '@jay-framework/component';
@@ -110,35 +112,24 @@ declare const submitTaskAction: _jay_framework_fullstack_component.JayStreamActi
 declare const cancelAgentTaskAction: _jay_framework_fullstack_component.JayAction<{
     pageRoute?: string;
     renderedUrl?: string;
+    cancelKey?: string;
 }, {
     cancelled: boolean;
 }> & _jay_framework_fullstack_component.JayActionDefinition<{
     pageRoute?: string;
     renderedUrl?: string;
+    cancelKey?: string;
 }, {
     cancelled: boolean;
 }, []>;
 
-/** Design Log #19 — Add Menu agreement types (M19.1). */
-type AddMenuInteraction = {
-    mode: "reference" | "stage-place";
-    persistOnPage?: boolean;
-    stagePromptTemplate?: string;
-};
-type AddMenuItem = {
-    /** Stable unique id, convention: `<pluginName>:<slug>` */
-    id: string;
-    title: string;
-    /** Menu navigation label — not a type system */
-    category: string;
-    /** Injected verbatim into agent prompt when attached */
-    prompt: string;
-    pluginName?: string;
-    packageName?: string;
-    subCategory?: string;
-    thumbnail?: string;
-    interaction?: AddMenuInteraction;
-};
+/**
+ * AIditor Add Menu runtime types.
+ * Catalog item schema types come from @jay-framework/plugin-validator (source of truth).
+ */
+
+/** Runtime catalog warning — same shape as plugin-validator lint findings. */
+type AddMenuCatalogWarning = AddMenuCatalogLintWarning;
 type AddMenuAttachment = {
     itemId: string;
     /** Change Request: set when chip is on a marker; omit = request-level */
@@ -161,7 +152,7 @@ type AddMenuSubCategoryGroup = {
 type ListAddMenuItemsResult = {
     items: AddMenuItem[];
     categories: AddMenuCategoryGroup[];
-    warnings: string[];
+    warnings: AddMenuCatalogWarning[];
 };
 
 type PageBriefAttachment = {
@@ -384,9 +375,9 @@ declare const generateAddPageBriefFromImageAction: _jay_framework_fullstack_comp
     referenceAttachments?: undefined;
 } | {
     ok: boolean;
-    markdown: string;
-    suggestedRoute: string;
-    suggestedRouteKind: "static" | "dynamic";
+    markdown: any;
+    suggestedRoute: any;
+    suggestedRouteKind: any;
     referenceAttachments: {
         id: string;
         path: string;
@@ -408,9 +399,9 @@ declare const generateAddPageBriefFromImageAction: _jay_framework_fullstack_comp
     referenceAttachments?: undefined;
 } | {
     ok: boolean;
-    markdown: string;
-    suggestedRoute: string;
-    suggestedRouteKind: "static" | "dynamic";
+    markdown: any;
+    suggestedRoute: any;
+    suggestedRouteKind: any;
     referenceAttachments: {
         id: string;
         path: string;
@@ -763,7 +754,6 @@ type PageAssetEntry = {
     source: PageAssetSource;
     itemId?: string;
     thumbnail?: string;
-    persistOnPage: boolean;
     addedAt: string;
     /** Stable key for detected entries — used for sync + suppression */
     detectedKey?: string;
@@ -861,4 +851,14 @@ declare const runAiditorPublishAction: _jay_framework_fullstack_component.JayStr
 
 declare function setupAiditor(ctx: PluginSetupContext): Promise<PluginSetupResult>;
 
-export { cancelAgentTaskAction, checkAddPageRouteAction, checkAiditorPublishAction, checkPageAddPageBriefAction, checkPluginUpdateAction, ensureProjectPluginAction, generateAddPageBriefFromImageAction, getAiditorBootstrap, getContractInspectorTagsAction, getPageAssetsAction, getPageMetaAction, getPageParamsAction, getPluginSetupStatusAction, getProjectInfoAction, listAddMenuItemsAction, listFreezesAction, listJayPluginsAction, listPluginContractsAction, openAddPageFromBriefAction, readFileAction, reclassifyAddPageAssetAction, rerunPluginSetupAction, resolveAddMenuContractParamsAction, runAiditorPublishAction, saveAddPageDraftAction, savePageAssetsAction, savePageMetaAction, setupAiditor, startAddPageRequestAction, submitAddPageAction, submitTaskAction, syncAddMenuAttachmentsAction, syncAddPagePluginManifestAction, syncDetectedPageAssetsAction, uploadAddPageAssetAction, writePluginSourceAction };
+declare function listAddMenuItems(projectRoot: string): Promise<ListAddMenuItemsResult>;
+
+declare function sanitizeAddMenuHtmlFragment(html: string): string;
+
+/** Normalize legacy `thumbnail` and explicit `presentation` to one shape (Design Log #30). */
+declare function normalizeAddMenuPresentation(item: Pick<AddMenuItem, "thumbnail" | "presentation">): AddMenuPresentation | undefined;
+
+/** Default browse footprint — Design Log #32. */
+declare function normalizeAddMenuBrowseSize(item: Pick<AddMenuItem, "browse">): AddMenuBrowseSize;
+
+export { type AddMenuCatalogWarning, type ListAddMenuItemsResult, cancelAgentTaskAction, checkAddPageRouteAction, checkAiditorPublishAction, checkPageAddPageBriefAction, checkPluginUpdateAction, ensureProjectPluginAction, generateAddPageBriefFromImageAction, getAiditorBootstrap, getContractInspectorTagsAction, getPageAssetsAction, getPageMetaAction, getPageParamsAction, getPluginSetupStatusAction, getProjectInfoAction, listAddMenuItems, listAddMenuItemsAction, listFreezesAction, listJayPluginsAction, listPluginContractsAction, normalizeAddMenuBrowseSize, normalizeAddMenuPresentation, openAddPageFromBriefAction, readFileAction, reclassifyAddPageAssetAction, rerunPluginSetupAction, resolveAddMenuContractParamsAction, runAiditorPublishAction, sanitizeAddMenuHtmlFragment, saveAddPageDraftAction, savePageAssetsAction, savePageMetaAction, setupAiditor, startAddPageRequestAction, submitAddPageAction, submitTaskAction, syncAddMenuAttachmentsAction, syncAddPagePluginManifestAction, syncDetectedPageAssetsAction, uploadAddPageAssetAction, writePluginSourceAction };

package/dist/index.js

@@ -1,3 +1,6 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { makeJayQuery, makeJayStream, makeJayStackComponent, phaseOutput, RenderPipeline } from "@jay-framework/fullstack-component";
 import { DEV_SERVER_SERVICE } from "@jay-framework/dev-server";
 import fs, { readFile, readdir } from "fs/promises";
@@ -6,6 +9,7 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 import fs$1 from "fs";
 import crypto from "crypto";
 import yaml, { load } from "js-yaml";
+import { validateAddMenuCatalogFile, lintAddMenuCatalog } from "@jay-framework/plugin-validator";
 import { getLogger } from "@jay-framework/logger";
 import { fileURLToPath } from "url";
 import { spawn } from "child_process";
@@ -338,131 +342,10 @@ function groupAddMenuItems(items) {
       return sa.localeCompare(sb);
     }).map(([subCategory, subItems]) => ({
       subCategory,
-      items: subItems.sort((a, b) => a.title.localeCompare(b.title))
+      items: subItems
     }))
   }));
 }
-const REJECTED_ITEM_FIELDS = [
-  "kind",
-  "parameters",
-  "component",
-  "allowedScopes"
-];
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function requiredString(obj, field, path2, errors) {
-  const value = obj[field];
-  if (typeof value !== "string" || value.trim().length === 0) {
-    errors.push({
-      path: `${path2}.${field}`,
-      message: "required non-empty string"
-    });
-    return null;
-  }
-  return value.trim();
-}
-function optionalString(obj, field) {
-  const value = obj[field];
-  if (value === void 0) return void 0;
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-function optionalBoolean(obj, field) {
-  const value = obj[field];
-  return typeof value === "boolean" ? value : void 0;
-}
-function validateInteraction(raw, path2, errors) {
-  if (raw === void 0) return void 0;
-  if (!isRecord(raw)) {
-    errors.push({ path: path2, message: "interaction must be an object" });
-    return void 0;
-  }
-  const mode = raw.mode;
-  if (mode !== "reference" && mode !== "stage-place") {
-    errors.push({
-      path: `${path2}.mode`,
-      message: 'mode must be "reference" or "stage-place"'
-    });
-    return void 0;
-  }
-  return {
-    mode,
-    persistOnPage: optionalBoolean(raw, "persistOnPage"),
-    stagePromptTemplate: optionalString(raw, "stagePromptTemplate")
-  };
-}
-function validateAddMenuItem(raw, path2) {
-  const errors = [];
-  if (!isRecord(raw)) {
-    return {
-      item: null,
-      errors: [{ path: path2, message: "item must be an object" }]
-    };
-  }
-  for (const field of REJECTED_ITEM_FIELDS) {
-    if (field in raw) {
-      errors.push({
-        path: `${path2}.${field}`,
-        message: `field "${field}" is not allowed in Add Menu catalog items`
-      });
-    }
-  }
-  const id = requiredString(raw, "id", path2, errors);
-  const title = requiredString(raw, "title", path2, errors);
-  const category = requiredString(raw, "category", path2, errors);
-  const prompt = requiredString(raw, "prompt", path2, errors);
-  if (errors.length > 0 || !id || !title || !category || !prompt) {
-    return { item: null, errors };
-  }
-  const interaction = validateInteraction(
-    raw.interaction,
-    `${path2}.interaction`,
-    errors
-  );
-  return {
-    item: {
-      id,
-      title,
-      category,
-      prompt,
-      pluginName: optionalString(raw, "pluginName"),
-      packageName: optionalString(raw, "packageName"),
-      subCategory: optionalString(raw, "subCategory"),
-      thumbnail: optionalString(raw, "thumbnail"),
-      ...interaction ? { interaction } : {}
-    },
-    errors
-  };
-}
-function validateAddMenuCatalogFile(raw, sourcePath) {
-  const errors = [];
-  if (!isRecord(raw)) {
-    return {
-      file: null,
-      errors: [{ path: sourcePath, message: "catalog file must be an object" }]
-    };
-  }
-  if (!Array.isArray(raw.items)) {
-    return {
-      file: null,
-      errors: [
-        { path: `${sourcePath}.items`, message: "items must be an array" }
-      ]
-    };
-  }
-  const items = [];
-  raw.items.forEach((entry, index) => {
-    const result = validateAddMenuItem(entry, `${sourcePath}.items[${index}]`);
-    errors.push(...result.errors);
-    if (result.item) items.push(result.item);
-  });
-  if (items.length === 0 && errors.length > 0) {
-    return { file: null, errors };
-  }
-  return { file: { items }, errors };
-}
 function parsePluginsIndexYaml(yaml2) {
   const entries = [];
   let currentPlugin = null;
@@ -588,6 +471,7 @@ async function parsePluginYamlContracts(projectRoot, pluginName) {
   }
 }
 const ADD_MENU_DIR = path.join("agent-kit", "aiditor", "add-menu");
+const LOCAL_PLUGINS_DIR = path.join("src", "plugins");
 function packageNameFromItem(item) {
   if (item.packageName) return item.packageName;
   if (item.pluginName) return `@jay-framework/${item.pluginName}`;
@@ -603,6 +487,39 @@ function pluginNameFromItem(item) {
   if (colon > 0) return item.id.slice(0, colon);
   return null;
 }
+async function getLocalPluginNames(projectRoot) {
+  const names = /* @__PURE__ */ new Set();
+  const pluginsDir = path.join(projectRoot, LOCAL_PLUGINS_DIR);
+  let entries;
+  try {
+    entries = await fs.readdir(pluginsDir);
+  } catch (e) {
+    const code = e && typeof e === "object" && "code" in e ? e.code : void 0;
+    if (code === "ENOENT") return names;
+    throw e;
+  }
+  for (const entry of entries) {
+    const pluginYaml = path.join(pluginsDir, entry, "plugin.yaml");
+    try {
+      const yaml2 = await fs.readFile(pluginYaml, "utf-8");
+      const nameMatch = yaml2.match(/^name:\s*(.+)\s*$/m);
+      if (nameMatch?.[1]) {
+        names.add(nameMatch[1].trim());
+        continue;
+      }
+    } catch {
+    }
+    names.add(entry);
+  }
+  return names;
+}
+function validationErrorToWarning(err) {
+  return {
+    code: err.code ?? "catalog-validation-error",
+    message: `${err.path}: ${err.message}`,
+    sourcePath: err.path
+  };
+}
 async function listAddMenuItems(projectRoot) {
   const addMenuDir = path.join(projectRoot, ADD_MENU_DIR);
   const warnings = [];
@@ -620,43 +537,67 @@ async function listAddMenuItems(projectRoot) {
   const installed = await getInstalledPlugins(projectRoot);
   const installedPackages = new Set(installed.map((p) => p.packageName));
   const installedPlugins = new Set(installed.map((p) => p.pluginName));
+  for (const localName of await getLocalPluginNames(projectRoot)) {
+    installedPlugins.add(localName);
+  }
   const byId = /* @__PURE__ */ new Map();
+  const orderedIds = [];
+  const lintBlockedIds = /* @__PURE__ */ new Set();
   for (const filePath of yamlFiles) {
     const relPath = path.relative(projectRoot, filePath);
     let rawContent;
     try {
       rawContent = await fs.readFile(filePath, "utf-8");
     } catch {
-      warnings.push(`Could not read Add Menu catalog file: ${relPath}`);
+      warnings.push({
+        code: "catalog-read-error",
+        message: `Could not read Add Menu catalog file: ${relPath}`,
+        sourcePath: relPath
+      });
       continue;
     }
     let parsed;
     try {
       parsed = load(rawContent);
     } catch (err) {
-      warnings.push(
-        `Invalid YAML in ${relPath}: ${err instanceof Error ? err.message : String(err)}`
-      );
+      warnings.push({
+        code: "catalog-parse-error",
+        message: `Invalid YAML in ${relPath}: ${err instanceof Error ? err.message : String(err)}`,
+        sourcePath: relPath
+      });
       continue;
     }
     const validated = validateAddMenuCatalogFile(parsed, relPath);
-    if (validated.errors.length > 0) {
-      for (const err of validated.errors) {
-        warnings.push(`${err.path}: ${err.message}`);
-      }
+    for (const err of validated.errors) {
+      warnings.push(validationErrorToWarning(err));
+    }
+    if (!validated.file) {
       continue;
     }
+    const linted = lintAddMenuCatalog(validated.file.items, relPath);
+    for (const err of linted.errors) {
+      warnings.push(err);
+      if (err.itemId) lintBlockedIds.add(err.itemId);
+    }
+    warnings.push(...linted.warnings);
     for (const item of validated.file.items) {
+      if (lintBlockedIds.has(item.id)) continue;
       const prev = byId.get(item.id);
       if (prev) {
-        warnings.push(
-          `Duplicate Add Menu item id "${item.id}": "${prev.sourcePath}" overwritten by "${relPath}"`
-        );
+        warnings.push({
+          code: "catalog-duplicate-id",
+          message: `Duplicate Add Menu item id "${item.id}": "${prev.sourcePath}" overwritten by "${relPath}"`,
+          itemId: item.id,
+          sourcePath: relPath
+        });
+        byId.set(item.id, { item, sourcePath: relPath });
+        continue;
       }
       byId.set(item.id, { item, sourcePath: relPath });
+      orderedIds.push(item.id);
     }
   }
-  const merged = [...byId.values()].map((entry) => entry.item);
+  const merged = orderedIds.map((id) => byId.get(id)?.item).filter((item) => item !== void 0);
   const filtered = merged.filter((item) => {
     const pkg = packageNameFromItem(item);
     const plugin = pluginNameFromItem(item);
@@ -665,7 +606,7 @@ async function listAddMenuItems(projectRoot) {
     return false;
   });
   return {
-    items: filtered.sort((a, b) => a.title.localeCompare(b.title)),
+    items: filtered,
     categories: groupAddMenuItems(filtered),
     warnings
   };
@@ -938,7 +879,7 @@ function buildRouteMigrationPromptSection(routeMigration) {
   ].join("\n");
 }
 function buildPageAssetsPromptSection(assets) {
-  const active = assets.filter((a) => a.persistOnPage && !a.userRemoved);
+  const active = assets.filter((a) => !a.userRemoved);
   if (active.length === 0) return "";
   const lines = [
     "Page assets (in scope for this page — use when referenced in marker instructions or @mentions):"
@@ -1086,11 +1027,12 @@ function appendVisualAttachmentLines(body, attachments, indent = "") {
     return;
   }
   body.push(
-    `${indent}Attachments (read from disk; belong to this annotation only):`
+    `${indent}Attachments (read from disk; belong to this annotation only; match "image #N" in the instruction):`
   );
-  for (const att of attachments) {
+  for (let i = 0; i < attachments.length; i++) {
+    const att = attachments[i];
     body.push(
-      `${indent}- ${att.taskCopyPath} (filename: ${att.originalFileName})`
+      `${indent}- Image #${i + 1}: ${att.taskCopyPath} (filename: ${att.originalFileName})`
     );
   }
 }
@@ -1265,6 +1207,13 @@ function buildVisualPromptVideo(config, pageRoute, renderedUrl, videoPath, frame
   }
   return [...preamble, ...body].join("\n");
 }
+function distinctTimeSecsAscending(annotations) {
+  const s = /* @__PURE__ */ new Set();
+  for (const a of annotations) {
+    s.add(a.timeSec);
+  }
+  return [...s].sort((a, b) => a - b);
+}
 function persistFile(file, destDir, fileName) {
   fs$1.mkdirSync(destDir, { recursive: true });
   const dest = path.join(destDir, fileName ?? file.name);
@@ -1309,14 +1258,13 @@ const submitTaskAction = makeJayStream("aiditor.submitTask").withFiles().withHan
     }
     const extra = input.extraFiles ?? {};
     const frames = [];
+    const momentTimes = parsed.structuredVideo ? distinctTimeSecsAscending(parsed.structuredVideo.annotations) : [];
     for (let i = 0; ; i++) {
       const markers = extra[`frame_${i}_markers_only`];
       const clean = extra[`frame_${i}_clean`];
       if (!markers && !clean) break;
       const frameDir = path.join(taskDir, "frames", String(i));
-      const timeSec = parsed.structuredVideo?.annotations.find(
-        (a, idx) => idx === i || a.timeSec !== void 0
-      )?.timeSec ?? i;
+      const timeSec = momentTimes[i] ?? i;
       frames.push({
         timeSec,
         frameIndex: i,
@@ -1456,17 +1404,19 @@ const submitTaskAction = makeJayStream("aiditor.submitTask").withFiles().withHan
 });
 const cancelAgentTaskAction = makeJayQuery(
   "aiditor.cancelAgentTask"
-).withHandler(async (input) => {
-  const routeKey = resolveAgentContextKey({
-    pageRoute: input.pageRoute ?? "/",
-    renderedUrl: input.renderedUrl
-  });
-  const cancelled = cancelAgentTask(routeKey);
-  if (!cancelled) {
-    forceReleaseAgentRoute(routeKey);
+).withHandler(
+  async (input) => {
+    const routeKey = input.cancelKey?.trim() || resolveAgentContextKey({
+      pageRoute: input.pageRoute ?? "/",
+      renderedUrl: input.renderedUrl
+    });
+    const cancelled = cancelAgentTask(routeKey);
+    if (!cancelled) {
+      forceReleaseAgentRoute(routeKey);
+    }
+    return { cancelled: true };
   }
-  return { cancelled: true };
-});
+);
 class AddPagePromptLoadError extends Error {
   constructor(message) {
     super(message);
@@ -2292,6 +2242,12 @@ When the image is a formal Figma **design definitions** board, apply these rules
 ${designDefinitionsBody}`;
   });
 }
+class BriefFillCancelledError extends Error {
+  constructor() {
+    super("Stopped by user.");
+    __publicField(this, "name", "BriefFillCancelledError");
+  }
+}
 const briefFillModelOverride = process.env.AIDITOR_BRIEF_FILL_MODEL?.trim();
 const ALLOWED_IMAGE_MIMES = /* @__PURE__ */ new Set([
   "image/png",
@@ -2459,6 +2415,9 @@ async function runBriefFillAgentQuery(input) {
       thinking: { type: "disabled" }
     }
   })) {
+    if (input.cancelKey && isAgentTaskCancelled(input.cancelKey)) {
+      throw new BriefFillCancelledError();
+    }
     collected.push(message);
   }
   const rawText = extractBriefFillRawText(collected);
@@ -2487,6 +2446,19 @@ async function generateBriefFromImages(input, options) {
   }
   return { markdown };
 }
+const BRIEF_FILL_CANCEL_PREFIX = "brief-fill:";
+function resolveBriefFillCancelKey(input) {
+  const targetSuffix = input.target ? `:${input.target}` : "";
+  const requestId = input.requestId?.trim();
+  if (requestId) {
+    return `${BRIEF_FILL_CANCEL_PREFIX}request:${requestId}${targetSuffix}`;
+  }
+  const route = input.pageRoute?.trim();
+  if (route) {
+    return `${BRIEF_FILL_CANCEL_PREFIX}route:${normalizePageRoute(route)}${targetSuffix}`;
+  }
+  return `${BRIEF_FILL_CANCEL_PREFIX}draft${targetSuffix}`;
+}
 function persistUpload(file, destPath) {
   fs$1.mkdirSync(path.dirname(destPath), { recursive: true });
   fs$1.copyFileSync(file.path, destPath);
@@ -2826,15 +2798,27 @@ const generateAddPageBriefFromImageAction = makeJayQuery(
     }
     try {
       const images = imageFiles.map(readImageAsBase64);
-      const result = await generateBriefFromImages(
-        {
-          target: input.target,
-          images,
-          contextNotes: input.contextNotes,
-          pageRoute: input.pageRoute
-        },
-        { projectDir }
-      );
+      const cancelKey = resolveBriefFillCancelKey({
+        requestId: input.requestId,
+        pageRoute: input.pageRoute,
+        target: input.target
+      });
+      const cancelToken = beginCancellableAgentTask(cancelKey);
+      let result;
+      try {
+        result = await generateBriefFromImages(
+          {
+            target: input.target,
+            images,
+            contextNotes: input.contextNotes,
+            pageRoute: input.pageRoute,
+            cancelKey
+          },
+          { projectDir }
+        );
+      } finally {
+        endCancellableAgentTask(cancelKey, cancelToken);
+      }
       const referenceAttachments = [];
       if (input.requestId) {
         for (const file of imageFiles) {
@@ -2863,6 +2847,9 @@ const generateAddPageBriefFromImageAction = makeJayQuery(
         referenceAttachments
       };
     } catch (err) {
+      if (err instanceof BriefFillCancelledError) {
+        return { ok: false, error: err.message };
+      }
       return {
         ok: false,
         error: err instanceof Error ? err.message : String(err)
@@ -4374,7 +4361,6 @@ function detectedToPageAssetEntry(detected) {
     prompt: detected.prompt,
     source: "detected",
     itemId: detected.pluginName ? `${detected.pluginName}:${detected.contractName ?? ""}` : void 0,
-    persistOnPage: true,
     addedAt: (/* @__PURE__ */ new Date()).toISOString(),
     detectedKey: detected.detectedKey,
     detectedMeta: {
@@ -4596,6 +4582,34 @@ async function setupAiditor(ctx) {
     ...filesUpdated.length > 0 ? { filesUpdated } : {}
   };
 }
+const BLOCKED_TAGS = /<\s*(script|iframe|object|embed)\b[^>]*>[\s\S]*?<\/\s*\1\s*>|<\s*(script|iframe|object|embed)\b[^>]*\/?>/gi;
+const EVENT_HANDLER_ATTR = /\s+on[a-z]+\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/gi;
+const JAVASCRIPT_URL = /\b(href|src|xlink:href)\s*=\s*("|')\s*javascript:/gi;
+function sanitizeAddMenuHtmlFragment(html) {
+  let result = html;
+  result = result.replace(BLOCKED_TAGS, "");
+  BLOCKED_TAGS.lastIndex = 0;
+  result = result.replace(EVENT_HANDLER_ATTR, "");
+  EVENT_HANDLER_ATTR.lastIndex = 0;
+  result = result.replace(JAVASCRIPT_URL, "");
+  JAVASCRIPT_URL.lastIndex = 0;
+  return result.trim();
+}
+function isGifPath(src) {
+  return /\.gif($|\?)/i.test(src.trim());
+}
+function normalizeAddMenuPresentation(item) {
+  if (item.presentation) return item.presentation;
+  const thumbnail = item.thumbnail?.trim();
+  if (!thumbnail) return void 0;
+  if (isGifPath(thumbnail)) {
+    return { type: "gif", src: thumbnail };
+  }
+  return { type: "image", src: thumbnail };
+}
+function normalizeAddMenuBrowseSize(item) {
+  return item.browse?.size ?? "medium";
+}
 const aiditorShell = makeJayStackComponent().withProps().withSlowlyRender(async () => {
   return phaseOutput({}, { headline: "AIditor" });
 }).withFastRender(async (_props, carryForward) => {
@@ -4626,16 +4640,20 @@ export {
   getPageParamsAction,
   getPluginSetupStatusAction,
   getProjectInfoAction,
+  listAddMenuItems,
   listAddMenuItemsAction,
   listFreezesAction,
   listJayPluginsAction,
   listPluginContractsAction,
+  normalizeAddMenuBrowseSize,
+  normalizeAddMenuPresentation,
   openAddPageFromBriefAction,
   readFileAction,
   reclassifyAddPageAssetAction,
   rerunPluginSetupAction,
   resolveAddMenuContractParamsAction,
   runAiditorPublishAction,
+  sanitizeAddMenuHtmlFragment,
   saveAddPageDraftAction,
   savePageAssetsAction,
   savePageMetaAction,