@anubhav-choubey/web-for-agents 0.2.0 → 0.3.0

package/README.md

@@ -53,6 +53,8 @@ export function Post() {
 }
 ```
 
+Builders also cover `person`, `softwareApplication`, `profilePage`, `creativeWork`, `webPage` and `graph` (several nodes in one `@graph`); see [Schema builders](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/seo.md#schema-builders).
+
 `robots.ai` is required: the plugin throws if you do not state a policy for both `training` and `search`. Use one `SeoProvider` per document. More in [Head tags and JSON-LD](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/seo.md).
 
 ## What the build produces
@@ -70,6 +72,8 @@ After `vite build`, the plugin crawls from `/` plus `routes` and writes:
 
 Already have your own prerender script? Skip the plugin's prerender and run `npx web-for-agents generate dist --site-url https://example.com --ai-training block --ai-search allow` after it. It adds the same `.md`, `llms.txt`, `robots.txt`, `sitemap.xml` and `agents.json` files to your HTML. See [Using your own prerender](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/prerendering.md#using-your-own-prerender).
 
+Put an "About me" summary, key links or featured projects at the top of `llms.txt` with `llms.intro` and `llms.sections`, and add `<lastmod>` dates to the sitemap with `sitemap: { lastmod: "file" }`. See [Custom sections](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/prerendering.md#custom-sections) and [Sitemap lastmod](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/prerendering.md#sitemap-lastmod).
+
 Files you place in `public/` are never overwritten. Content regions, `holdPrerender`, `hydrateApp`, host fallback configs and memory limits: see [Prerendering](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/prerendering.md).
 
 ## Agent actions
@@ -105,6 +109,8 @@ import { AgentForm, agentParam } from "@anubhav-choubey/web-for-agents";
 </AgentForm>
 ```
 
+Plain links work too, without JavaScript: `<a href="/resume.pdf" data-agent-action="open_resume" data-agent-description="Open the resume">` (or `agentLinkProps`) is listed in `agents.json` as a `link` action. See [Link actions](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/agent-actions.md#link-actions-no-javascript).
+
 Agents can never reach hidden, password, file, disabled or `readonly` fields, or fields hidden by markup. Full API, confirm dialog and field rules: [Agent actions](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/agent-actions.md).
 
 ## CLI
@@ -115,7 +121,7 @@ Audit any URL for AI-agent readiness, with nothing installed in the target site:
 npx @anubhav-choubey/web-for-agents audit https://example.com --min-score 80
 ```
 
-It scores 0 to 100 across content without JavaScript, JSON-LD, robots.txt, title, meta description, sitemap, Open Graph, llms.txt, the markdown copy, canonical URL and the agent map, and prints a `Fix:` line for each miss. Flags, weights and JSON output: [CLI](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/cli.md).
+It scores 0 to 100 across content without JavaScript, JSON-LD, robots.txt, title, meta description, sitemap, Open Graph, llms.txt, the markdown copy, canonical URL and the agent map, and prints a `Fix:` line for each miss. The JSON-LD check names missing required rich-result fields (Product, BreadcrumbList, Event, SoftwareApplication and more). Flags, weights and JSON output: [CLI](https://github.com/LazyyVenom/Web-For-Agents/blob/master/docs/cli.md).
 
 ## Dev overlay
 

package/dist/bin.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-P6JSPAA2.js";
+} from "./chunk-357ATBMS.js";
 import "./chunk-CGIIB6AF.js";
-import "./chunk-PHTV5NAY.js";
-import "./chunk-LCLDQ3A3.js";
-import "./chunk-FEAKVNMG.js";
-import "./chunk-F7PN5R25.js";
+import "./chunk-L3AYWCSX.js";
+import "./chunk-MIVGE5TM.js";
+import "./chunk-4STTPCBR.js";
+import "./chunk-2Y3LLYEC.js";
 import "./chunk-JJN6FNJD.js";
 
 // src/cli/bin.ts

package/dist/{chunk-F7PN5R25.js → chunk-2Y3LLYEC.js}

@@ -60,6 +60,7 @@ var WEBMCP_TOOLNAME_ATTR = "toolname";
 var WEBMCP_TOOLDESCRIPTION_ATTR = "tooldescription";
 var WEBMCP_TOOLPARAMDESCRIPTION_ATTR = "toolparamdescription";
 var AGENT_GLOBAL = "__WEB_FOR_AGENTS__";
+var LINK_ACTION_SELECTOR = `a[href][${ACTION_ATTR}]`;
 
 export {
   normalizeRoute,
@@ -91,5 +92,6 @@ export {
   WEBMCP_TOOLNAME_ATTR,
   WEBMCP_TOOLDESCRIPTION_ATTR,
   WEBMCP_TOOLPARAMDESCRIPTION_ATTR,
-  AGENT_GLOBAL
+  AGENT_GLOBAL,
+  LINK_ACTION_SELECTOR
 };

package/dist/{chunk-P6JSPAA2.js → chunk-357ATBMS.js}

@@ -3,18 +3,21 @@ import {
   scanHtml
 } from "./chunk-CGIIB6AF.js";
 import {
-  AGENT_MAP_VERSION,
   DESCRIPTION_MAX_CHARS,
   DESCRIPTION_MIN_CHARS,
   TITLE_MAX_CHARS
-} from "./chunk-PHTV5NAY.js";
+} from "./chunk-L3AYWCSX.js";
 import {
-  jsonLdTypes
-} from "./chunk-LCLDQ3A3.js";
+  MAX_JSON_LD_NODES,
+  jsonLdNodes,
+  jsonLdTypes,
+  nodeTypes
+} from "./chunk-MIVGE5TM.js";
 import {
+  AGENT_MAP_VERSION,
   collapseWhitespace,
   stripBom
-} from "./chunk-FEAKVNMG.js";
+} from "./chunk-4STTPCBR.js";
 import {
   AGENT_MAP_PATH,
   LLMS_TXT_PATH,
@@ -26,12 +29,177 @@ import {
   markdownPathFor,
   trimTrailingSlash,
   tryResolveUrl
-} from "./chunk-F7PN5R25.js";
+} from "./chunk-2Y3LLYEC.js";
 import {
   errorMessage,
   withPrefix
 } from "./chunk-JJN6FNJD.js";
 
