@hgdc/agents 0.2.0 → 0.4.0

package/dist/build.js

@@ -2,7 +2,7 @@
 // version Markdown de chaque page au build et produit les routes qui la servent sur
 // `Accept: text/markdown`. Rien ne s'exécute à la requête : tout est fichier statique et route.
 import { readdir, readFile, writeFile } from "node:fs/promises";
-import { htmlToMarkdown } from "./markdown.js";
+import { htmlToMarkdown, pageFrontmatter } from "./markdown.js";
 const NOT_FOUND = "404.html";
 // Valeur de condition commune à Host (edge/src/router.ts) et Vercel : correspondance sur toute la valeur.
 const ACCEPTS_MARKDOWN = { type: "header", key: "accept", value: ".*text/markdown.*" };
@@ -42,7 +42,7 @@ export async function writeMarkdownPages(dir, options) {
         const html = await readFile(new URL(file, dir), "utf-8");
         const url = `${options.site}${path ?? `${base}/`}`;
         const target = notFound ? file.replace(/\.html$/, ".md") : markdownFile(path, base);
-        await writeFile(new URL(target, dir), htmlToMarkdown(html, url) + footer);
+        await writeFile(new URL(target, dir), pageFrontmatter(html, url) + htmlToMarkdown(html, url) + footer);
         if (path !== null)
             pages.push({ path, file: target });
     }

package/dist/fetch.js

@@ -1,7 +1,7 @@
 // Ce qu'une app rendue côté serveur (TanStack Start, ou tout handler `fetch`) montre aux agents : la page en
 // Markdown, ses données structurées et son adresse canonique, les pages de confiance, des erreurs d'API en JSON.
 import { canonicalLink, injectIntoHead, jsonLdScript } from "./head.js";
