@tangle-network/browser-agent-driver 0.29.0 → 0.31.0

package/dist/reports/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/reports/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAA;AAI/D,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,qBAA0B,GAAG,MAAM,CAwChG;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CA6BlG;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2FAA2F;IAC3F,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,IAAI,GAAE,yBAA8B,GAAG,MAAM,CA+BxG;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE,wBAA6B,GAAG,MAAM,CAqD1F;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAWhD"}

package/dist/reports/templates.js

@@ -0,0 +1,200 @@
+/**
+ * Static report templates — markdown rendering of pre-aggregated data.
+ *
+ * No LLM. The narration layer (narrate.ts) wraps these with prose; the
+ * templates themselves are pure functions of data so they're snapshot-testable
+ * and deterministic.
+ */
+import { leaderboard, longitudinalFor, tierBuckets, compareRuns } from './aggregate.js';
+import { aggregateTokens, diffTokens, groupByUrl } from './tokens.js';
+export function renderLeaderboard(rows, opts = {}) {
+    const lines = [];
+    const title = opts.title ?? 'Design Audit Leaderboard';
+    lines.push(`# ${title}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    if (opts.byType) {
+        lines.push(`Filtered to page-type: \`${opts.byType}\``);
+        lines.push('');
+    }
+    const ranked = leaderboard(rows, { topN: opts.topN, byType: opts.byType });
+    lines.push(`## Ranked sites (${ranked.length})`);
+    lines.push('');
+    lines.push('| # | URL | Page type | Rollup | Top dim | Bottom dim | Ethics |');
+    lines.push('|---|-----|-----------|--------|---------|------------|--------|');
+    ranked.forEach((r, i) => {
+        const dims = Object.entries(r.dimensions);
+        dims.sort((a, b) => b[1] - a[1]);
+        const top = dims[0] ? `${dims[0][0]} ${dims[0][1].toFixed(1)}` : '—';
+        const bot = dims[dims.length - 1] ? `${dims[dims.length - 1][0]} ${dims[dims.length - 1][1].toFixed(1)}` : '—';
+        lines.push(`| ${i + 1} | ${escapeMd(r.url)} | ${r.pageType ?? '?'} | ${r.rollupScore.toFixed(2)} | ${top} | ${bot} | ${r.ethicsViolations} |`);
+    });
+    lines.push('');
+    if (opts.buckets && opts.buckets.length > 0) {
+        const buckets = tierBuckets(rows, opts.buckets);
+        lines.push('## Tiers');
+        lines.push('');
+        lines.push('| Tier | N | Mean | Median |');
+        lines.push('|------|---|------|--------|');
+        for (const b of buckets) {
+            lines.push(`| ${b.label} | ${b.rows.length} | ${fmt(b.meanScore)} | ${fmt(b.medianScore)} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function renderLongitudinal(rows, opts = {}) {
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Longitudinal Design Audit'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    const urls = opts.urls ?? Array.from(new Set(rows.map(r => r.url)));
+    for (const url of urls) {
+        const series = longitudinalFor(rows, url);
+        if (series.length === 0)
+            continue;
+        lines.push(`## ${escapeMd(url)}`);
+        lines.push('');
+        lines.push('| Captured | Rollup | Page type |');
+        lines.push('|----------|--------|-----------|');
+        for (const s of series) {
+            lines.push(`| ${s.capturedAt.slice(0, 10)} | ${s.rollupScore.toFixed(2)} | ${s.pageType ?? '?'} |`);
+        }
+        const first = series[0];
+        const last = series[series.length - 1];
+        if (first && last && first !== last) {
+            const delta = last.rollupScore - first.rollupScore;
+            const sign = delta >= 0 ? '+' : '';
+            lines.push('');
+            lines.push(`Net change ${first.capturedAt.slice(0, 10)} → ${last.capturedAt.slice(0, 10)}: **${sign}${delta.toFixed(2)}**`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function renderBatchComparison(rows, opts = {}) {
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Batch Comparison'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    let pairs = opts.pairs ?? [];
+    if (pairs.length === 0) {
+        const urls = Array.from(new Set(rows.map(r => r.url)));
+        if (urls.length >= 2)
+            pairs = [[urls[0], urls[1]]];
+    }
+    for (const [aUrl, bUrl] of pairs) {
+        const a = rows.find(r => r.url === aUrl && Number.isFinite(r.rollupScore));
+        const b = rows.find(r => r.url === bUrl && Number.isFinite(r.rollupScore));
+        if (!a || !b)
+            continue;
+        const cmp = compareRuns(a, b);
+        lines.push(`## ${escapeMd(aUrl)} vs ${escapeMd(bUrl)}`);
+        lines.push('');
+        lines.push(`Rollup delta: **${signed(cmp.rollupDelta)}** (a ${a.rollupScore.toFixed(2)} – b ${b.rollupScore.toFixed(2)})`);
+        lines.push('');
+        if (cmp.perDimension.length > 0) {
+            lines.push('| Dimension | a | b | Δ |');
+            lines.push('|-----------|---|---|---|');
+            for (const d of cmp.perDimension) {
+                lines.push(`| ${d.dim} | ${d.afterScore.toFixed(1)} | ${d.beforeScore.toFixed(1)} | ${signed(d.delta)} |`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a per-URL brand-kit evolution: for each URL, list the snapshots in
+ * chronological order with their distinct color palette, font families, and
+ * detected libraries. Between consecutive snapshots, surface the delta
+ * (colors added/removed, families added/removed, brand-meta changes).
+ */
+export function renderBrandEvolution(job, opts = {}) {
+    const summaries = aggregateTokens(job);
+    const lines = [];
+    lines.push(`# ${opts.title ?? 'Brand & Design-System Evolution'}`);
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    if (summaries.length === 0) {
+        lines.push(`_No tokens.json files were produced. Run the job with \`audit.extractTokens: true\` to enable._`);
+        return lines.join('\n');
+    }
+    const topColors = opts.topColors ?? 6;
+    const series = groupByUrl(summaries);
+    for (const { url, snapshots } of series) {
+        lines.push(`## ${escapeMd(url)}`);
+        lines.push('');
+        for (let i = 0; i < snapshots.length; i++) {
+            const s = snapshots[i];
+            const captured = s.capturedAt ? s.capturedAt.slice(0, 10) : 'live';
+            lines.push(`### ${captured}`);
+            lines.push('');
+            const swatches = s.colors.slice(0, topColors).map(c => `\`${c.hex}\` ×${c.count}`).join(' · ');
+            lines.push(`**Top colors**: ${swatches || '_none extracted_'}`);
+            const families = s.fontFamilies.map(f => `${f.family} (${f.classification})`).join(', ');
+            lines.push(`**Font families**: ${families || '_none_'}`);
+            lines.push(`**Type-scale entries**: ${s.typeScaleEntries}`);
+            if (s.detectedLibraries.length > 0)
+                lines.push(`**Detected libraries**: ${s.detectedLibraries.join(', ')}`);
+            if (s.brand?.themeColor)
+                lines.push(`**Theme color**: \`${s.brand.themeColor}\``);
+            if (s.logos.length > 0)
+                lines.push(`**Logos**: ${s.logos.length}`);
+            lines.push('');
+            // Snapshot-to-snapshot delta against the previous snapshot in the series.
+            const prev = snapshots[i - 1];
+            if (prev) {
+                const d = diffTokens(prev, s);
+                const callouts = [];
+                if (d.colorsAdded.length > 0)
+                    callouts.push(`+${d.colorsAdded.length} new colors`);
+                if (d.colorsRemoved.length > 0)
+                    callouts.push(`−${d.colorsRemoved.length} removed`);
+                if (d.familiesAdded.length > 0)
+                    callouts.push(`+ ${d.familiesAdded.join(', ')}`);
+                if (d.familiesRemoved.length > 0)
+                    callouts.push(`− ${d.familiesRemoved.join(', ')}`);
+                if (d.librariesAdded.length > 0)
+                    callouts.push(`adopted ${d.librariesAdded.join(', ')}`);
+                if (d.librariesRemoved.length > 0)
+                    callouts.push(`dropped ${d.librariesRemoved.join(', ')}`);
+                if (d.brandChanges.length > 0)
+                    callouts.push(`brand meta: ${d.brandChanges.map(c => c.field).join(', ')} changed`);
+                if (callouts.length > 0) {
+                    lines.push(`_Δ vs ${prev.capturedAt?.slice(0, 10) ?? 'previous'}: ${callouts.join(' · ')}_`);
+                    lines.push('');
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+export function renderJobHeader(job) {
+    const ok = job.results.filter(r => r.status === 'ok').length;
+    const fail = job.results.filter(r => r.status === 'failed').length;
+    const skip = job.results.filter(r => r.status === 'skipped').length;
+    return [
+        `**Job**: \`${job.jobId}\``,
+        job.spec.label ? `**Label**: ${job.spec.label}` : undefined,
+        `**Targets**: ${job.targets.length}  ·  ok: ${ok}  ·  failed: ${fail}  ·  skipped: ${skip}`,
+        `**Cost**: $${job.totalCostUSD.toFixed(2)}`,
+        `**Status**: ${job.status}`,
+    ].filter(Boolean).join('  \n');
+}
+function escapeMd(s) {
+    return s.replace(/\|/g, '\\|');
+}
+function signed(n) {
+    if (!Number.isFinite(n))
+        return '—';
+    return (n >= 0 ? '+' : '') + n.toFixed(2);
+}
+function fmt(n) {
+    return Number.isFinite(n) ? n.toFixed(2) : '—';
+}
+//# sourceMappingURL=templates.js.map

package/dist/reports/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/reports/templates.ts"],"names":[],"mappings":"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"}

package/dist/reports/tokens.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Brand-kit / design-token aggregation across a job's targets.
+ *
+ * Reads each per-target `tokens.json` (produced when AuditOptions.extractTokens
+ * was true) and projects to a flat row shape so longitudinal evolution and
+ * batch comparison templates can render without re-implementing extraction.
+ *
+ * No LLM. Pure function of on-disk data — same contract as aggregate.ts.
+ *
+ * Schema-version contract: `tokens.json` files older than `MIN_TOKENS_SCHEMA`
+ * are skipped with a warning. The aggregator never silently coerces old
+ * shapes — better empty rows than wrong rows.
+ */
+import type { Job } from '../jobs/types.js';
+import type { DesignTokens, ColorToken, FontFamily } from '../types.js';
+/** Minimum acceptable schemaVersion for tokens.json. Bump when the shape changes incompatibly. */
+export declare const MIN_TOKENS_SCHEMA = 1;
+/** Most recent schemaVersion we know how to read. Future versions will warn but still attempt to parse. */
+export declare const CURRENT_TOKENS_SCHEMA = 1;
+export interface TokenSummary {
+    /** Seed URL (groups snapshots of the same site). */
+    url: string;
+    /** Snapshot URL when wayback. */
+    snapshotUrl?: string;
+    /** ISO datetime of capture. */
+    capturedAt?: string;
+    /** Per-target runId (== outputDir for jobs). */
+    runId: string;
+    /** Resolved on-disk path to tokens.json. */
+    tokensPath?: string;
+    /** Top-level brand metadata (title, theme color, favicon, og image). */
+    brand: DesignTokens['brand'];
+    /** All distinct colors, sorted desc by usage count. */
+    colors: ColorToken[];
+    /** Distinct typography families with classification + weight set. */
+    fontFamilies: FontFamily[];
+    /** Type-scale entry count (proxy for typographic complexity). */
+    typeScaleEntries: number;
+    /** Logo asset URLs (svg + raster). */
+    logos: string[];
+    /** Loaded font-file URLs. */
+    fontFiles: string[];
+    /** Detected libraries (e.g. ['tailwind','radix-ui']). */
+    detectedLibraries: string[];
+}
+/** Read each ok result's tokens.json and project to TokenSummary. */
+export declare function aggregateTokens(job: Job): TokenSummary[];
+/**
+ * Diff between two TokenSummary records. Useful for "this URL evolved from
+ * 4 colors → 12 colors and dropped Helvetica for Inter" callouts.
+ */
+export interface TokenDiff {
+    colorsAdded: string[];
+    colorsRemoved: string[];
+    colorsCommon: number;
+    familiesAdded: string[];
+    familiesRemoved: string[];
+    brandChanges: Array<{
+        field: keyof DesignTokens['brand'];
+        before: string | undefined;
+        after: string | undefined;
+    }>;
+    librariesAdded: string[];
+    librariesRemoved: string[];
+}
+export declare function diffTokens(a: TokenSummary, b: TokenSummary): TokenDiff;
+/**
+ * Group token summaries by URL and return a chronological evolution series.
+ * Returns one entry per URL; each carries the sequence of TokenSummary rows
+ * sorted by capturedAt (or insertion order when capturedAt is missing).
+ */
+export interface TokenSeries {
+    url: string;
+    snapshots: TokenSummary[];
+}
+export declare function groupByUrl(summaries: TokenSummary[]): TokenSeries[];
+//# sourceMappingURL=tokens.d.ts.map

package/dist/reports/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/reports/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEvE,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC5B,uDAAuD;IACvD,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,qEAAqE;IACrE,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAA;IACxB,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,YAAY,EAAE,CA8BxD;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;IAClH,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,CAuBtE;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,YAAY,EAAE,CAAA;CAC1B;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAYnE"}

package/dist/reports/tokens.js

@@ -0,0 +1,88 @@
+/**
+ * Brand-kit / design-token aggregation across a job's targets.
+ *
+ * Reads each per-target `tokens.json` (produced when AuditOptions.extractTokens
+ * was true) and projects to a flat row shape so longitudinal evolution and
+ * batch comparison templates can render without re-implementing extraction.
+ *
+ * No LLM. Pure function of on-disk data — same contract as aggregate.ts.
+ *
+ * Schema-version contract: `tokens.json` files older than `MIN_TOKENS_SCHEMA`
+ * are skipped with a warning. The aggregator never silently coerces old
+ * shapes — better empty rows than wrong rows.
+ */
+import * as fs from 'node:fs';
+/** Minimum acceptable schemaVersion for tokens.json. Bump when the shape changes incompatibly. */
+export const MIN_TOKENS_SCHEMA = 1;
+/** Most recent schemaVersion we know how to read. Future versions will warn but still attempt to parse. */
+export const CURRENT_TOKENS_SCHEMA = 1;
+/** Read each ok result's tokens.json and project to TokenSummary. */
+export function aggregateTokens(job) {
+    const out = [];
+    for (const r of job.results) {
+        if (r.status !== 'ok' || !r.tokensPath || !fs.existsSync(r.tokensPath))
+            continue;
+        try {
+            const raw = JSON.parse(fs.readFileSync(r.tokensPath, 'utf-8'));
+            // Only enforce when schemaVersion is present. Pre-versioned files (the
+            // bulk of existing jobs at the time this check landed) are accepted as
+            // implicitly v1 — see CURRENT_TOKENS_SCHEMA.
+            if (typeof raw.schemaVersion === 'number' && raw.schemaVersion < MIN_TOKENS_SCHEMA)
+                continue;
+            const tokens = raw;
+            out.push({
+                url: r.url,
+                snapshotUrl: r.snapshotUrl,
+                capturedAt: r.capturedAt,
+                runId: r.runId ?? '',
+                tokensPath: r.tokensPath,
+                brand: tokens.brand ?? {},
+                colors: (tokens.colors ?? []).slice().sort((a, b) => (b.count ?? 0) - (a.count ?? 0)),
+                fontFamilies: tokens.typography?.families ?? [],
+                typeScaleEntries: tokens.typography?.scale?.length ?? 0,
+                logos: (tokens.logos ?? []).map(l => l.src ?? '').filter(Boolean),
+                fontFiles: (tokens.fontFiles ?? []).map(f => f.src).filter(Boolean),
+                detectedLibraries: tokens.detectedLibraries ?? [],
+            });
+        }
+        catch {
+            // Skip corrupted token files.
+        }
+    }
+    return out;
+}
+export function diffTokens(a, b) {
+    const aHex = new Set(a.colors.map(c => c.hex.toLowerCase()));
+    const bHex = new Set(b.colors.map(c => c.hex.toLowerCase()));
+    const colorsAdded = [...bHex].filter(h => !aHex.has(h));
+    const colorsRemoved = [...aHex].filter(h => !bHex.has(h));
+    const colorsCommon = [...aHex].filter(h => bHex.has(h)).length;
+    const aFam = new Set(a.fontFamilies.map(f => f.family));
+    const bFam = new Set(b.fontFamilies.map(f => f.family));
+    const familiesAdded = [...bFam].filter(f => !aFam.has(f));
+    const familiesRemoved = [...aFam].filter(f => !bFam.has(f));
+    const brandFields = ['title', 'description', 'themeColor', 'favicon', 'ogImage'];
+    const brandChanges = brandFields
+        .filter(f => (a.brand?.[f] ?? '') !== (b.brand?.[f] ?? ''))
+        .map(f => ({ field: f, before: a.brand?.[f], after: b.brand?.[f] }));
+    const aLib = new Set(a.detectedLibraries);
+    const bLib = new Set(b.detectedLibraries);
+    const librariesAdded = [...bLib].filter(l => !aLib.has(l));
+    const librariesRemoved = [...aLib].filter(l => !bLib.has(l));
+    return { colorsAdded, colorsRemoved, colorsCommon, familiesAdded, familiesRemoved, brandChanges, librariesAdded, librariesRemoved };
+}
+export function groupByUrl(summaries) {
+    const map = new Map();
+    for (const s of summaries) {
+        if (!map.has(s.url))
+            map.set(s.url, []);
+        map.get(s.url).push(s);
+    }
+    const out = [];
+    for (const [url, snapshots] of map.entries()) {
+        snapshots.sort((a, b) => (a.capturedAt ?? '').localeCompare(b.capturedAt ?? ''));
+        out.push({ url, snapshots });
+    }
+    return out;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/reports/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/reports/tokens.ts"],"names":[],"mappings":"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"}

package/dist/reports/tools.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AI SDK tool surface for the report agent.
+ *
+ * These tools let an LLM agent (browser-side chat, Claude Code, anywhere
+ * AI SDK runs) interrogate a job's audit results. The contract is strict:
+ * every numerical claim the agent makes must come from a tool result, never
+ * from its own arithmetic. Templates are deterministic; the agent narrates.
+ *
+ * The tools use plain JSONSchema (`jsonSchema` from `ai`) rather than zod so
+ * we don't add a dependency. Schemas are intentionally minimal — agents prefer
+ * concise tool surfaces.
+ */
+import type { AggregateRow } from './types.js';
+export interface ReportToolsContext {
+    /** Override jobs dir (tests). */
+    jobsDir?: string;
+    /** Override the resolver for `runFreshAudit` so tests/CLIs can plug in their own pipeline. */
+    runFreshAudit?: (url: string) => Promise<{
+        runId: string;
+        resultPath: string;
+        rollupScore?: number;
+    }>;
+}
+export declare function buildReportTools(ctx?: ReportToolsContext): {
+    readonly queryJob: import("ai").Tool<{
+        jobId: string;
+        byType?: string;
+        topN?: number;
+        direction?: "asc" | "desc";
+    }, AggregateRow[]>;
+    readonly fetchAudit: import("ai").Tool<{
+        jobId: string;
+        runId: string;
+    }, any>;
+    readonly compareRuns: import("ai").Tool<{
+        jobId: string;
+        runIdA: string;
+        runIdB: string;
+    }, import("./types.js").CompareRunsResult>;
+    readonly longitudinal: import("ai").Tool<{
+        jobId: string;
+        url: string;
+    }, import("./types.js").LongitudinalRow[]>;
+    readonly tierBuckets: import("ai").Tool<{
+        jobId: string;
+        boundaries: number[];
+    }, import("./aggregate.js").TierBucket[]>;
+    readonly renderTemplate: import("ai").Tool<{
+        jobId: string;
+        template: "leaderboard" | "longitudinal" | "batch-comparison" | "brand-evolution";
+        title?: string;
+        topN?: number;
+        byType?: string;
+        buckets?: number[];
+    }, {
+        markdown: string;
+    }>;
+    readonly fetchTokens: import("ai").Tool<{
+        jobId: string;
+        url?: string;
+    }, import("./tokens.js").TokenSummary[]>;
+    readonly diffTokens: import("ai").Tool<{
+        jobId: string;
+        runIdA: string;
+        runIdB: string;
+    }, import("./tokens.js").TokenDiff>;
+    readonly runFreshAudit: import("ai").Tool<{
+        url: string;
+    }, {
+        runId: string;
+        resultPath: string;
+        rollupScore?: number;
+    }>;
+};
+export type ReportToolSet = ReturnType<typeof buildReportTools>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/reports/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/reports/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACtG;AAQD,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,kBAAuB;;eAItB,MAAM;iBAAW,MAAM;eAAS,MAAM;oBAAc,KAAK,GAAG,MAAM;;;eAkBlE,MAAM;eAAS,MAAM;;;eAqBrB,MAAM;gBAAU,MAAM;gBAAU,MAAM;;;eAoBtC,MAAM;aAAO,MAAM;;;eAgBnB,MAAM;oBAAc,MAAM,EAAE;;;eAiBpD,MAAM;kBACH,aAAa,GAAG,cAAc,GAAG,kBAAkB,GAAG,iBAAiB;gBACzE,MAAM;eACP,MAAM;iBACJ,MAAM;kBACL,MAAM,EAAE;;;;;eA4Ba,MAAM;cAAQ,MAAM;;;eAsBpB,MAAM;gBAAU,MAAM;gBAAU,MAAM;;;aAsBxC,MAAM;;eAtLS,MAAM;oBAAc,MAAM;sBAAgB,MAAM;;EAmMnG;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA"}