auto-webmcp 0.2.10 → 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 {
     }
   }
@@ -340,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");
@@ -437,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 = [];
@@ -472,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);
@@ -488,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);
@@ -610,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"];
@@ -648,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"];
   }