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

package/dist/vite.js

@@ -1,31 +1,35 @@
 import {
   EMPTY_OBJECT_SCHEMA,
   schemaFromForm
-} from "./chunk-LCVPXUFN.js";
+} from "./chunk-OKCYZE6C.js";
 import {
   AI_BOTS,
   scanHtml
 } from "./chunk-CGIIB6AF.js";
 import {
-  AGENT_MAP_VERSION,
-  isValidActionName,
   metaLengthWarnings
-} from "./chunk-PHTV5NAY.js";
+} from "./chunk-L3AYWCSX.js";
 import {
   DEFAULT_CONTENT_SELECTOR,
   DEFAULT_SHORTCUT,
   buildPageMarkdown,
   escapeLinkTarget,
   escapeMarkdownInline,
+  firstPerName,
+  linkActions,
   markupActions,
+  markupLinks,
   parseShortcut,
   readPageMeta,
   selectContentRegion
-} from "./chunk-PSNLS4GL.js";
+} from "./chunk-T42S3WRV.js";
 import {
   compareStrings
 } from "./chunk-AAIYCJD3.js";
-import "./chunk-FEAKVNMG.js";
+import {
+  AGENT_MAP_VERSION,
+  isValidActionName
+} from "./chunk-4STTPCBR.js";
 import {
   IDLE_MS,
   PROBE_ATTR,
@@ -33,12 +37,16 @@ import {
   TEMP_BASE_ATTR,
   prepareShell,
   readyCheck
-} from "./chunk-SMFRAZAA.js";
+} from "./chunk-K3B53RIO.js";
 import {
+  ACTION_ATTR,
+  ACTION_DESCRIPTION_ATTR,
+  ACTION_DESTRUCTIVE_ATTR,
   AGENT_GLOBAL,
   AGENT_MAP_PATH,
   CONTENT_ATTR,
   HEAD_OWNED_ATTR,
+  LINK_ACTION_SELECTOR,
   LLMS_FULL_TXT_PATH,
   LLMS_TXT_PATH,
   MARKDOWN_LINK_KEY,
@@ -51,8 +59,9 @@ import {
   mountPath,
   normalizeRoute,
   publicUrl,
-  trimTrailingSlash
-} from "./chunk-F7PN5R25.js";
+  trimTrailingSlash,
+  tryResolveUrl
+} from "./chunk-2Y3LLYEC.js";
 import {
   POLL_MS,
   RenderError,
@@ -179,14 +188,32 @@ var WEBMCP_INFO = {
   api: "document.modelContext",
   spec: "https://webmachinelearning.github.io/webmcp/"
 };
-function collectAgentPageInPage(globalKey) {
-  const api = window[globalKey];
-  return { actions: api && typeof api.actions === "function" ? api.actions() : [] };
+var AGENT_PAGE_IN_PAGE_ARG = {
+  globalKey: AGENT_GLOBAL,
+  linkSelector: LINK_ACTION_SELECTOR,
+  nameAttr: ACTION_ATTR,
+  descriptionAttr: ACTION_DESCRIPTION_ATTR,
+  destructiveAttr: ACTION_DESTRUCTIVE_ATTR
+};
+function collectAgentPageInPage(arg) {
+  const api = window[arg.globalKey];
+  const actions = api && typeof api.actions === "function" ? api.actions() : [];
+  const links = [];
+  document.querySelectorAll(arg.linkSelector).forEach((el) => {
+    const name = (el.getAttribute(arg.nameAttr) || "").trim();
+    if (!name) return;
+    links.push({
+      name,
+      description: el.getAttribute(arg.descriptionAttr) || null,
+      destructive: el.getAttribute(arg.destructiveAttr) === "true",
+      href: el.getAttribute("href") || ""
+    });
+  });
+  return { actions, links };
 }
 var byName = (a, b) => compareStrings(a.name, b.name);
 function toPage(siteUrl, p) {
-  const seen = /* @__PURE__ */ new Set();
-  const actions = p.actions.filter((a) => !seen.has(a.name) && !!seen.add(a.name)).sort(byName);
+  const actions = firstPerName(p.actions).sort(byName);
   return {
     path: p.route,
     url: publicUrl(siteUrl, p.route),
@@ -223,14 +250,21 @@ function agentMapExtension(opts) {
   return {
     name: "agent-map",
     inPage: collectAgentPageInPage,
-    inPageArg: AGENT_GLOBAL,
+    inPageArg: AGENT_PAGE_IN_PAGE_ARG,
     onRoute(route, page) {
       data.set(route, page);
     },
     llmsSections: () => [agentMapLlmsSection(siteUrl, fileName)],
     finalize(ctx) {
       const pages = ctx.pages.map((p) => {
-        const page = { route: p.route, actions: data.get(p.route)?.actions ?? [] };
+        const found = data.get(p.route);
+        const actions = found?.actions ?? [];
+        const links = linkActions(
+          found?.links ?? [],
+          { pageUrl: p.url, page: p.route, taken: new Set(actions.map((a) => a.name)) },
+          ctx.warn
+        );
+        const page = { route: p.route, actions: [...actions, ...links] };
         if (p.title) page.title = p.title;
         if (p.description) page.description = p.description;
         if (p.mdUrl) page.markdown = p.mdUrl;
@@ -371,7 +405,7 @@ function nodeModulesRoot(file) {
 }
 var sourceEntry;
 async function childEntryFile() {
-  const { CHILD_ENTRY } = await import("./renderChild-H6TR4SGV.js");
+  const { CHILD_ENTRY } = await import("./renderChild-PSQLAIUW.js");
   const file = fileURLToPath(CHILD_ENTRY);
   if (!file.endsWith(".ts")) return file;
   return sourceEntry ??= bundleFromSource(file);
@@ -795,6 +829,75 @@ function resolveMarkdown(input) {
   }
   return out;
 }
+function resolveSitemap(input) {
+  if (input === void 0 || typeof input === "boolean") return { sitemap: input ?? true, sitemapLastmod: "none" };
+  if (typeof input !== "object" || input === null || Array.isArray(input)) {
+    throw new Error(withPrefix("sitemap must be a boolean or { lastmod }"));
+  }
+  const lastmod = input.lastmod ?? "none";
+  if (lastmod !== "file" && lastmod !== "none" && typeof lastmod !== "function") {
+    throw new Error(withPrefix('sitemap.lastmod must be "file", "none" or a function'));
+  }
+  return { sitemap: true, sitemapLastmod: lastmod };
+}
+function resolveLlms(input, siteUrl) {
+  if (input === void 0) return {};
+  if (typeof input !== "object" || input === null || Array.isArray(input)) {
+    throw new Error(withPrefix("llms must be false or { title, description, intro, sections }"));
+  }
+  const str = (v, field, nonEmpty = false) => {
+    if (v === void 0) return void 0;
+    if (typeof v !== "string" || nonEmpty && v.trim() === "") {
+      throw new Error(withPrefix(`llms.${field} must be a ${nonEmpty ? "non-empty " : ""}string`));
+    }
+    return v;
+  };
+  const out = { ...input };
+  str(input.title, "title");
+  str(input.description, "description");
+  str(input.intro, "intro");
+  if (input.sections === void 0) return out;
+  if (!Array.isArray(input.sections)) throw new Error(withPrefix("llms.sections must be an array"));
+  out.sections = input.sections.map((sec, i) => {
+    const at = `sections[${i}]`;
+    if (typeof sec !== "object" || sec === null || Array.isArray(sec)) {
+      throw new Error(withPrefix(`llms.${at} must be an object such as { title, text, links }`));
+    }
+    const { title, text, links } = sec;
+    if (title === void 0) throw new Error(withPrefix(`llms.${at}.title is required`));
+    const s = { title: str(title, `${at}.title`, true) };
+    const t = str(text, `${at}.text`);
+    if (t !== void 0) s.text = t;
+    if (links !== void 0) {
+      if (!Array.isArray(links)) throw new Error(withPrefix(`llms.${at}.links must be an array`));
+      s.links = links.map((l, j) => {
+        const lat = `${at}.links[${j}]`;
+        if (typeof l !== "object" || l === null || Array.isArray(l)) {
+          throw new Error(withPrefix(`llms.${lat} must be an object such as { title, url, description }`));
+        }
+        const link = l;
+        if (link.title === void 0) throw new Error(withPrefix(`llms.${lat}.title is required`));
+        if (link.url === void 0) throw new Error(withPrefix(`llms.${lat}.url is required`));
+        const url = typeof link.url === "string" ? tryResolveUrl(link.url.trim(), siteUrl + "/") : null;
+        const scheme = url === null ? "" : new URL(url).protocol;
+        if (url === null || !["http:", "https:", "mailto:"].includes(scheme)) {
+          throw new Error(
+            withPrefix(`llms.${lat}.url must be an http(s) or mailto: URL, or a path on the site (got ${JSON.stringify(link.url)})`)
+          );
+        }
+        const o = { title: str(link.title, `${lat}.title`, true), url };
+        const d = str(link.description, `${lat}.description`);
+        if (d !== void 0) o.description = d;
+        return o;
+      });
+    }
+    if (!s.text?.trim() && !s.links?.length) {
+      throw new Error(withPrefix(`llms.${at} needs text or links`));
+    }
+    return s;
+  });
+  return out;
+}
 var AGENT_MAP_FILE = /^[A-Za-z0-9_.-]+\.json$/;
 function resolveAgentMap(input) {
   if (input === false) return false;
@@ -870,6 +973,7 @@ function resolveOptions(input) {
   const prerender = input.prerender === false ? false : resolvePrerender(input.prerender ?? {});
   let markdown = false;
   let llms = false;
+  const requestedLlms = input.llms === false ? false : resolveLlms(input.llms, siteUrl);
   const requestedAgentMap = resolveAgentMap(input.agentMap);
   let agentMap = false;
   if (prerender === false) {
@@ -881,14 +985,14 @@ function resolveOptions(input) {
     }
   } else {
     if (input.markdown !== false) markdown = resolveMarkdown(input.markdown);
-    if (input.llms !== false) llms = { ...input.llms };
+    llms = requestedLlms;
     agentMap = requestedAgentMap;
   }
   const resolved = {
     siteUrl,
     routes,
     robots: input.robots,
-    sitemap: input.sitemap ?? true,
+    ...resolveSitemap(input.sitemap),
     exclude,
     prerender,
     markdown,
@@ -921,9 +1025,9 @@ function parseHtml(html) {
       handleDisabledFileLoadingAsSuccess: true
     }
   });
-  const document = new window2.DOMParser().parseFromString(html, "text/html");
+  const document2 = new window2.DOMParser().parseFromString(html, "text/html");
   return {
-    document,
+    document: document2,
     dispose() {
       window2.happyDOM.close();
     }
@@ -936,9 +1040,9 @@ var SHOW_TEXT = 4;
 var FILTER_ACCEPT = 1;
 var FILTER_REJECT = 2;
 var NO_TEXT = /* @__PURE__ */ new Set(["SCRIPT", "STYLE", "NOSCRIPT", "TEMPLATE"]);
-function bodyHasText(document) {
-  if (!document.body) return false;
-  const walker = document.createTreeWalker(document.body, SHOW_ELEMENT | SHOW_TEXT, {
+function bodyHasText(document2) {
+  if (!document2.body) return false;
+  const walker = document2.createTreeWalker(document2.body, SHOW_ELEMENT | SHOW_TEXT, {
     acceptNode: (n) => n.nodeType === 1 && NO_TEXT.has(n.tagName.toUpperCase()) ? FILTER_REJECT : FILTER_ACCEPT
   });
   for (let n = walker.nextNode(); n; n = walker.nextNode()) {
@@ -946,11 +1050,11 @@ function bodyHasText(document) {
   }
   return false;
 }
-function analyzeDocument(document, opts, mode = {}) {
-  const meta = readPageMeta(document);
+function analyzeDocument(document2, opts, mode = {}) {
+  const meta = readPageMeta(document2);
   const title = meta.title ?? opts.route;
   const links = [];
-  document.querySelectorAll("a[href]").forEach((a) => {
+  document2.querySelectorAll("a[href]").forEach((a) => {
     if (a.hasAttribute("download")) return;
     try {
       const u = new URL(a.getAttribute("href"), opts.pageUrl);
@@ -958,8 +1062,8 @@ function analyzeDocument(document, opts, mode = {}) {
     } catch {
     }
   });
-  const hasText = bodyHasText(document);
-  const { element, source } = selectContentRegion(document, {
+  const hasText = bodyHasText(document2);
+  const { element, source } = selectContentRegion(document2, {
     contentSelector: opts.contentSelector,
     ...mode.inPlace ? { inPlace: true } : {}
   });
@@ -989,9 +1093,9 @@ var URL_ATTRS = [
 function mapSrcset(value, fn) {
   return value.replace(/(^|,)(\s*)([^\s,][^\s]*?)(?=,|\s|$)/g, (_m, sep2, ws, url) => sep2 + ws + fn(url));
 }
-function rewriteUrls(document, fn, attrs = URL_ATTRS) {
+function rewriteUrls(document2, fn, attrs = URL_ATTRS) {
   for (const [tag, attr] of attrs) {
-    document.querySelectorAll(`${tag}[${attr}]`).forEach((el) => {
+    document2.querySelectorAll(`${tag}[${attr}]`).forEach((el) => {
       const v = el.getAttribute(attr);
       const next = attr === "srcset" ? mapSrcset(v, fn) : fn(v);
       if (next !== v) el.setAttribute(attr, next);
@@ -999,18 +1103,18 @@ function rewriteUrls(document, fn, attrs = URL_ATTRS) {
   }
 }
 function finalizePage(html, opts, analyze) {
-  const { document, dispose } = parseHtml(html);
+  const { document: document2, dispose } = parseHtml(html);
   try {
-    const out = finalizeDocument(document, opts);
-    return { html: out, info: analyzeDocument(document, analyze, { inPlace: true }) };
+    const out = finalizeDocument(document2, opts);
+    return { html: out, info: analyzeDocument(document2, analyze, { inPlace: true }) };
   } finally {
     dispose();
   }
 }
-function finalizeDocument(document, opts) {
-  document.querySelectorAll(`[${PROBE_ATTR}], [${TEMP_BASE_ATTR}]`).forEach((el) => el.remove());
-  document.documentElement.setAttribute(PRERENDERED_ATTR, "");
-  document.querySelectorAll(`script[${REL_SRC_ATTR}]`).forEach((el) => {
+function finalizeDocument(document2, opts) {
+  document2.querySelectorAll(`[${PROBE_ATTR}], [${TEMP_BASE_ATTR}]`).forEach((el) => el.remove());
+  document2.documentElement.setAttribute(PRERENDERED_ATTR, "");
+  document2.querySelectorAll(`script[${REL_SRC_ATTR}]`).forEach((el) => {
     const src = el.getAttribute("src");
     if (src?.startsWith("/")) el.setAttribute("src", "." + src);
     el.removeAttribute(REL_SRC_ATTR);
@@ -1018,7 +1122,7 @@ function finalizeDocument(document, opts) {
   if (opts.origin) {
     const origin = trimTrailingSlash(opts.origin);
     const attrs = opts.fullBase ? [...URL_ATTRS, ["a", "href"]] : URL_ATTRS;
-    rewriteUrls(document, (u) => {
+    rewriteUrls(document2, (u) => {
       if (!u.startsWith(origin)) return u;
       const rest = u.slice(origin.length);
       if (rest !== "" && !/^[/?#]/.test(rest)) return u;
@@ -1031,11 +1135,11 @@ function finalizeDocument(document, opts) {
     const depth = routeDepth(opts.route);
     if (depth > 0) {
       const up = "../".repeat(depth);
-      rewriteUrls(document, (u) => u.startsWith("./") ? up + u.slice(2) : u);
+      rewriteUrls(document2, (u) => u.startsWith("./") ? up + u.slice(2) : u);
     }
   }
   const seen = /* @__PURE__ */ new Set();
-  document.querySelectorAll("link[href]").forEach((el) => {
+  document2.querySelectorAll("link[href]").forEach((el) => {
     const rel = el.getAttribute("rel") ?? "";
     if (!DEDUPE_RELS.has(rel)) return;
     const key = [rel, el.getAttribute("href"), el.getAttribute("as"), el.getAttribute("media"), el.getAttribute("type")].join("\n");
@@ -1043,16 +1147,16 @@ function finalizeDocument(document, opts) {
     else seen.add(key);
   });
   if (opts.markdownUrl) {
-    let link = document.head.querySelector(`link[rel="alternate"][type="${MARKDOWN_MIME}"]`);
+    let link = document2.head.querySelector(`link[rel="alternate"][type="${MARKDOWN_MIME}"]`);
     if (!link) {
-      link = document.createElement("link");
+      link = document2.createElement("link");
       link.setAttribute("rel", "alternate");
       link.setAttribute("type", MARKDOWN_MIME);
-      document.head.appendChild(link);
+      document2.head.appendChild(link);
     }
     link.setAttribute("href", opts.markdownUrl);
   }
-  return "<!DOCTYPE html>" + document.documentElement.outerHTML;
+  return "<!DOCTYPE html>" + document2.documentElement.outerHTML;
 }
 
 // src/vite/prerender/crawl.ts
@@ -1749,10 +1853,10 @@ async function prerenderSite(input) {
   }
 }
 function classicScriptSrcs(html) {
-  const { document, dispose } = parseHtml(html);
+  const { document: document2, dispose } = parseHtml(html);
   try {
     const out = [];
-    for (const el of Array.from(document.querySelectorAll("script[src]"))) {
+    for (const el of Array.from(document2.querySelectorAll("script[src]"))) {
       if (el.hasAttribute("async") || el.hasAttribute("defer")) continue;
       const type = (el.getAttribute("type") ?? "").trim().toLowerCase();
       if (type !== "" && !/^(text|application)\/(x-)?(java|ecma)script$/.test(type)) continue;
@@ -1850,29 +1954,32 @@ function buildRobots(opts) {
   return blocks.join("\n\n") + "\n";
 }
 
-// src/vite/sitemap.ts
-function escapeXml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+// src/vite/llms.ts
+var BLOCK_START = /^(\d*)([#>\-+*=_`~.)])/;
+function paragraphs(text) {
+  if (text === void 0) return [];
+  return text.split(/\n\s*\n/).map((p) => escapeMarkdownInline(p)).filter(Boolean).map((p) => p.replace(BLOCK_START, "$1\\$2"));
 }
-function buildSitemap(siteUrl, routes) {
-  const urls = routes.map((r) => `  <url><loc>${escapeXml(new URL(siteUrl + r).href)}</loc></url>`).join("\n");
-  return '<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n' + urls + "\n</urlset>\n";
+function linkLine(title, url, description) {
+  const desc = escapeMarkdownInline(description);
+  return `- [${escapeMarkdownInline(title)}](${escapeLinkTarget(url)})${desc ? `: ${desc}` : ""}`;
 }
-
-// src/vite/llms.ts
 function header(site) {
   const blocks = [`# ${escapeMarkdownInline(site.title)}`];
   const desc = escapeMarkdownInline(site.description);
   if (desc) blocks.push(`> ${desc}`);
+  blocks.push(...paragraphs(site.intro));
+  for (const sec of site.sections ?? []) {
+    const body = [...paragraphs(sec.text)];
+    const links = (sec.links ?? []).map((l) => linkLine(l.title, l.url, l.description));
+    if (links.length) body.push(links.join("\n"));
+    blocks.push([`## ${escapeMarkdownInline(sec.title)}`, ...body].join("\n\n"));
+  }
   return blocks;
 }
 function buildLlmsTxt(site, pages, sections = []) {
   const blocks = header(site);
-  const lines = [...pages].sort(byRoute).map((p) => {
-    const title = escapeMarkdownInline(p.title);
-    const desc = escapeMarkdownInline(p.description);
-    return `- [${title}](${escapeLinkTarget(p.mdUrl ?? p.url)})${desc ? `: ${desc}` : ""}`;
-  });
+  const lines = [...pages].sort(byRoute).map((p) => linkLine(p.title, p.mdUrl ?? p.url, p.description));
   blocks.push(["## Pages", ...lines.length ? ["", ...lines] : []].join("\n"));
   for (const s of sections) {
     blocks.push([`## ${s.heading}`, ...s.lines.length ? ["", ...s.lines] : []].join("\n"));
@@ -1981,8 +2088,13 @@ async function stageSiteFiles(opts, stager, { pages: allPages, listed, mdByRoute
       const md = mdByRoute.get(p.route);
       return md !== void 0 ? { ...p, markdown: md } : { ...p };
     });
-    stager.stage(fileOf(LLMS_TXT_PATH), buildLlmsTxt(site, llmsPages, sections));
-    if (markdown) stager.stage(fileOf(LLMS_FULL_TXT_PATH), buildLlmsFullTxt(site, llmsPages));
+    const llmsSite = {
+      ...site,
+      ...llms.intro !== void 0 ? { intro: llms.intro } : {},
+      ...llms.sections !== void 0 ? { sections: llms.sections } : {}
+    };
+    stager.stage(fileOf(LLMS_TXT_PATH), buildLlmsTxt(llmsSite, llmsPages, sections));
+    if (markdown) stager.stage(fileOf(LLMS_FULL_TXT_PATH), buildLlmsFullTxt(llmsSite, llmsPages));
   }
   for (const ext of extensions) {
     if (!ext.finalize) continue;
@@ -2000,6 +2112,60 @@ async function stageSiteFiles(opts, stager, { pages: allPages, listed, mdByRoute
   }
 }
 
+// src/vite/sitemap.ts
+function escapeXml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function buildSitemap(siteUrl, routes, lastmod) {
+  const urls = routes.map((r) => {
+    const date = lastmod?.get(r);
+    const mod = date !== void 0 ? `<lastmod>${escapeXml(date)}</lastmod>` : "";
+    return `  <url><loc>${escapeXml(new URL(siteUrl + r).href)}</loc>${mod}</url>`;
+  }).join("\n");
+  return '<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n' + urls + "\n</urlset>\n";
+}
+function isoDate(d) {
+  return d.toISOString().slice(0, 10);
+}
+var DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/;
+function validDate(s) {
+  const m = DATE.exec(s.slice(0, 10));
+  if (!m) return false;
+  const d = new Date(Date.UTC(+m[1], +m[2] - 1, +m[3]));
+  return isoDate(d) === s.slice(0, 10) && (s.length === 10 || !Number.isNaN(Date.parse(s)));
+}
+function lastmodValue(v, route) {
+  if (v === void 0) return void 0;
+  if (v instanceof Date && !Number.isNaN(v.getTime())) return isoDate(v);
+  if (typeof v === "string" && (DATE.test(v) || DATETIME.test(v)) && validDate(v)) return v;
+  const got = v instanceof Date ? "an invalid Date" : JSON.stringify(v) ?? typeof v;
+  throw new Error(
+    withPrefix(
+      `sitemap.lastmod must return "YYYY-MM-DD", a W3C datetime such as "2026-01-31T09:00:00Z", a Date or undefined (got ${got} for ${shortRoute(route)})`
+    )
+  );
+}
+async function sitemapLastmods(lastmod, routes, fileDate) {
+  const out = /* @__PURE__ */ new Map();
+  if (lastmod === "none") return out;
+  for (const route of routes) {
+    let v;
+    if (lastmod === "file") {
+      v = fileDate(route);
+    } else {
+      try {
+        v = await lastmod(route);
+      } catch (e) {
+        throw prefixed(e, `sitemap.lastmod failed for ${shortRoute(route)}`);
+      }
+    }
+    const value = lastmodValue(v, route);
+    if (value !== void 0) out.set(route, value);
+  }
+  return out;
+}
+
 // src/vite/buildPlugin.ts
 function isClientEnv(env) {
   if (!env) return true;
@@ -2078,7 +2244,11 @@ function createBuildPlugin(resolved, extensions) {
         )
       ])
     ].sort() : resolved.routes;
-    if (resolved.sitemap) stager.stage(fileOf(SITEMAP_PATH), buildSitemap(siteUrl, sitemapRoutes));
+    if (resolved.sitemap) {
+      const buildDate = /* @__PURE__ */ new Date();
+      const lastmod = await sitemapLastmods(resolved.sitemapLastmod, sitemapRoutes, () => buildDate);
+      stager.stage(fileOf(SITEMAP_PATH), buildSitemap(siteUrl, sitemapRoutes, lastmod));
+    }
     stager.stage(fileOf(ROBOTS_PATH), buildRobots(resolved));
     if (rendered) {
       const { siteUrl: url, markdown: md, llms } = resolved;
@@ -2168,10 +2338,10 @@ import fs3 from "fs";
 import path4 from "path";
 
 // src/vite/generateActions.ts
-function staticActions(document) {
+function staticActions(document2) {
   const out = /* @__PURE__ */ new Map();
-  for (const a of markupActions(document)) {
-    if (!isValidActionName(a.name) || out.has(a.name)) continue;
+  for (const a of markupActions(document2)) {
+    if (a.kind === "link" || !isValidActionName(a.name) || out.has(a.name)) continue;
     out.set(a.name, {
       name: a.name,
       description: a.description?.trim() || a.name,
@@ -2380,6 +2550,7 @@ async function generateAgentFiles(options) {
   const pages = [];
   const result = [];
   const mdByRoute = /* @__PURE__ */ new Map();
+  const mtimeByRoute = /* @__PURE__ */ new Map();
   const bodyFallback = [];
   const utf16 = [];
   const ownLinks = [];
@@ -2390,19 +2561,21 @@ async function generateAgentFiles(options) {
     (m) => logger.warn(m)
   );
   for (const { route, file } of routes) {
+    mtimeByRoute.set(route, fs3.statSync(path4.join(outDir, file)).mtime);
     const bytes = fs3.readFileSync(path4.join(outDir, file));
     const { charset, text: html } = decodeHtml(bytes);
     const url = publicUrl(siteUrl, route);
-    const { document, dispose } = parseHtml(html);
+    const { document: document2, dispose } = parseHtml(html);
     let page;
     try {
-      const actions = resolved.agentMap ? staticActions(document) : [];
-      const info = analyzeDocument(document, {
+      const actions = resolved.agentMap ? staticActions(document2) : [];
+      const links = resolved.agentMap ? markupLinks(document2) : [];
+      const info = analyzeDocument(document2, {
         pageUrl: url,
         contentSelector: markdown ? markdown.contentSelector : "main",
         route
       });
-      const inPage = { "agent-map": { actions } };
+      const inPage = { "agent-map": { actions, links } };
       page = { route, info, listed: !info.noindex, inPage };
     } catch (e) {
       throw prefixed(e, `reading ${file} failed`);
@@ -2428,7 +2601,11 @@ async function generateAgentFiles(options) {
     }
   }
   const listed = pages.filter((p) => p.listed);
-  if (resolved.sitemap) guarded.stage(fileOf(SITEMAP_PATH), buildSitemap(siteUrl, listed.map((p) => p.route)));
+  if (resolved.sitemap) {
+    const routes2 = listed.map((p) => p.route);
+    const lastmod = await sitemapLastmods(resolved.sitemapLastmod, routes2, (r) => mtimeByRoute.get(r));
+    guarded.stage(fileOf(SITEMAP_PATH), buildSitemap(siteUrl, routes2, lastmod));
+  }
   guarded.stage(fileOf(ROBOTS_PATH), buildRobots(resolved));
   const extensions = resolved.agentMap ? [agentMapExtension({ siteUrl, fileName: resolved.agentMap.fileName })] : [];
   await stageSiteFiles({ siteUrl, markdown, llms: resolved.llms, extensions, logger }, guarded, {
@@ -2436,7 +2613,23 @@ async function generateAgentFiles(options) {
     listed,
     mdByRoute
   });
-  stager.flush();
+  let flushed = false;
+  try {
+    stager.flush();
+    flushed = true;
+  } finally {
+    if (!flushed || resolved.sitemapLastmod === "file") {
+      for (const [route, mtime] of mtimeByRoute) {
+        const file = fileByRoute.get(route);
+        if (!written.has(file)) continue;
+        try {
+          fs3.utimesSync(path4.join(outDir, file), mtime, mtime);
+        } catch (e) {
+          if (flushed) throw e;
+        }
+      }
+    }
+  }
   if (markdown && bodyFallback.length > 0) {
     logger.warn(
       `${LOG_PREFIX} no [${CONTENT_ATTR}] or "${markdown.contentSelector}" element on ${bodyFallback.join(", ")}; content was taken from <body> minus header, nav, footer, aside`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anubhav-choubey/web-for-agents",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "SEO and AI-agent readiness for React + Vite: head tags, JSON-LD, prerendering, markdown pages, llms.txt, agents.json and WebMCP",
   "license": "MIT",
   "author": "Anubhav Choubey",

package/dist/chunk-FEAKVNMG.js

@@ -1,12 +0,0 @@
-// 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 {
-  collapseWhitespace,
-  stripBom
-};

package/dist/chunk-LCLDQ3A3.js

@@ -1,26 +0,0 @@
-// src/shared/jsonLd.ts
-var MAX_NODES = 1e5;
-function jsonLdTypes(value) {
-  const out = [];
-  const stack = [value];
-  for (let visited = 0; stack.length > 0 && visited < MAX_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;
-    const t = o["@type"];
-    if (typeof t === "string") out.push(t);
-    else if (Array.isArray(t)) {
-      for (const x of t) if (typeof x === "string") out.push(x);
-    }
-    if ("@graph" in o) stack.push(o["@graph"]);
-  }
-  return out;
-}
-
-export {
-  jsonLdTypes
-};