+// src/shared/schemaRules.ts
+var DOCS = "https://developers.google.com/search/docs/appearance/structured-data/";
+var req = (...anyOf) => ({ anyOf });
+var ARTICLE = {
+  docs: `${DOCS}article`,
+  required: [],
+  recommended: ["author", "author.name", "author.url", "dateModified", "datePublished", "headline", "image"]
+};
+var SOFTWARE_APPLICATION = {
+  docs: `${DOCS}software-app`,
+  required: [req("name"), req("offers"), req("aggregateRating", "review")],
+  recommended: ["applicationCategory", "operatingSystem"],
+  nested: [{ prop: "offers", whenType: ["Offer"], orUntyped: true, required: [req("price")] }]
+};
+var SCHEMA_RULES = {
+  Article: ARTICLE,
+  NewsArticle: ARTICLE,
+  BlogPosting: ARTICLE,
+  BreadcrumbList: {
+    docs: `${DOCS}breadcrumb`,
+    required: [req("itemListElement")],
+    recommended: [],
+    nested: [
+      {
+        prop: "itemListElement",
+        required: [req("position"), req("name", "item.name"), { anyOf: ["item"], exceptLast: true }]
+      }
+    ]
+  },
+  Event: {
+    docs: `${DOCS}event`,
+    required: [req("name"), req("startDate"), req("location")],
+    recommended: ["description", "endDate", "eventStatus", "image", "location.name", "offers", "organizer", "performer"],
+    nested: [{ prop: "location", whenType: ["Place"], required: [req("address")] }]
+  },
+  FAQPage: {
+    docs: `${DOCS}faqpage`,
+    required: [req("mainEntity")],
+    recommended: [],
+    nested: [
+      {
+        prop: "mainEntity",
+        required: [req("name"), req("acceptedAnswer")],
+        nested: [{ prop: "acceptedAnswer", required: [req("text")] }]
+      }
+    ],
+    note: "Google no longer shows FAQ rich results; answer engines may still use it",
+    retired: true
+  },
+  Organization: {
+    docs: `${DOCS}organization`,
+    required: [],
+    recommended: ["name", "url", "logo", "description", "sameAs", "address", "contactPoint", "email", "telephone"]
+  },
+  Person: {
+    docs: `${DOCS}profile-page`,
+    required: [],
+    recommended: ["name", "alternateName", "description", "identifier", "image", "sameAs"]
+  },
+  ProfilePage: {
+    docs: `${DOCS}profile-page`,
+    required: [req("mainEntity")],
+    recommended: ["dateCreated", "dateModified"],
+    nested: [{ prop: "mainEntity", required: [req("name", "alternateName")] }]
+  },
+  Product: {
+    docs: `${DOCS}product-snippet`,
+    required: [req("name"), req("offers", "aggregateRating", "review")],
+    recommended: ["aggregateRating", "offers", "review", "offers.priceCurrency", "offers.availability"],
+    nested: [
+      { prop: "offers", whenType: ["Offer"], orUntyped: true, required: [req("price", "priceSpecification.price")] },
+      { prop: "offers", whenType: ["AggregateOffer"], required: [req("lowPrice"), req("priceCurrency")] }
+    ]
+  },
+  Recipe: {
+    docs: `${DOCS}recipe`,
+    required: [req("name"), req("image")],
+    recommended: ["author", "datePublished", "description", "recipeIngredient", "recipeInstructions", "totalTime"]
+  },
+  SoftwareApplication: SOFTWARE_APPLICATION,
+  MobileApplication: SOFTWARE_APPLICATION,
+  WebApplication: SOFTWARE_APPLICATION,
+  WebSite: {
+    docs: "https://developers.google.com/search/docs/appearance/site-names",
+    required: [req("name"), req("url")],
+    recommended: ["alternateName"]
+  }
+};
+function present(v) {
+  if (v === void 0 || v === null) return false;
+  if (typeof v === "string") return v.trim() !== "";
+  if (Array.isArray(v)) return v.length > 0;
+  return true;
+}
+var isObject = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+function hasPath(node, path2) {
+  let level = [node];
+  for (const key of path2.split(".")) {
+    const next = [];
+    for (const v of level) {
+      for (const o of Array.isArray(v) ? v : [v]) if (isObject(o) && present(o[key])) next.push(o[key]);
+    }
+    if (next.length === 0) return false;
+    level = next;
+  }
+  return true;
+}
+function resolveRef(o, byId) {
+  const keys = Object.keys(o);
+  if (keys.length !== 1 || keys[0] !== "@id") return o;
+  return typeof o["@id"] === "string" ? byId.get(o["@id"]) ?? null : null;
+}
+var label = (prefix, anyOf) => prefix + anyOf[0] + (anyOf.length > 1 ? ` (or ${anyOf.slice(1).join(", ")})` : "");
+function checkSchemaNodes(nodes, limit = Infinity) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const n of nodes) if (typeof n["@id"] === "string" && !byId.has(n["@id"])) byId.set(n["@id"], n);
+  const scoredIssues = [];
+  const retiredIssues = [];
+  let total = 0;
+  let scored = 0;
+  let budget = MAX_JSON_LD_NODES;
+  const report = (type, path2) => {
+    total++;
+    const retired = SCHEMA_RULES[type].retired === true;
+    if (!retired) scored++;
+    const list = retired ? retiredIssues : scoredIssues;
+    if (list.length < limit) list.push({ type, path: path2 });
+  };
+  const apply = (type, node, prefix, required, nested, isLast) => {
+    for (const r of required) {
+      if (r.exceptLast && isLast) continue;
+      if (!r.anyOf.some((p) => hasPath(node, p))) report(type, label(prefix, r.anyOf));
+    }
+    for (const n of nested ?? []) {
+      const v = node[n.prop];
+      const items = Array.isArray(v) ? v : [v];
+      for (let i = 0; i < items.length; i++) {
+        if (--budget < 0) return;
+        const raw = items[i];
+        if (!isObject(raw)) continue;
+        const child = resolveRef(raw, byId);
+        if (child === null) continue;
+        if (n.whenType !== void 0) {
+          const types = nodeTypes(child);
+          const matches2 = types.length === 0 ? n.orUntyped === true : types.some((t) => n.whenType.includes(t));
+          if (!matches2) continue;
+        }
+        const at = `${prefix}${n.prop}${Array.isArray(v) ? `[${i}]` : ""}.`;
+        apply(type, child, at, n.required, n.nested, i === items.length - 1);
+      }
+    }
+  };
+  for (const node of nodes) {
+    if (--budget < 0) break;
+    const seen = /* @__PURE__ */ new Set();
+    for (const type of nodeTypes(node)) {
+      const rule = Object.hasOwn(SCHEMA_RULES, type) ? SCHEMA_RULES[type] : void 0;
+      if (rule === void 0 || seen.has(rule)) continue;
+      seen.add(rule);
+      apply(type, node, "", rule.required, rule.nested, true);
+    }
+  }
+  return { issues: [...scoredIssues, ...retiredIssues].slice(0, limit), total, scored };
+}
+
 // src/cli/privateAddress.ts
 import { lookup } from "dns/promises";
 import { BlockList, isIP } from "net";