-import { htmlToMarkdown } from "./markdown.js";
+import { htmlToMarkdown, pageFrontmatter } from "./markdown.js";
 import { prefersMarkdown, varyOnAccept } from "./negotiate.js";
 /** Pied de page standard : une ligne de liens, `[libellé](adresse)` séparés par « · ». */
 export function linksFooter(links) {
@@ -40,7 +40,13 @@ export function withMarkdown(handler, options = {}) {
         const redirected = response.status >= 300 && response.status < 400;
         if (!markdown || response.status < 200 || redirected)
             return withHeaders(response, request.method === "HEAD" ? null : enrichHead(response, url, options), varyOnAccept);
-        const text = htmlToMarkdown(await response.text(), request.url) + (options.footer ? `\n---\n\n${options.footer}\n` : "");
+        const html = await response.text();
+        // Métadonnées en tête ; l'adresse canonique seulement si l'origine publique est connue (une console
+        // relayée voit l'adresse de son relais, pas celle du visiteur).
+        const canonical = options.canonicalOrigin ? `${options.canonicalOrigin}${url.pathname}` : undefined;
+        const text = pageFrontmatter(html, canonical) +
+            htmlToMarkdown(html, request.url) +
+            (options.footer ? `\n---\n\n${options.footer}\n` : "");
         return withHeaders(response, request.method === "HEAD" ? null : text, (out) => {
             for (const name of BODY_HEADERS)
                 out.delete(name);

package/dist/hgdc.d.ts

@@ -3,6 +3,12 @@
  * de l'entreprise, sur hgdc.ch. Pour l'option `redirects` de `withMarkdown`.
  */
 export declare const HGDC_TRUST_PAGES: Readonly<Record<string, string>>;
+/**
+ * Fichiers de découverte que les agents cherchent à la racine de chaque hôte : ceux de l'entreprise, sur
+ * hgdc.ch (catalogue ARD, index Agent Skills). Pour l'option `redirects` de `withMarkdown`, avec
+ * `HGDC_TRUST_PAGES`.
+ */
+export declare const HGDC_DISCOVERY_FILES: Readonly<Record<string, string>>;
 /** Nœud schema.org de l'entreprise, même `@id` que sur hgdc.ch. */
 export declare const HGDC_ORGANIZATION: {
     readonly "@type": "Organization";
@@ -10,6 +16,7 @@ export declare const HGDC_ORGANIZATION: {
     readonly name: "Hugo Gebel Développement Conseil";
     readonly alternateName: "HGDC";
     readonly url: "https://hgdc.ch";
+    readonly sameAs: readonly ["https://www.linkedin.com/company/smartflowsa", "https://www.instagram.com/smartflowsa.ch"];
     readonly description: "Entreprise individuelle suisse : agence web, accompagnement IA, outils en ligne de la H Collection et logiciel Stratta, pour les entreprises en Suisse.";
     readonly email: "contact@hgdc.ch";
     readonly contactPoint: {
@@ -29,7 +36,7 @@ export declare const HGDC_ORGANIZATION: {
         readonly addressCountry: "CH";
     };
 };
-/** Graphe JSON-LD d'un produit : l'entreprise et le site du produit, qu'elle publie. */
+/** Graphe JSON-LD d'un produit : l'entreprise, le produit (logiciel en ligne) et son site, qu'elle publie. */
 export declare function productJsonLd(product: {
     name: string;
     url: string;

package/dist/hgdc.js

@@ -9,6 +9,15 @@ export const HGDC_TRUST_PAGES = {
     "/contact": "https://hgdc.ch/contact",
     "/privacy": "https://hgdc.ch/confidentialite",
 };
+/**
+ * Fichiers de découverte que les agents cherchent à la racine de chaque hôte : ceux de l'entreprise, sur
+ * hgdc.ch (catalogue ARD, index Agent Skills). Pour l'option `redirects` de `withMarkdown`, avec
+ * `HGDC_TRUST_PAGES`.
+ */
+export const HGDC_DISCOVERY_FILES = {
+    "/.well-known/ard.json": "https://hgdc.ch/.well-known/ard.json",
+    "/.well-known/agent-skills/index.json": "https://hgdc.ch/.well-known/agent-skills/index.json",
+};
 /** Nœud schema.org de l'entreprise, même `@id` que sur hgdc.ch. */
 export const HGDC_ORGANIZATION = {
     "@type": "Organization",
@@ -16,6 +25,8 @@ export const HGDC_ORGANIZATION = {
     name: "Hugo Gebel Développement Conseil",
     alternateName: "HGDC",
     url: "https://hgdc.ch",
+    // Profils publics de l'entreprise (ceux de l'Agence, ex-SmartFlow, renommés sans changer d'adresse).
+    sameAs: ["https://www.linkedin.com/company/smartflowsa", "https://www.instagram.com/smartflowsa.ch"],
     description: "Entreprise individuelle suisse : agence web, accompagnement IA, outils en ligne de la H Collection et logiciel Stratta, pour les entreprises en Suisse.",
     email: "contact@hgdc.ch",
     contactPoint: {
@@ -35,7 +46,7 @@ export const HGDC_ORGANIZATION = {
         addressCountry: "CH",
     },
 };
-/** Graphe JSON-LD d'un produit : l'entreprise et le site du produit, qu'elle publie. */
+/** Graphe JSON-LD d'un produit : l'entreprise, le produit (logiciel en ligne) et son site, qu'elle publie. */
 export function productJsonLd(product) {
     return {
         "@context": "https://schema.org",
@@ -50,6 +61,17 @@ export function productJsonLd(product) {
                 inLanguage: "fr-CH",
                 publisher: { "@id": HGDC_ORGANIZATION["@id"] },
             },
+            {
+                "@type": "SoftwareApplication",
+                "@id": `${product.url}/#software`,
+                name: product.name,
+                url: product.url,
+                description: product.description,
+                applicationCategory: "BusinessApplication",
+                operatingSystem: "Web",
+                inLanguage: "fr-CH",
+                publisher: { "@id": HGDC_ORGANIZATION["@id"] },
+            },
         ],
     };
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { htmlToMarkdown, pageTitle } from "./markdown.js";
+export { htmlToMarkdown, pageFrontmatter, pageTitle } from "./markdown.js";
 export { prefersMarkdown, varyOnAccept } from "./negotiate.js";
 export { linksFooter, withMarkdown, type MarkdownOptions } from "./fetch.js";
 export { canonicalLink, injectIntoHead, jsonLdScript } from "./head.js";
-export { HGDC_ORGANIZATION, HGDC_TRUST_PAGES, productJsonLd } from "./hgdc.js";
+export { HGDC_DISCOVERY_FILES, HGDC_ORGANIZATION, HGDC_TRUST_PAGES, productJsonLd } from "./hgdc.js";

package/dist/index.js

@@ -1,5 +1,5 @@
-export { htmlToMarkdown, pageTitle } from "./markdown.js";
+export { htmlToMarkdown, pageFrontmatter, pageTitle } from "./markdown.js";
 export { prefersMarkdown, varyOnAccept } from "./negotiate.js";
 export { linksFooter, withMarkdown } from "./fetch.js";
 export { canonicalLink, injectIntoHead, jsonLdScript } from "./head.js";
-export { HGDC_ORGANIZATION, HGDC_TRUST_PAGES, productJsonLd } from "./hgdc.js";
+export { HGDC_DISCOVERY_FILES, HGDC_ORGANIZATION, HGDC_TRUST_PAGES, productJsonLd } from "./hgdc.js";

package/dist/markdown.d.ts

@@ -1,7 +1,9 @@
 /** Titre de la page (`<title>`), pour une page dont le contenu n'a pas de titre de niveau 1. */
 export declare function pageTitle(html: string): string | null;
 /**
- * Markdown du contenu d'une page HTML.
- * @param base adresse de la page, pour rendre les liens absolus
+ * Bloc de métadonnées YAML qui ouvre le Markdown d'une page : titre, description et adresse canonique, lus
+ * dans le `<head>` (`url` à défaut de `<link rel="canonical">`, sinon pas d'adresse). Les valeurs sont des
+ * chaînes JSON, du YAML valide quel que soit leur contenu.
  */
+export declare function pageFrontmatter(html: string, url?: string | URL): string;
 export declare function htmlToMarkdown(html: string, base: string | URL): string;

package/dist/markdown.js

@@ -243,6 +243,35 @@ export function pageTitle(html) {
  * Markdown du contenu d'une page HTML.
  * @param base adresse de la page, pour rendre les liens absolus
  */
+const attribute = (tag, name) => new RegExp(`\\s${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`, "i")
+    .exec(tag)
+    ?.slice(1)
+    .find((v) => v !== undefined);
+/** Première balise `<tag …>` du document dont un attribut vaut `value`, avec son attribut `read`. */
+function headValue(html, tag, key, value, read) {
+    for (const m of html.matchAll(new RegExp(`<${tag}\\b[^>]*>`, "gi"))) {
+        if (attribute(m[0], key)?.toLowerCase() === value) {
+            const found = attribute(m[0], read);
+            if (found)
+                return collapse(decode(found)).trim();
+        }
+    }
+    return null;
+}
+/**
+ * Bloc de métadonnées YAML qui ouvre le Markdown d'une page : titre, description et adresse canonique, lus
+ * dans le `<head>` (`url` à défaut de `<link rel="canonical">`, sinon pas d'adresse). Les valeurs sont des
+ * chaînes JSON, du YAML valide quel que soit leur contenu.
+ */
+export function pageFrontmatter(html, url) {
+    const fields = [
+        ["title", pageTitle(html)],
+        ["description", headValue(html, "meta", "name", "description", "content")],
+        ["canonical", headValue(html, "link", "rel", "canonical", "href") ?? (url ? new URL(url).href : null)],
+    ];
+    const lines = fields.filter(([, v]) => v).map(([k, v]) => `${k}: ${JSON.stringify(v)}`);
+    return lines.length ? `---\n${lines.join("\n")}\n---\n\n` : "";
+}
 export function htmlToMarkdown(html, base) {
     const page = new URL(base);
     const link = (href) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hgdc/agents",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Sites lisibles par les agents IA : version Markdown des pages (Accept: text/markdown), 404 en Markdown, routes Build Output API pour les sites prérendus.",
   "license": "UNLICENSED",
   "homepage": "https://github.com/hugogebel-boop/hgdc-kit/tree/main/packages/agents#readme",