wiki-formant 0.52.0 → 0.53.0

package/README.md

@@ -268,7 +268,7 @@ Four configs had restated these by hand on the grounds that a config could not i
 `withWikiDefaults(config, { csp })` wraps the whole config: the headers on every route with `csp` enforced in production, AVIF before WebP from the image optimiser, Turbopack's build cache off (Vercel restored a stale one and shipped a stylesheet two commits old), and `distDir` from `STUDIO_DIST_DIR` for radix-studio's second dev server. What the app sets wins, and its own `headers()` follow these.
 
 ```ts
-export default withWikiDefaults({ async redirects() { /* … */ } }, { csp });
+export default withWikiDefaults<NextConfig>({ async redirects() { /* … */ } }, { csp });
 ```
 
 `contentSecurityPolicy` starts from the policy all four origins shared line for line, and each directive passed replaces its default rather than appending, so the call site reads as the whole list. An empty list drops a directive.
@@ -392,7 +392,7 @@ different lists.
 ```ts
 import { trackAiBot, crawlerRules } from 'wiki-formant/crawlers';
 
-trackAiBot(request, event, () => import('@/lib/track'));   // in proxy.ts: label, or null
+trackAiBot(request, event, () => import('@/lib/track'));   // in proxy.ts: whether it counted
 const rules = crawlerRules({ allow: '/', disallow, aiAllow });
 ```
 
@@ -408,7 +408,7 @@ Every agent group also allows the agent surface — `/api/mcp`, the three `llms`
 
 `crawlerRules` returns every group robots.txt needs: the wildcard, one per AI crawler, and one for each search engine. Search engines get the HTML site and none of its twins — `/*.md$` always, plus `searchDisallow` — because the `*` group keeps the machine surface open to agents, and for Google a twin is a page it already has. Two origins wrote that group by hand and the third never did, so Google crawled its twins. The `<Link>` prefetch payload (`?_rsc=`) is refused in every group.
 
-`trackAiBot(request, event, load)` counts an `AI Bot Visit` inside `event.waitUntil`. `load` is a dynamic import because the tracker pulls in a database client, which a static import would load for every request the proxy sees.
+`trackAiBot(request, event, load)` counts an `AI Bot Visit` inside `event.waitUntil`: a crawler on the roster wherever it goes, and anything but a search engine that asks for what only agents read (a `.md` twin or `Accept: text/markdown`, the `llms` exports, `/openapi.json`, `/.well-known/`), since most agents are on no roster. Its user agent is kept, so `digest` can name it. `load` is a dynamic import because the tracker pulls in a database client, which a static import would load for every request the proxy sees.
 
 ## IndexNow
 
@@ -778,10 +778,13 @@ and may be a batch; `trackSearch` normalises a search box's free text so
 the same question aggregates as one row, and drops an empty one. Pass the request's headers and the
 event joins whoever sent it, person or agent.
 
-`digest(sql, { days })` reads a site back as one JSON object: visitors, page
-views, bounce rate, visit length, sources (a link's `utm_source`, else the
-referring host), top and entry pages, countries, devices, visitors by day, MCP
-tool calls, and the searches that found nothing. A visit is a run of one
+`digest(sql, { days })` reads a site back as one JSON object: visitors, agents,
+page views, bounce rate, visit length, sources (a link's `utm_source`, else the
+referring host), top and entry pages, countries, devices, visitors and agents by
+day, the agents by name, MCP tool calls, and the searches that found nothing.
+An agent is counted as a visitor is, one address and user agent a day, from its
+`AI Bot Visit` and `MCP Call` events; it runs no page script, so it is never
+among the visitors. `ownAgents` leaves the site's own out. A visit is a run of one
 visitor's views with no gap over 30 minutes. A multi-tenant app passes a `site`
 key to every call and a `site` resolver to `collect`.
 