@@ -83,10 +251,10 @@ function abortable(p, signal) {
   });
 }
 function decode(bytes, contentType) {
-  const label = /charset\s*=\s*"?([^;"\s]+)/i.exec(contentType)?.[1] ?? "utf-8";
+  const label2 = /charset\s*=\s*"?([^;"\s]+)/i.exec(contentType)?.[1] ?? "utf-8";
   let decoder;
   try {
-    decoder = new TextDecoder(label);
+    decoder = new TextDecoder(label2);
   } catch (e) {
     if (!(e instanceof RangeError)) throw e;
     decoder = new TextDecoder("utf-8");
@@ -479,6 +647,7 @@ var CHECK_WEIGHTS = {
 };
 var CONTENT_MIN_CHARS = 200;
 var CONTENT_WARN_CHARS = 50;
+var SCHEMA_ISSUES_SHOWN = 3;
 var MAX_BODY_LABEL = `${MAX_BODY_BYTES / (1024 * 1024)} MiB`;
 var TITLES = {
   content: "Content without JavaScript",
@@ -601,7 +770,32 @@ function checkJsonLd({ html }) {
   if (!parsed.some((p) => jsonLdTypes(p).length > 0)) {
     return warn("JSON-LD parses but has no @type", "Add an @type (for example Organization) to your JSON-LD.");
   }
-  return pass(`${parsed.length} JSON-LD block${parsed.length === 1 ? " parses" : "s parse"} with an @type`);
+  const { issues, total, scored } = checkSchemaNodes(parsed.flatMap(jsonLdNodes), SCHEMA_ISSUES_SHOWN);
+  const base = `${parsed.length} JSON-LD block${parsed.length === 1 ? " parses" : "s parse"} with an @type`;
+  if (total === 0) return pass(base);
+  const isRetired = (i) => SCHEMA_RULES[i.type].retired === true;
+  const shownScored = issues.filter((i) => !isRetired(i));
+  const shownRetired = issues.filter(isRetired);
+  const retiredNote = notScored(shownRetired, total - scored - shownRetired.length);
+  if (scored === 0) return pass(`${base}; ${retiredNote}`);
+  const moreScored = scored - shownScored.length;
+  const rules = [...new Set(shownScored.map((i) => SCHEMA_RULES[i.type]))];
+  return warn(
+    `Missing required structured data fields: ${shownScored.map((i) => `${i.type} ${i.path}`).join("; ")}` + (moreScored > 0 ? `; +${moreScored} more` : "") + (total > scored ? `. ${retiredNote}` : ""),
+    `Add the missing properties; Google requires them for rich results (${rules.map((r) => r.docs).join(", ")}).`
+  );
+}
+var RETIRED_RULES = [...new Set(Object.values(SCHEMA_RULES))].filter((r) => r.retired === true);
+var retiredNotes = (rules) => rules.flatMap((r) => r.note !== void 0 ? [r.note] : []).join("; ");
+function notScored(shown, more) {
+  if (shown.length === 0) {
+    return `+${more} more not scored (${retiredNotes(RETIRED_RULES)})`;
+  }
+  const byType = /* @__PURE__ */ new Map();
+  for (const i of shown) byType.set(i.type, [...byType.get(i.type) ?? [], i.path]);
+  const listed = [...byType].map(([type, paths]) => `${type}: ${paths.join(", ")}`).join("; ");
+  const notes = retiredNotes([...new Set(shown.map((i) => SCHEMA_RULES[i.type]))]);
+  return `${listed}${more > 0 ? `, +${more} more` : ""} missing${notes ? ` (${notes})` : ""}`;
 }
 function checkRobots({ page, robots }) {
   const missingFix = `Add ${ROBOTS_PATH}; webForAgents() generates one from robots.ai.training / robots.ai.search.`;
@@ -1016,7 +1210,7 @@ function safeJson(value, space) {
 // src/cli/generate.ts
 var VITE_ENTRY = "@anubhav-choubey/web-for-agents/vite";
 var clean = (s) => s.split("\n").map((l) => safeText(l, Infinity)).join("\n");
-var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 async function loadConfig(file) {
   const abs = path.resolve(file);
   if (!existsSync(abs)) throw new Error(withPrefix(`config file not found: ${abs}`));
@@ -1028,13 +1222,13 @@ async function loadConfig(file) {
   } catch (e) {
     throw new Error(withPrefix(`could not load config ${abs}: ${errorMessage(e)}`), { cause: e });
   }
-  if (!isObject(config)) throw new Error(withPrefix(`config ${abs} must export an options object`));
+  if (!isObject2(config)) throw new Error(withPrefix(`config ${abs} must export an options object`));
   return config;
 }
 async function generateOptions(args) {
   const config = args.config ? await loadConfig(args.config) : {};
-  const robots = isObject(config.robots) ? config.robots : {};
-  const ai = { ...isObject(robots.ai) ? robots.ai : {} };
+  const robots = isObject2(config.robots) ? config.robots : {};
+  const ai = { ...isObject2(robots.ai) ? robots.ai : {} };
   if (args.aiTraining) ai.training = args.aiTraining;
   if (args.aiSearch) ai.search = args.aiSearch;
   if (ai.training === void 0 || ai.search === void 0) {

package/dist/chunk-4STTPCBR.js

@@ -0,0 +1,25 @@
+// src/shared/agent.ts
+var ACTION_NAME_RE = /^[A-Za-z0-9_.-]{1,128}$/;
+function isValidActionName(name) {
+  return typeof name === "string" && ACTION_NAME_RE.test(name);
+}
+var ACTION_NAME_RULE = "use 1-128 chars of A-Z a-z 0-9 _ - .";
+var AGENT_GLOBAL_VERSION = 1;
+var AGENT_MAP_VERSION = 1;
+
+// src/shared/text.ts
+function collapseWhitespace(s) {
+  return (s ?? "").replace(/\s+/g, " ").trim();
+}
+function stripBom(s) {
+  return s.charCodeAt(0) === 65279 ? s.slice(1) : s;
+}
+
+export {
+  isValidActionName,
+  ACTION_NAME_RULE,
+  AGENT_GLOBAL_VERSION,
+  AGENT_MAP_VERSION,
+  collapseWhitespace,
+  stripBom
+};

package/dist/{chunk-SMFRAZAA.js → chunk-K3B53RIO.js}

@@ -1,6 +1,6 @@
 import {
   READY_GLOBAL
-} from "./chunk-F7PN5R25.js";
+} from "./chunk-2Y3LLYEC.js";
 import {
   POLL_MS,
   RenderError,

package/dist/{chunk-PHTV5NAY.js → chunk-L3AYWCSX.js}

@@ -25,20 +25,9 @@ function metaLengthWarnings(pages) {
   return out;
 }
 
-// src/shared/agent.ts
-var ACTION_NAME_RE = /^[A-Za-z0-9_.-]{1,128}$/;
-function isValidActionName(name) {
-  return typeof name === "string" && ACTION_NAME_RE.test(name);
-}
-var AGENT_GLOBAL_VERSION = 1;
-var AGENT_MAP_VERSION = 1;
-
 export {
   TITLE_MAX_CHARS,
   DESCRIPTION_MIN_CHARS,
   DESCRIPTION_MAX_CHARS,
-  metaLengthWarnings,
-  isValidActionName,
-  AGENT_GLOBAL_VERSION,
-  AGENT_MAP_VERSION
+  metaLengthWarnings
 };

package/dist/chunk-MIVGE5TM.js

@@ -0,0 +1,34 @@
+// src/shared/jsonLd.ts
+var MAX_JSON_LD_NODES = 1e5;
+function jsonLdNodes(value) {
+  const out = [];
+  const stack = [value];
+  for (let visited = 0; stack.length > 0 && visited < MAX_JSON_LD_NODES; visited++) {
+    const v = stack.pop();
+    if (Array.isArray(v)) {
+      for (let i = v.length - 1; i >= 0; i--) stack.push(v[i]);
+      continue;
+    }
+    if (v === null || typeof v !== "object") continue;
+    const o = v;
+    out.push(o);
+    if ("@graph" in o) stack.push(o["@graph"]);
+  }
+  return out;
+}
+function nodeTypes(node) {
+  const t = node["@type"];
+  if (typeof t === "string") return [t];
+  if (Array.isArray(t)) return t.filter((x) => typeof x === "string");
+  return [];
+}
+function jsonLdTypes(value) {
+  return jsonLdNodes(value).flatMap(nodeTypes);
+}
+
+export {
+  MAX_JSON_LD_NODES,
+  jsonLdNodes,
+  nodeTypes,
+  jsonLdTypes
+};

package/dist/{chunk-LCVPXUFN.js → chunk-OKCYZE6C.js}

@@ -1,11 +1,11 @@
 import {
   collapseWhitespace
-} from "./chunk-FEAKVNMG.js";
+} from "./chunk-4STTPCBR.js";
 import {
   ACTION_PARAM_ATTR,
   HIDDEN_SELECTOR,
   WEBMCP_TOOLPARAMDESCRIPTION_ATTR
-} from "./chunk-F7PN5R25.js";
+} from "./chunk-2Y3LLYEC.js";
 
 // src/shared/object.ts
 var hasOwn = (o, k) => Object.prototype.hasOwnProperty.call(o, k);

package/dist/{chunk-PSNLS4GL.js → chunk-T42S3WRV.js}

@@ -1,6 +1,8 @@
 import {
-  collapseWhitespace
-} from "./chunk-FEAKVNMG.js";
+  ACTION_NAME_RULE,
+  collapseWhitespace,
+  isValidActionName
+} from "./chunk-4STTPCBR.js";
 import {
   ACTION_ATTR,
   ACTION_DESCRIPTION_ATTR,
@@ -8,10 +10,12 @@ import {
   CONTENT_ATTR,
   EXCLUDE_ATTR,
   HIDDEN_SELECTOR,
+  LINK_ACTION_SELECTOR,
   WEBMCP_TOOLDESCRIPTION_ATTR,
   WEBMCP_TOOLNAME_ATTR,
-  resolveUrl
-} from "./chunk-F7PN5R25.js";
+  resolveUrl,
+  tryResolveUrl
+} from "./chunk-2Y3LLYEC.js";
 
 // src/shared/shortcut.ts
 var DEFAULT_SHORTCUT = "alt+shift+a";
@@ -42,6 +46,89 @@ function matchesShortcut(e, s) {
   return e.code === s.code && e.altKey === s.alt && e.shiftKey === s.shift && e.ctrlKey === s.ctrl && e.metaKey === s.meta;
 }
 
+// src/shared/markupActions.ts
+function markupActions(doc) {
+  const out = [];
+  doc.querySelectorAll(`[${ACTION_ATTR}]`).forEach((el) => {
+    const name = el.getAttribute(ACTION_ATTR)?.trim();
+    if (!name) return;
+    const link = el.matches(LINK_ACTION_SELECTOR);
+    out.push({
+      element: el,
+      name,
+      description: el.getAttribute(ACTION_DESCRIPTION_ATTR) || null,
+      kind: el.tagName === "FORM" ? "form" : link ? "link" : "click",
+      destructive: el.getAttribute(ACTION_DESTRUCTIVE_ATTR) === "true",
+      source: "markup",
+      ...link ? { href: el.getAttribute("href") ?? "" } : {}
+    });
+  });
+  doc.querySelectorAll(`form[${WEBMCP_TOOLNAME_ATTR}]`).forEach((el) => {
+    const name = el.getAttribute(WEBMCP_TOOLNAME_ATTR)?.trim();
+    if (!name) return;
+    out.push({
+      element: el,
+      name,
+      description: el.getAttribute(WEBMCP_TOOLDESCRIPTION_ATTR) || null,
+      kind: "form",
+      destructive: false,
+      source: "webmcp-declarative"
+    });
+  });
+  return out;
+}
+function markupLinks(doc) {
+  return markupActions(doc).flatMap(
+    (a) => a.kind === "link" ? [{ name: a.name, description: a.description, destructive: a.destructive, href: a.href ?? "" }] : []
+  );
+}
+var LINK_ACTION_PROTOCOLS = ["http:", "https:", "mailto:", "tel:"];
+function resolveLinkHref(href, pageUrl) {
+  const url = tryResolveUrl(href, pageUrl);
+  if (url === null) return { ok: false, reason: "its href is not a valid URL" };
+  const protocol = new URL(url).protocol;
+  if (!LINK_ACTION_PROTOCOLS.includes(protocol)) {
+    return { ok: false, reason: `${protocol} links are not allowed (only http(s), mailto: and tel:)` };
+  }
+  return { ok: true, href: url };
+}
+var INVALID_NAME_REASON = `invalid name (${ACTION_NAME_RULE})`;
+function firstPerName(...groups) {
+  const seen = /* @__PURE__ */ new Set();
+  return groups.flat().filter((a) => !seen.has(a.name) && !!seen.add(a.name));
+}
+function actionGroups(markup) {
+  return [markup.filter((a) => a.kind !== "link"), markup.filter((a) => a.kind === "link")];
+}
+function linkActions(links, opts, warn) {
+  const seen = new Set(opts.taken);
+  const out = [];
+  for (const link of links) {
+    if (seen.has(link.name)) continue;
+    seen.add(link.name);
+    if (!isValidActionName(link.name)) {
+      warn(`link action "${link.name}" on ${opts.page} skipped: ${INVALID_NAME_REASON}`);
+      continue;
+    }
+    const r = resolveLinkHref(link.href, opts.pageUrl);
+    if (!r.ok) {
+      warn(`link action "${link.name}" on ${opts.page} skipped: ${r.reason}`);
+      continue;
+    }
+    out.push({
+      name: link.name,
+      description: link.description?.trim() || link.name,
+      inputSchema: { type: "object", properties: {}, additionalProperties: false },
+      destructive: link.destructive,
+      readOnly: !link.destructive,
+      kind: "link",
+      href: r.href,
+      .../^https?:$/.test(new URL(r.href).protocol) ? { method: "GET" } : {}
+    });
+  }
+  return out;
+}
+
 // src/shared/content.ts
 var DEFAULT_CONTENT_SELECTOR = "main";
 var STRIP = `script, style, noscript, template, nav, [${EXCLUDE_ATTR}], ${HIDDEN_SELECTOR}`;
@@ -167,37 +254,14 @@ function buildPageMarkdown(title, contentHtml, pageUrl) {
 ${body}`.replace(/\n+$/, "\n");
 }
 
-// src/shared/markupActions.ts
-function markupActions(doc) {
-  const out = [];
-  doc.querySelectorAll(`[${ACTION_ATTR}]`).forEach((el) => {
-    const name = el.getAttribute(ACTION_ATTR)?.trim();
-    if (!name) return;
-    out.push({
-      element: el,
-      name,
-      description: el.getAttribute(ACTION_DESCRIPTION_ATTR) || null,
-      kind: el.tagName === "FORM" ? "form" : "click",
-      destructive: el.getAttribute(ACTION_DESTRUCTIVE_ATTR) === "true",
-      source: "markup"
-    });
-  });
-  doc.querySelectorAll(`form[${WEBMCP_TOOLNAME_ATTR}]`).forEach((el) => {
-    const name = el.getAttribute(WEBMCP_TOOLNAME_ATTR)?.trim();
-    if (!name) return;
-    out.push({
-      element: el,
-      name,
-      description: el.getAttribute(WEBMCP_TOOLDESCRIPTION_ATTR) || null,
-      kind: "form",
-      destructive: false,
-      source: "webmcp-declarative"
-    });
-  });
-  return out;
-}
-
 export {
+  markupActions,
+  markupLinks,
+  resolveLinkHref,
+  INVALID_NAME_REASON,
+  firstPerName,
+  actionGroups,
+  linkActions,
   DEFAULT_CONTENT_SELECTOR,
   selectContentRegion,
   DEFAULT_SHORTCUT,
@@ -206,6 +270,5 @@ export {
   readPageMeta,
   escapeMarkdownInline,
   escapeLinkTarget,
-  buildPageMarkdown,
-  markupActions
+  buildPageMarkdown
 };

package/dist/cli.js

@@ -2,12 +2,12 @@ import {
   audit,
   formatText,
   runCli
-} from "./chunk-P6JSPAA2.js";
+} from "./chunk-357ATBMS.js";
 import "./chunk-CGIIB6AF.js";
-import "./chunk-PHTV5NAY.js";
-import "./chunk-LCLDQ3A3.js";
-import "./chunk-FEAKVNMG.js";
-import "./chunk-F7PN5R25.js";
+import "./chunk-L3AYWCSX.js";
+import "./chunk-MIVGE5TM.js";
+import "./chunk-4STTPCBR.js";
+import "./chunk-2Y3LLYEC.js";
 import "./chunk-JJN6FNJD.js";
 export {
   audit,

package/dist/{happyDom-WTYQ5UAC.js → happyDom-ZEFNMD7B.js}

@@ -2,8 +2,8 @@ import {
   createHappyDomRenderer,
   syncHint,
   syncRefusalText
-} from "./chunk-SMFRAZAA.js";
-import "./chunk-F7PN5R25.js";
+} from "./chunk-K3B53RIO.js";
+import "./chunk-2Y3LLYEC.js";
 import "./chunk-PGZH33B5.js";
 import "./chunk-JJN6FNJD.js";
 export {