auto-webmcp 0.2.9 → 0.3.0

package/dist/analyzer.d.ts

@@ -3,10 +3,17 @@
  */
 import { JsonSchema } from './schema.js';
 import { FormOverride } from './config.js';
+export interface ToolAnnotations {
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
 export interface ToolMetadata {
     name: string;
     description: string;
     inputSchema: JsonSchema;
+    annotations?: ToolAnnotations;
     /** Key → DOM element for fields not addressable by name (id-keyed or ARIA-role controls). */
     fieldElements?: Map<string, Element>;
 }

package/dist/analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAmJ,MAAM,aAAa,CAAC;AAC1L,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAKD,iDAAiD;AACjD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,CAMxF;AAsgBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,KAAK,CAAC,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,CAAC,EACzE,SAAS,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,GACrD,YAAY,CAKd"}
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAmJ,MAAM,aAAa,CAAC;AAC1L,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,6FAA6F;IAC7F,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAKD,iDAAiD;AACjD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,CAOxF;AAynBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,KAAK,CAAC,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,CAAC,EACzE,SAAS,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,GACrD,YAAY,CAKd"}

package/dist/auto-webmcp.cjs.js

@@ -40,22 +40,21 @@ async function registerFormTool(form, metadata, execute) {
   if (existing) {
     await unregisterFormTool(form);
   }
+  const toolDef = {
+    name: metadata.name,
+    description: metadata.description,
+    inputSchema: metadata.inputSchema,
+    execute
+  };
+  if (metadata.annotations && Object.keys(metadata.annotations).length > 0) {
+    toolDef.annotations = metadata.annotations;
+  }
   try {
-    await navigator.modelContext.registerTool({
-      name: metadata.name,
-      description: metadata.description,
-      inputSchema: metadata.inputSchema,
-      execute
-    });
+    await navigator.modelContext.registerTool(toolDef);
   } catch {
     try {
       await navigator.modelContext.unregisterTool(metadata.name);
-      await navigator.modelContext.registerTool({
-        name: metadata.name,
-        description: metadata.description,
-        inputSchema: metadata.inputSchema,
-        execute
-      });
+      await navigator.modelContext.registerTool(toolDef);
     } catch {
     }
   }
@@ -207,6 +206,14 @@ function buildStringSchema(input) {
   }
   return prop;
 }
+var PLACEHOLDER_PATTERNS = /^(select|choose|pick)\b|^--+|---/i;
+function isPlaceholderOption(opt) {
+  if (opt.disabled)
+    return true;
+  if (opt.value !== "")
+    return false;
+  return PLACEHOLDER_PATTERNS.test(opt.text.trim());
+}
 function mapSelectElement(select) {
   const enumValues = [];
   const oneOf = [];
@@ -218,7 +225,7 @@ function mapSelectElement(select) {
       for (const opt of Array.from(child.children)) {
         if (!(opt instanceof HTMLOptionElement))
           continue;
-        if (opt.disabled || opt.value === "")
+        if (isPlaceholderOption(opt))
           continue;
         enumValues.push(opt.value);
         const entry = {
@@ -230,7 +237,7 @@ function mapSelectElement(select) {
         oneOf.push(entry);
       }
     } else if (child instanceof HTMLOptionElement) {
-      if (child.disabled || child.value === "")
+      if (isPlaceholderOption(child))
         continue;
       enumValues.push(child.value);
       oneOf.push({ const: child.value, title: child.text.trim() || child.value });
@@ -238,6 +245,9 @@ function mapSelectElement(select) {
   }
   if (enumValues.length === 0)
     return { type: "string" };
+  if (select.multiple) {
+    return { type: "array", items: { type: "string", enum: enumValues } };
+  }
   return { type: "string", enum: enumValues, oneOf };
 }
 function collectCheckboxEnum(form, name) {
@@ -329,7 +339,8 @@ function analyzeForm(form, override) {
   const name = override?.name ?? inferToolName(form);
   const description = override?.description ?? inferToolDescription(form);
   const { schema: inputSchema, fieldElements } = buildSchema(form);
-  return { name, description, inputSchema, fieldElements };
+  const annotations = inferAnnotations(form);
+  return { name, description, inputSchema, annotations, fieldElements };
 }
 function inferToolName(form) {
   const nativeName = form.getAttribute("toolname");
@@ -426,6 +437,72 @@ function inferToolDescription(form) {
     return pageTitle;
   return "Submit form";
 }
+var READONLY_BUTTON_PATTERNS = /^(search|find|look|filter|browse|view|show|check|preview|get|fetch|retrieve|load)\b/i;
+var DESTRUCTIVE_BUTTON_PATTERNS = /^(delete|remove|cancel|terminate|destroy|purge|revoke|unsubscribe|deactivate)\b/i;
+var DESTRUCTIVE_URL_PATTERNS = /\/(delete|remove|cancel|destroy)\b/i;
+function inferAnnotations(form) {
+  const annotations = {};
+  if (form.dataset["webmcpReadonly"] !== void 0) {
+    annotations.readOnlyHint = form.dataset["webmcpReadonly"] !== "false";
+  }
+  if (form.dataset["webmcpDestructive"] !== void 0) {
+    annotations.destructiveHint = form.dataset["webmcpDestructive"] !== "false";
+  }
+  if (form.dataset["webmcpIdempotent"] !== void 0) {
+    annotations.idempotentHint = form.dataset["webmcpIdempotent"] !== "false";
+  }
+  if (form.dataset["webmcpOpenworld"] !== void 0) {
+    annotations.openWorldHint = form.dataset["webmcpOpenworld"] !== "false";
+  }
+  if (annotations.readOnlyHint === void 0) {
+    const isGet = form.method.toLowerCase() === "get";
+    const submitText = getSubmitButtonText(form);
+    const isReadLabel = submitText ? READONLY_BUTTON_PATTERNS.test(submitText.trim()) : false;
+    if (isGet || isReadLabel)
+      annotations.readOnlyHint = true;
+  }
+  if (annotations.destructiveHint === void 0) {
+    const submitText = getSubmitButtonText(form);
+    const isDestructiveLabel = submitText ? DESTRUCTIVE_BUTTON_PATTERNS.test(submitText.trim()) : false;
+    const isDestructiveUrl = form.action ? DESTRUCTIVE_URL_PATTERNS.test(form.action) : false;
+    if (isDestructiveLabel || isDestructiveUrl)
+      annotations.destructiveHint = true;
+  }
+  if (annotations.idempotentHint === void 0) {
+    if (annotations.readOnlyHint === true || form.method.toLowerCase() === "get") {
+      annotations.idempotentHint = true;
+    }
+  }
+  if (annotations.openWorldHint === void 0) {
+    annotations.openWorldHint = annotations.readOnlyHint !== true;
+  }
+  const hasNonDefault = annotations.readOnlyHint === true || annotations.destructiveHint === true || annotations.idempotentHint === true || annotations.openWorldHint === false;
+  return hasNonDefault ? annotations : {};
+}
+function extractDefaultValue(control) {
+  if (control instanceof HTMLInputElement) {
+    const type = control.type.toLowerCase();
+    if (type === "checkbox")
+      return control.checked ? true : void 0;
+    if (type === "radio")
+      return void 0;
+    if (type === "number" || type === "range") {
+      return control.value !== "" ? parseFloat(control.value) : void 0;
+    }
+    return control.value !== "" ? control.value : void 0;
+  }
+  if (control instanceof HTMLTextAreaElement) {
+    return control.value !== "" ? control.value : void 0;
+  }
+  if (control instanceof HTMLSelectElement) {
+    if (control.multiple) {
+      const selected = Array.from(control.options).filter((o) => o.selected).map((o) => o.value);
+      return selected.length > 0 ? selected : void 0;
+    }
+    return control.value !== "" ? control.value : void 0;
+  }
+  return void 0;
+}
 function buildSchema(form) {
   const properties = {};
   const required = [];
@@ -461,11 +538,19 @@ function buildSchema(form) {
     const desc = inferFieldDescription(control);
     if (desc)
       schemaProp.description = desc;
+    const defaultVal = extractDefaultValue(control);
+    if (defaultVal !== void 0)
+      schemaProp.default = defaultVal;
     if (control instanceof HTMLInputElement && control.type === "radio") {
       schemaProp.enum = collectRadioEnum(form, fieldKey);
       const radioOneOf = collectRadioOneOf(form, fieldKey);
       if (radioOneOf.length > 0)
         schemaProp.oneOf = radioOneOf;
+      const checkedRadio = form.querySelector(
+        `input[type="radio"][name="${CSS.escape(fieldKey)}"]:checked`
+      );
+      if (checkedRadio?.value)
+        schemaProp.default = checkedRadio.value;
     }
     if (control instanceof HTMLInputElement && control.type === "checkbox") {
       const checkboxValues = collectCheckboxEnum(form, fieldKey);
@@ -477,6 +562,13 @@ function buildSchema(form) {
         };
         if (schemaProp.description)
           arrayProp.description = schemaProp.description;
+        const checkedBoxes = Array.from(
+          form.querySelectorAll(
+            `input[type="checkbox"][name="${CSS.escape(fieldKey)}"]:checked`
+          )
+        ).map((b) => b.value);
+        if (checkedBoxes.length > 0)
+          arrayProp.default = checkedBoxes;
         properties[fieldKey] = arrayProp;
         if (control.required)
           required.push(fieldKey);
@@ -599,6 +691,9 @@ function resolveAriaFieldKey(el) {
   return null;
 }
 function inferAriaFieldTitle(el) {
+  const nativeTitle = el.getAttribute("toolparamtitle");
+  if (nativeTitle?.trim())
+    return nativeTitle.trim();
   const htmlEl = el;
   if (htmlEl.dataset?.["webmcpTitle"])
     return htmlEl.dataset["webmcpTitle"];
@@ -637,6 +732,9 @@ function inferAriaFieldDescription(el) {
   return "";
 }
 function inferFieldTitle(control) {
+  const nativeTitle = control.getAttribute("toolparamtitle");
+  if (nativeTitle?.trim())
+    return nativeTitle.trim();
   if ("dataset" in control && control.dataset["webmcpTitle"]) {
     return control.dataset["webmcpTitle"];
   }
@@ -834,6 +932,7 @@ var lastParams = /* @__PURE__ */ new WeakMap();
 var formFieldElements = /* @__PURE__ */ new WeakMap();
 var pendingWarnings = /* @__PURE__ */ new WeakMap();
 var pendingFillWarnings = /* @__PURE__ */ new WeakMap();
+var lastFilledSnapshot = /* @__PURE__ */ new WeakMap();
 var _inputValueSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "value")?.set;
 var _textareaValueSetter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value")?.set;
 var _checkedSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "checked")?.set;
@@ -894,6 +993,7 @@ function attachSubmitInterceptor(form, toolName) {
     const { resolve } = pending;
     pendingExecutions.delete(form);
     const formData = serializeFormData(form, lastParams.get(form), formFieldElements.get(form));
+    lastFilledSnapshot.delete(form);
     const missing = pendingWarnings.get(form);
     pendingWarnings.delete(form);
     const fillWarnings = pendingFillWarnings.get(form) ?? [];
@@ -912,6 +1012,7 @@ function attachSubmitInterceptor(form, toolName) {
     resolve(result);
   });
   form.addEventListener("reset", () => {
+    lastFilledSnapshot.delete(form);
     window.dispatchEvent(new CustomEvent("toolcancel", { detail: { toolName } }));
   });
 }
@@ -964,16 +1065,30 @@ function findNativeField(form, key) {
 function fillFormFields(form, params) {
   lastParams.set(form, params);
   const fieldEls = formFieldElements.get(form);
+  const snapshot = {};
   for (const [key, value] of Object.entries(params)) {
     const input = findNativeField(form, key);
     if (input) {
       if (input instanceof HTMLInputElement) {
         fillInput(input, form, key, value);
+        if (input.type === "checkbox") {
+          if (Array.isArray(value)) {
+            const esc = CSS.escape(key);
+            snapshot[key] = Array.from(
+              form.querySelectorAll(`input[type="checkbox"][name="${esc}"]`)
+            ).filter((b) => b.checked).map((b) => b.value);
+          } else {
+            snapshot[key] = input.checked;
+          }
+        } else {
+          snapshot[key] = input.value;
+        }
       } else if (input instanceof HTMLTextAreaElement) {
         setReactValue(input, String(value ?? ""));
+        snapshot[key] = input.value;
       } else if (input instanceof HTMLSelectElement) {
-        input.value = String(value ?? "");
-        input.dispatchEvent(new Event("change", { bubbles: true }));
+        fillSelectElement(input, value);
+        snapshot[key] = input.multiple ? Array.from(input.options).filter((o) => o.selected).map((o) => o.value) : input.value;
       }
       continue;
     }
@@ -990,16 +1105,20 @@ function fillFormFields(form, params) {
       }
       if (effectiveEl instanceof HTMLInputElement) {
         fillInput(effectiveEl, form, key, value);
+        snapshot[key] = effectiveEl.type === "checkbox" ? effectiveEl.checked : effectiveEl.value;
       } else if (effectiveEl instanceof HTMLTextAreaElement) {
         setReactValue(effectiveEl, String(value ?? ""));
+        snapshot[key] = effectiveEl.value;
       } else if (effectiveEl instanceof HTMLSelectElement) {
-        effectiveEl.value = String(value ?? "");
-        effectiveEl.dispatchEvent(new Event("change", { bubbles: true }));
+        fillSelectElement(effectiveEl, value);
+        snapshot[key] = effectiveEl.multiple ? Array.from(effectiveEl.options).filter((o) => o.selected).map((o) => o.value) : effectiveEl.value;
       } else {
         fillAriaField(effectiveEl, value);
+        snapshot[key] = value;
       }
     }
   }
+  lastFilledSnapshot.set(form, snapshot);
 }
 function fillInput(input, form, key, value) {
   const type = input.type.toLowerCase();
@@ -1056,6 +1175,18 @@ function fillInput(input, form, key, value) {
   }
   setReactValue(input, String(value ?? ""));
 }
+function fillSelectElement(select, value) {
+  if (select.multiple) {
+    const vals = Array.isArray(value) ? value.map(String) : [String(value ?? "")];
+    for (const opt of Array.from(select.options)) {
+      opt.selected = vals.includes(opt.value);
+    }
+    select.dispatchEvent(new Event("change", { bubbles: true }));
+    return;
+  }
+  select.value = String(value ?? "");
+  select.dispatchEvent(new Event("change", { bubbles: true }));
+}
 function fillAriaField(el, value) {
   const role = el.getAttribute("role");
   if (role === "checkbox" || role === "switch") {
@@ -1094,6 +1225,7 @@ function fillAriaField(el, value) {
 function serializeFormData(form, params, fieldEls) {
   const result = {};
   const data = new FormData(form);
+  const snapshot = lastFilledSnapshot.get(form);
   for (const [key, val] of data.entries()) {
     if (result[key] !== void 0) {
       const existing = result[key];
@@ -1110,6 +1242,10 @@ function serializeFormData(form, params, fieldEls) {
     for (const key of Object.keys(params)) {
       if (key in result)
         continue;
+      if (snapshot && key in snapshot) {
+        result[key] = snapshot[key];
+        continue;
+      }
       const el = findNativeField(form, key) ?? fieldEls?.get(key) ?? null;
       if (!el)
         continue;
@@ -1148,8 +1284,7 @@ function fillElement(el, value) {
   } else if (el instanceof HTMLTextAreaElement) {
     setReactValue(el, String(value ?? ""));
   } else if (el instanceof HTMLSelectElement) {
-    el.value = String(value ?? "");
-    el.dispatchEvent(new Event("change", { bubbles: true }));
+    fillSelectElement(el, value);
   } else {
     fillAriaField(el, value);
   }