@@ -831,8 +834,8 @@ headline figures, each with its change from the window before
 site's stylesheet to colour), one of them per day, every non-empty
 ranked list, and `?days=` links between windows, all time among them, pinned in
 the chart's frame as its own buttons are (`TimeChart`'s `controls`). Each
-figure is a button that charts it: visitors, page views, bounce rate, visit
-length, visitors with agents and clicks to X. `digest`'s `by_day` carries every
+figure is a button that charts it: visitors, agents, page views, bounce rate,
+visit length and clicks to X. `digest`'s `by_day` carries every
 one of those per UTC day, a visit on the day it began, so the days add up to the
 totals. A day with no visits has no bounce rate or visit length and is left out
 of those charts rather than drawn as zero. Everything but the figures and the

package/bin/check-classes.mjs

@@ -66,22 +66,28 @@ for (const f of cssFiles) {
   }
 }
 
-// Classes this project defines itself. Everything else the build emitted is a
-// Tailwind utility, which is what makes the composition count derivable rather
-// than a maintained prefix list. Read from rule preludes only, so a decimal in a
-// value or a class named in a comment is not taken for a selector.
-const globalsFile = walk(SRC_DIR, '.css').find(f => f.endsWith('globals.css'));
-const named = new Set();
-if (globalsFile) {
-  const css = fs.readFileSync(globalsFile, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '');
+// Classes defined by this project's stylesheets or by wiki-formant's base.css.
+// Everything else the build emitted is a Tailwind utility, which is what makes
+// the composition count derivable rather than a maintained prefix list. Read
+// from rule preludes only, so a decimal in a value or a class named in a
+// comment is not taken for a selector.
+const classesIn = file => {
+  const out = new Set();
+  const css = fs.readFileSync(file, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '');
   for (const [, prelude] of css.matchAll(/([^{};]*)\{/g)) {
     if (prelude.trim().startsWith('@')) continue;
     for (const m of prelude.matchAll(/\.((?:\\.|[-\w])+)/g)) {
       const name = m[1].replace(/\\/g, '');
-      if (/^[A-Za-z_-]/.test(name)) named.add(name);
+      if (/^[A-Za-z_-]/.test(name)) out.add(name);
     }
   }
-}
+  return out;
+};
+const ownCss = walk(SRC_DIR, '.css');
+const globalsFile = ownCss.find(f => f.endsWith('globals.css'));
+const own = new Set(ownCss.flatMap(f => [...classesIn(f)]));
+const baseCss = new URL('../dist/base.css', import.meta.url);
+const named = new Set([...own, ...(fs.existsSync(baseCss) ? classesIn(baseCss) : [])]);
 
 // Only bare literals: anything interpolated is beyond a static check.
 const dead = new Map();
@@ -120,20 +126,22 @@ if (compositions.length) {
 }
 
 // Every token in the JavaScript the build ships, server and client. A selector
-// is referenced when its name appears whole, or when a prefix of it ending in `-`
-// or `_` does, which is how `editorial-banner-${variant}` is written.
+// is referenced when its name appears whole, when a prefix of it ending in `-`
+// or `_` does, which is how `editorial-banner-${variant}` is written, or when it
+// splits at a `-` or `_` into two shipped tokens, which is how `RailShell`'s
+// `${prefix}--open` is written.
 const shipped = new Set();
 for (const f of [...walk(STATIC_DIR, '.js'), ...walk('.next/server', '.js')]) {
   for (const [tok] of fs.readFileSync(f, 'utf8').matchAll(/[\w-]+/g)) shipped.add(tok);
 }
 const referenced = name =>
   shipped.has(name) ||
-  [...name].some((c, i) => i >= 3 && (c === '-' || c === '_') && shipped.has(name.slice(0, i + 1)));
-const unused = [...named].filter(n => !referenced(n)).sort();
+  [...name].some((c, i) => i >= 3 && (c === '-' || c === '_') && (shipped.has(name.slice(0, i + 1)) || (shipped.has(name.slice(0, i)) && shipped.has(name.slice(i)))));
+const unused = [...own].filter(n => !referenced(n)).sort();
 
 if (unused.length) {
   const verb = CHECK_UNUSED ? 'must be deleted' : 'advisory';
-  console.error(`check-classes: ${unused.length} selector(s) in ${globalsFile} referenced by nothing the build ships (${verb}):\n`);
+  console.error(`check-classes: ${unused.length} selector(s) in ${ownCss.join(', ')} referenced by nothing the build ships (${verb}):\n`);
   console.error(`  ${unused.join(', ')}\n`);
   console.error('  Class names inside HTML stored in a database do not count, so check stored content before deleting one.\n');
 }

package/dist/analytics.d.ts

@@ -67,8 +67,9 @@ export interface DigestOptions {
     siblings?: string[];
     gaps?: Gap[];
     /**
-     * MCP callers left out of `agent_tool_calls`, matched inside the user agent.
-     * The default is the conformance suites (`<repo>-mcp-test`) and the studio's own tools.
+     * The site's own agents, left out of `agents`, `top_agents` and
+     * `agent_tool_calls`, matched inside the user agent. The default is the
+     * conformance suites (`<repo>-mcp-test`) and the studio's own tools.
      */
     ownAgents?: string[];
     /**
@@ -89,6 +90,7 @@ export interface DigestDay {
     bounces: number;
     /** Seconds from each visit's first view to its last, summed. */
     seconds: number;
+    agents: number;
     visitors_incl_agents: number;
     /** Clicks on links to the site's X handle; zero without a handle. */
     follow_clicks: number;
@@ -100,6 +102,13 @@ export interface Digest {
     bounce_rate: number | null;
     /** Mean seconds from a visit's first view to its last; null with no visits. */
     visit_duration: number | null;
+    /**
+     * Agents, counted as visitors are: an AI crawler, an MCP client, or anything
+     * else reading the machine surface (`trackAiBot`), one per address and user
+     * agent a day, the site's own left out. They run no page script, so they are
+     * never among `visitors`.
+     */
+    agents: number;
     /** Visitors plus every agent that sent an event, such as an MCP call. */
     visitors_incl_agents: number;
     /**
@@ -108,7 +117,7 @@ export interface Digest {
      * the archive cannot stand in for it: event figures always, all of them
      * when filtered.
      */
-    previous: Record<'visitors' | 'pageviews' | 'bounce_rate' | 'visit_duration' | 'visitors_incl_agents' | 'follow_clicks', number | null>;
+    previous: Record<'visitors' | 'pageviews' | 'bounce_rate' | 'visit_duration' | 'agents' | 'visitors_incl_agents' | 'follow_clicks', number | null>;
     /** The first UTC day this site counted itself, before which only `ViewDay` speaks; null with no views. */
     counted_from: string | null;
     top_sources: Ranked<'source', 'visitors'>;
@@ -125,6 +134,8 @@ export interface Digest {
         events: number;
         visitors: number;
     } | null;
+    /** Each agent by name: the roster's label, else what its user agent calls itself. */
+    top_agents: Ranked<'agent', 'visitors'>;
     agent_tool_calls: Ranked<'tool', 'events'>;
     gaps: Ranked<'query', 'events'>;
 }

package/dist/analytics.js

@@ -160,6 +160,11 @@ const VISIT_TEST = {
     country: v => `bool_or(country = ${v})`,
     device: v => `bool_or(device = ${v})`,
 };
+/**
+ * An agent's name from its event: the roster's label, else what its user agent
+ * calls itself, `compatible; X` or the first product token.
+ */
+const AGENT_NAME = `coalesce(props->>'bot', substring(props->>'ua' from 'compatible; ?([^/;) ]+)'), nullif(split_part(split_part(props->>'ua', '/', 1), ' ', 1), ''), '(unknown)')`;
 /**
  * Everything a report needs about one site's last `days` days, in one query.
  * Visitor figures count distinct visitors, so a person who comes back on
@@ -181,6 +186,8 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
     const follows = handle && `name = 'Outbound Link: Click' AND props->>'url' ILIKE ANY(${$([`%x.com/${handle}%`, `%twitter.com/${handle}%`])}::text[])`;
     const tests = STATS_FILTERS.flatMap(k => (filter[k] ? [VISIT_TEST[k]($(filter[k]))] : []));
     const day = (at) => `to_char(${at} AT TIME ZONE 'UTC', 'YYYY-MM-DD')`;
+    /** The site's own agents, as a test on an event's user agent. */
+    const ours = `coalesce(props->>'ua', '') ILIKE ANY(${$(ownAgents.map(a => `%${a}%`))}::text[])`;
     const gapSelects = gaps.map(g => {
         const prop = $(g.prop);
         return `(SELECT props->>${prop} AS query, count(*) AS events FROM e
@@ -210,6 +217,9 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
     ), e${s} AS (
       SELECT name, props, visitor, "createdAt" AS at FROM "Event" WHERE "siteId" = $1 AND ${at}
       ${tests.length ? `AND visitor IN (SELECT visitor FROM v${s})` : ''}
+    ), ag${s} AS (
+      SELECT visitor, at, ${AGENT_NAME} AS agent FROM e${s}
+      WHERE name IN ('AI Bot Visit', 'MCP Call') AND visitor IS NOT NULL AND NOT ${ours}
     ), a${s} AS (
       SELECT * FROM "ViewDay" WHERE "siteId" = $1 AND day >= ${dayAgo(back + 1)}${back ? ` AND day < ${dayAgo(back)}` : ''}${tests.length ? ' AND false' : ''}
     ), sessions${s} AS (
@@ -226,6 +236,7 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
       'pageviews', (SELECT count(*) FROM v${s}) + (SELECT pageviews FROM archived${s}),
       'bounce_rate', (SELECT round(100.0 * bounces / nullif(visits, 0)) FROM sessions${s}),
       'visit_duration', (SELECT round(seconds / nullif(visits, 0)) FROM sessions${s}),
+      'agents', (SELECT count(DISTINCT visitor) FROM ag${s}),
       'visitors_incl_agents', (SELECT count(DISTINCT visitor) FROM (SELECT visitor FROM v${s} UNION SELECT visitor FROM e${s}) u) + (SELECT visitors FROM archived${s})`;
     const [row] = (await sql(`WITH ${chain('', 0)}, ${chain('_p', 1)}, src AS (
       SELECT coalesce(source, '(none)') AS source, count(DISTINCT visitor) AS visitors FROM visits GROUP BY 1
@@ -243,17 +254,18 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
       'countries', ${list(merged('country', 'countries', 'SELECT country, count(DISTINCT visitor) FROM v WHERE country IS NOT NULL GROUP BY 1'), 10)},
       'devices', ${list(merged('device', 'devices', 'SELECT device, count(DISTINCT visitor) FROM v GROUP BY 1'))},
       'by_day', ${list(`SELECT date, sum(visitors) AS visitors, sum(pageviews) AS pageviews, sum(visits) AS visits, sum(bounces) AS bounces,
-          sum(seconds) AS seconds, sum(agents) AS visitors_incl_agents, sum(follows) AS follow_clicks FROM (
-          SELECT ${day('at')}, count(DISTINCT visitor), count(*), 0, 0, 0, 0, 0 FROM v GROUP BY 1
-          UNION ALL SELECT ${day('at')}, 0, 0, count(*), count(*) FILTER (WHERE views = 1), coalesce(sum(seconds), 0), 0, 0 FROM visits GROUP BY 1
-          UNION ALL SELECT ${day('at')}, 0, 0, 0, 0, 0, count(DISTINCT visitor), 0 FROM (SELECT at, visitor FROM v UNION ALL SELECT at, visitor FROM e) u GROUP BY 1
-          ${follows ? `UNION ALL SELECT ${day('at')}, 0, 0, 0, 0, 0, 0, count(*) FROM e WHERE ${follows} GROUP BY 1` : ''}
-          UNION ALL SELECT to_char(day, 'YYYY-MM-DD'), visitors, pageviews, visits, bounces, seconds, visitors, 0 FROM a
-        ) t(date, visitors, pageviews, visits, bounces, seconds, agents, follows) GROUP BY 1`, undefined, '1')},
+          sum(seconds) AS seconds, sum(agents) AS agents, sum(everyone) AS visitors_incl_agents, sum(follows) AS follow_clicks FROM (
+          SELECT ${day('at')}, count(DISTINCT visitor), count(*), 0, 0, 0, 0, 0, 0 FROM v GROUP BY 1
+          UNION ALL SELECT ${day('at')}, 0, 0, count(*), count(*) FILTER (WHERE views = 1), coalesce(sum(seconds), 0), 0, 0, 0 FROM visits GROUP BY 1
+          UNION ALL SELECT ${day('at')}, 0, 0, 0, 0, 0, count(DISTINCT visitor), 0, 0 FROM ag GROUP BY 1
+          UNION ALL SELECT ${day('at')}, 0, 0, 0, 0, 0, 0, count(DISTINCT visitor), 0 FROM (SELECT at, visitor FROM v UNION ALL SELECT at, visitor FROM e) u GROUP BY 1
+          ${follows ? `UNION ALL SELECT ${day('at')}, 0, 0, 0, 0, 0, 0, 0, count(*) FROM e WHERE ${follows} GROUP BY 1` : ''}
+          UNION ALL SELECT to_char(day, 'YYYY-MM-DD'), visitors, pageviews, visits, bounces, seconds, 0, visitors, 0 FROM a
+        ) t(date, visitors, pageviews, visits, bounces, seconds, agents, everyone, follows) GROUP BY 1`, undefined, '1')},
       'follow_clicks', ${follows ? `(SELECT json_build_object('events', count(*), 'visitors', count(DISTINCT visitor)) FROM e WHERE ${follows})` : 'NULL'},
+      'top_agents', ${list('SELECT agent, count(DISTINCT visitor) AS visitors FROM ag GROUP BY 1', 10)},
       'agent_tool_calls', ${list(`SELECT coalesce(props->>'tool', '(none)') AS tool, count(*) AS events FROM e
-         WHERE name = 'MCP Call' AND props->>'method' = 'tools/call'
-           AND NOT coalesce(props->>'ua', '') ILIKE ANY(${$(ownAgents.map(a => `%${a}%`))}::text[])
+         WHERE name = 'MCP Call' AND props->>'method' = 'tools/call' AND NOT ${ours}
          GROUP BY 1`, 10)},
       'gaps', ${gapSelects.length ? `(SELECT coalesce(json_agg(t), '[]') FROM (${gapSelects.join(' UNION ALL ')}) t)` : `'[]'::json`}
     ) AS digest`, ...values));
@@ -267,7 +279,7 @@ export async function digest(sql, { site = '', days, handle, siblings = [], gaps
             for (const k of Object.keys(p))
                 p[k] = null;
         else
-            p.visitors_incl_agents = p.follow_clicks = null;
+            p.agents = p.visitors_incl_agents = p.follow_clicks = null;
     }
     return d;
 }

package/dist/crawlers.d.ts

@@ -46,16 +46,20 @@ export declare function crawlerRules(opts: {
     searchDisallow?: string | string[];
 }): RobotsGroup[];
 /**
- * Count an AI crawler's visit from a proxy, without holding up its response.
+ * Count an agent's visit from a proxy, without holding up its response: a
+ * crawler on the roster wherever it goes, and anything but a search engine
+ * that asks for what only agents read, since most agents are on no roster.
+ * The user agent is kept beside the label, so `digest` can name an agent the
+ * roster does not know and leave out the site's own.
  *
  * `load` is a dynamic import of the module that records it, because that
  * module pulls in a database client, and a static import would load it for
  * every request the proxy sees, bots or not. Three proxies wrote these lines.
- * Returns the bot's label, or null.
+ * Returns whether the request was counted.
  */
 export declare function trackAiBot(request: {
     url: string;
     headers: HeaderReader;
 }, event: {
     waitUntil(promise: Promise<unknown>): void;
-}, load: () => Promise<Pick<Tracker, 'trackEvent'>>): string | null;
+}, load: () => Promise<Pick<Tracker, 'trackEvent'>>): boolean;

package/dist/crawlers.js

@@ -1,7 +1,8 @@
 // crawlers.ts — one roster of AI crawler tokens, for both surfaces that need it.
 //
 // The proxy counts an "AI Bot Visit" by user-agent substring, and `robots.ts`
-// gives each agent its own group. Both read this one roster.
+// gives each agent its own group. Both read this one roster. The proxy also
+// counts any agent reading the machine surface, roster or not.
 //
 // One difference between the two uses is deliberate. `Applebot-Extended`
 // never fetches a page: it is a robots.txt-only token that Applebot consults
@@ -11,6 +12,7 @@
 // Every other token appears in both, because a crawler obeys only its
 // most-specific matching group: an agent with no group of its own falls through
 // to `*` and is granted whatever that grants.
+import { wantsMarkdown } from './http.js';
 /**
  * Order is significant: `detectAiBot` returns the first token the user agent
  * contains, so a token that is a substring of another must come after it.
@@ -113,16 +115,30 @@ export function crawlerRules(opts) {
     ];
 }
 /**
- * Count an AI crawler's visit from a proxy, without holding up its response.
+ * What only an agent asks for: a markdown twin, an `llms` export, the OpenAPI
+ * document, a well-known descriptor. MCP is left out, since "MCP Call" counts it.
+ */
+const AGENT_ONLY = /\.md$|^\/llms[\w-]*\.txt$|^\/openapi\.json$|^\/\.well-known\//;
+/**
+ * Count an agent's visit from a proxy, without holding up its response: a
+ * crawler on the roster wherever it goes, and anything but a search engine
+ * that asks for what only agents read, since most agents are on no roster.
+ * The user agent is kept beside the label, so `digest` can name an agent the
+ * roster does not know and leave out the site's own.
  *
  * `load` is a dynamic import of the module that records it, because that
  * module pulls in a database client, and a static import would load it for
  * every request the proxy sees, bots or not. Three proxies wrote these lines.
- * Returns the bot's label, or null.
+ * Returns whether the request was counted.
  */
 export function trackAiBot(request, event, load) {
-    const bot = detectAiBot(request.headers.get('user-agent'));
-    if (bot)
-        event.waitUntil(load().then(m => m.trackEvent('AI Bot Visit', request.url, { bot }, request.headers)));
-    return bot;
+    const ua = request.headers.get('user-agent') ?? '';
+    const bot = detectAiBot(ua);
+    const agent = bot !== null ||
+        (!!ua && !SEARCH_ENGINES.some(s => ua.includes(s)) && (AGENT_ONLY.test(new URL(request.url).pathname) || wantsMarkdown(request)));
+    if (agent) {
+        const props = { ...(bot ? { bot } : {}), ua: ua.slice(0, 80) };
+        event.waitUntil(load().then(m => m.trackEvent('AI Bot Visit', request.url, props, request.headers)));
+    }
+    return agent;
 }

package/dist/headers.d.ts

@@ -30,7 +30,7 @@ interface WikiNextConfig {
     distDir?: string;
     experimental?: object;
     images?: object;
-    headers?: () => Promise<unknown[]>;
+    headers?: () => Promise<unknown[]> | unknown[];
 }
 /**
  * An app's Next config with the settings every app here wrote out the same way:
@@ -46,7 +46,8 @@ interface WikiNextConfig {
  *   Next's dev runtime is inline and `eval`. An origin that sets its policy
  *   per request (a nonce) passes none.
  *
- * Anything the app sets wins, and its own `headers()` follow these.
+ * Anything the app sets wins, and its own `headers()` follow these. Pass
+ * `NextConfig` as `T` so the object is typed as Next's own config.
  */
 export declare function withWikiDefaults<T extends WikiNextConfig>(config: T, { csp }?: {
     csp?: string;

package/dist/headers.js

@@ -93,7 +93,8 @@ export function securityHeaders(csp) {
  *   Next's dev runtime is inline and `eval`. An origin that sets its policy
  *   per request (a nonce) passes none.
  *
- * Anything the app sets wins, and its own `headers()` follow these.
+ * Anything the app sets wins, and its own `headers()` follow these. Pass
+ * `NextConfig` as `T` so the object is typed as Next's own config.
  */
 export function withWikiDefaults(config, { csp } = {}) {
     return {

package/dist/http.d.ts

@@ -74,7 +74,7 @@ export declare function markdownHeaders(lastModified?: string | null, opts?: {
 export declare function wantsMarkdown(request: {
     url: string;
     headers: {
-        get(name: string): string | null;
+        get(name: string): string | null | undefined;
     };
 }): boolean;
 /** The header every response from a content-negotiated URL carries. */

package/dist/stats-figures.js

@@ -24,6 +24,7 @@ function change(now, before, { points = false, lowerIsBetter = false } = {}) {
 }
 const figuresOf = ({ previous: p, ...d }) => [
     { label: 'Visitors', value: count(d.visitors), delta: change(d.visitors, p.visitors), day: r => r.visitors },
+    { label: 'Agents', value: count(d.agents), delta: change(d.agents, p.agents), day: r => r.agents },
     { label: 'Page views', value: count(d.pageviews), delta: change(d.pageviews, p.pageviews), day: r => r.pageviews },
     {
         label: 'Bounce rate',
@@ -39,12 +40,6 @@ const figuresOf = ({ previous: p, ...d }) => [
         day: r => (r.visits ? r.seconds / r.visits : null),
         format: duration,
     },
-    {
-        label: 'With agents',
-        value: count(d.visitors_incl_agents),
-        delta: change(d.visitors_incl_agents, p.visitors_incl_agents),
-        day: r => r.visitors_incl_agents,
-    },
     ...(d.follow_clicks
         ? [
             {
@@ -57,7 +52,7 @@ const figuresOf = ({ previous: p, ...d }) => [
         : []),
 ];
 const DAY = 86_400;
-const EMPTY = { date: '', visitors: 0, pageviews: 0, visits: 0, bounces: 0, seconds: 0, visitors_incl_agents: 0, follow_clicks: 0 };
+const EMPTY = { date: '', visitors: 0, pageviews: 0, visits: 0, bounces: 0, seconds: 0, agents: 0, visitors_incl_agents: 0, follow_clicks: 0 };
 /**
  * The figures as `.stats-figures button[aria-pressed]`, each with its change
  * as `.stats-delta[data-better]` for a stylesheet to colour, and the pressed one per

package/dist/stats.js

@@ -73,7 +73,7 @@ export function Stats({ digest: d, days, filter = {}, ranges = STATS_RANGES }) {
     // Each window is another digest, so a link rather than a button, pinned
     // with the chart's own controls.
     const windows = (_jsx("div", { role: "group", "aria-label": "Window", children: ranges.map(n => (_jsx("a", { href: href(n, filter), "aria-current": n === days ? 'page' : undefined, children: windowLabel(n) }, n))) }));
-    return (_jsxs("div", { className: "stats", children: [narrowed.length > 0 && (_jsxs("div", { className: "stats-filters", children: [_jsx("ul", { "aria-label": "Narrowed to", children: narrowed.map(k => (_jsx("li", { children: _jsxs("a", { href: href(days, { ...filter, [k]: undefined }), title: "Remove", children: [NAMES[k], ": ", k === 'country' ? country(filter[k]) : filter[k], " \u00D7"] }) }, k))) }), start < counted && d.counted_from && (_jsxs("p", { children: ["Narrowed figures start on ", d.counted_from, ", the first day this site counted its own visits."] }))] })), _jsx(StatsFigures, { digest: d, first: first, windows: windows }), _jsxs("div", { className: "stats-lists", children: [_jsx(StatsList, { title: "Pages", rows: rows(d.top_pages, 'page', 'visitors'), to: to('page') }), _jsx(StatsList, { title: "Entry pages", rows: rows(d.entry_pages, 'page', 'visitors'), to: to('entry') }), _jsx(StatsList, { title: "Sources", rows: rows(d.top_sources, 'source', 'visitors'), to: to('source') }), _jsx(StatsList, { title: "From X posts", rows: rows(d.from_posts, 'page', 'visitors'), to: v => href(days, { ...filter, source: 'x', entry: v }) }), _jsx(StatsList, { title: "Sibling sites", rows: rows(d.sibling_referrals, 'source', 'visitors'), to: to('source') }), _jsx(StatsList, { title: "Countries", rows: rows(d.countries, 'country', 'visitors'), label: country, to: to('country') }), _jsx(StatsList, { title: "Devices", rows: rows(d.devices, 'device', 'visitors'), to: to('device') }), _jsx(StatsList, { title: "Agent tool calls", rows: rows(d.agent_tool_calls, 'tool', 'events') }), _jsx(StatsList, { title: "Searches that found nothing", rows: rows(d.gaps, 'query', 'events') })] })] }));
+    return (_jsxs("div", { className: "stats", children: [narrowed.length > 0 && (_jsxs("div", { className: "stats-filters", children: [_jsx("ul", { "aria-label": "Narrowed to", children: narrowed.map(k => (_jsx("li", { children: _jsxs("a", { href: href(days, { ...filter, [k]: undefined }), title: "Remove", children: [NAMES[k], ": ", k === 'country' ? country(filter[k]) : filter[k], " \u00D7"] }) }, k))) }), start < counted && d.counted_from && (_jsxs("p", { children: ["Narrowed figures start on ", d.counted_from, ", the first day this site counted its own visits."] }))] })), _jsx(StatsFigures, { digest: d, first: first, windows: windows }), _jsxs("div", { className: "stats-lists", children: [_jsx(StatsList, { title: "Pages", rows: rows(d.top_pages, 'page', 'visitors'), to: to('page') }), _jsx(StatsList, { title: "Entry pages", rows: rows(d.entry_pages, 'page', 'visitors'), to: to('entry') }), _jsx(StatsList, { title: "Sources", rows: rows(d.top_sources, 'source', 'visitors'), to: to('source') }), _jsx(StatsList, { title: "From X posts", rows: rows(d.from_posts, 'page', 'visitors'), to: v => href(days, { ...filter, source: 'x', entry: v }) }), _jsx(StatsList, { title: "Sibling sites", rows: rows(d.sibling_referrals, 'source', 'visitors'), to: to('source') }), _jsx(StatsList, { title: "Countries", rows: rows(d.countries, 'country', 'visitors'), label: country, to: to('country') }), _jsx(StatsList, { title: "Devices", rows: rows(d.devices, 'device', 'visitors'), to: to('device') }), _jsx(StatsList, { title: "Agents", rows: rows(d.top_agents, 'agent', 'visitors') }), _jsx(StatsList, { title: "Agent tool calls", rows: rows(d.agent_tool_calls, 'tool', 'events') }), _jsx(StatsList, { title: "Searches that found nothing", rows: rows(d.gaps, 'query', 'events') })] })] }));
 }
 /**
  * A stats page's door: `children` for a signed-in reader, else a line saying

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-formant",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "description": "The portable half of a wiki: derived taxonomy and facet controls, a version-negotiating MCP transport, markdown twins, block rendering, a rich-text editor engine, conditional-GET plumbing, and the headers and CSP every origin sends.",
   "type": "module",
   "license": "MIT",