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

package/dist/reports/tools.js

@@ -0,0 +1,205 @@
+/**
+ * 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 { tool, jsonSchema } from 'ai';
+import * as fs from 'node:fs';
+import { loadJob } from '../jobs/store.js';
+import { aggregateJob, leaderboard, longitudinalFor, compareRuns, tierBuckets } from './aggregate.js';
+import { aggregateTokens, diffTokens as diffTokensFn, groupByUrl } from './tokens.js';
+import { renderLeaderboard, renderLongitudinal, renderBatchComparison, renderBrandEvolution } from './templates.js';
+function rowsForJob(jobId, jobsDir) {
+    const job = loadJob(jobId, jobsDir);
+    if (!job)
+        throw new Error(`job not found: ${jobId}`);
+    return aggregateJob(job);
+}
+export function buildReportTools(ctx = {}) {
+    return {
+        queryJob: tool({
+            description: 'Return aggregated rows for every audited target in a job (filtered/ranked). Use this for any leaderboard, ranking, or scope query.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    byType: { type: 'string', description: 'Filter to one page-type (saas-app, marketing, dashboard, ecommerce, ...).' },
+                    topN: { type: 'integer', minimum: 1 },
+                    direction: { type: 'string', enum: ['asc', 'desc'], description: 'Default desc (highest scores first).' },
+                },
+                required: ['jobId'],
+            }),
+            execute: async ({ jobId, byType, topN, direction }) => {
+                const rows = rowsForJob(jobId, ctx.jobsDir);
+                return leaderboard(rows, { byType, topN, direction });
+            },
+        }),
+        fetchAudit: tool({
+            description: 'Fetch the full report.json for a single audit run by runId. Use sparingly — only when the agent needs finding-level detail beyond aggregated scores.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    runId: { type: 'string' },
+                },
+                required: ['jobId', 'runId'],
+            }),
+            execute: async ({ jobId, runId }) => {
+                const job = loadJob(jobId, ctx.jobsDir);
+                if (!job)
+                    throw new Error(`job not found: ${jobId}`);
+                const entry = job.results.find(r => r.runId === runId);
+                if (!entry || !entry.resultPath || !fs.existsSync(entry.resultPath)) {
+                    throw new Error(`runId not found or report.json missing: ${runId}`);
+                }
+                return JSON.parse(fs.readFileSync(entry.resultPath, 'utf-8'));
+            },
+        }),
+        compareRuns: tool({
+            description: 'Compute a deterministic dimension-by-dimension diff between two audited runs in the same job. Returns rollupDelta and per-dimension deltas.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    runIdA: { type: 'string' },
+                    runIdB: { type: 'string' },
+                },
+                required: ['jobId', 'runIdA', 'runIdB'],
+            }),
+            execute: async ({ jobId, runIdA, runIdB }) => {
+                const rows = rowsForJob(jobId, ctx.jobsDir);
+                const a = rows.find(r => r.runId === runIdA);
+                const b = rows.find(r => r.runId === runIdB);
+                if (!a || !b)
+                    throw new Error(`runId not found in job: ${!a ? runIdA : runIdB}`);
+                return compareRuns(a, b);
+            },
+        }),
+        longitudinal: tool({
+            description: 'For wayback-expanded jobs, return the time series of scores for one URL (sorted oldest → newest). Use this for "how has X evolved" questions.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    url: { type: 'string' },
+                },
+                required: ['jobId', 'url'],
+            }),
+            execute: async ({ jobId, url }) => {
+                const rows = rowsForJob(jobId, ctx.jobsDir);
+                return longitudinalFor(rows, url);
+            },
+        }),
+        tierBuckets: tool({
+            description: 'Bucket a job\'s ranked results into tier slices (e.g. boundaries [10, 100, 200] → top 10 / 11–100 / 101–200 / 201+).',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    boundaries: { type: 'array', items: { type: 'integer', minimum: 1 } },
+                },
+                required: ['jobId', 'boundaries'],
+            }),
+            execute: async ({ jobId, boundaries }) => {
+                const rows = rowsForJob(jobId, ctx.jobsDir);
+                return tierBuckets(rows, boundaries);
+            },
+        }),
+        renderTemplate: tool({
+            description: 'Render a deterministic markdown report from a job. Use this when the user wants a shareable artifact, not a free-form answer.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    template: { type: 'string', enum: ['leaderboard', 'longitudinal', 'batch-comparison', 'brand-evolution'] },
+                    title: { type: 'string' },
+                    topN: { type: 'integer', minimum: 1 },
+                    byType: { type: 'string' },
+                    buckets: { type: 'array', items: { type: 'integer', minimum: 1 } },
+                },
+                required: ['jobId', 'template'],
+            }),
+            execute: async ({ jobId, template, title, topN, byType, buckets }) => {
+                if (template === 'brand-evolution') {
+                    const job = loadJob(jobId, ctx.jobsDir);
+                    if (!job)
+                        throw new Error(`job not found: ${jobId}`);
+                    return { markdown: renderBrandEvolution(job, { title }) };
+                }
+                const rows = rowsForJob(jobId, ctx.jobsDir);
+                if (template === 'leaderboard')
+                    return { markdown: renderLeaderboard(rows, { title, topN, byType, buckets }) };
+                if (template === 'longitudinal')
+                    return { markdown: renderLongitudinal(rows, { title }) };
+                return { markdown: renderBatchComparison(rows, { title }) };
+            },
+        }),
+        fetchTokens: tool({
+            description: 'Return aggregated brand-kit token summaries (colors, fonts, libraries, brand metadata) for every audited target that had token extraction enabled. Use for "what colors does X use" or "how has the design system evolved" questions.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    url: { type: 'string', description: 'Filter to one URL (returns the chronological series).' },
+                },
+                required: ['jobId'],
+            }),
+            execute: async ({ jobId, url }) => {
+                const job = loadJob(jobId, ctx.jobsDir);
+                if (!job)
+                    throw new Error(`job not found: ${jobId}`);
+                const summaries = aggregateTokens(job);
+                if (url) {
+                    const series = groupByUrl(summaries).find(s => s.url === url);
+                    return series ? series.snapshots : [];
+                }
+                return summaries;
+            },
+        }),
+        diffTokens: tool({
+            description: 'Compute the token delta (colors added/removed, font families added/removed, brand-meta changes, library swaps) between two audited targets in the same job.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    jobId: { type: 'string' },
+                    runIdA: { type: 'string' },
+                    runIdB: { type: 'string' },
+                },
+                required: ['jobId', 'runIdA', 'runIdB'],
+            }),
+            execute: async ({ jobId, runIdA, runIdB }) => {
+                const job = loadJob(jobId, ctx.jobsDir);
+                if (!job)
+                    throw new Error(`job not found: ${jobId}`);
+                const summaries = aggregateTokens(job);
+                const a = summaries.find(s => s.runId === runIdA);
+                const b = summaries.find(s => s.runId === runIdB);
+                if (!a || !b)
+                    throw new Error(`token summary not found for ${!a ? runIdA : runIdB} — was extractTokens enabled?`);
+                return diffTokensFn(a, b);
+            },
+        }),
+        runFreshAudit: tool({
+            description: 'Kick off a NEW single-page audit when the agent needs current data not in the job. Cost-bearing. Use sparingly.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: { url: { type: 'string' } },
+                required: ['url'],
+            }),
+            execute: async ({ url }) => {
+                if (!ctx.runFreshAudit) {
+                    throw new Error('runFreshAudit not wired in this context — host must inject a resolver');
+                }
+                return await ctx.runFreshAudit(url);
+            },
+        }),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/reports/tools.js.map

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

package/dist/reports/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Report shapes — flat rows that templates and tool calls share.
+ *
+ * `AggregateRow` is intentionally narrow (just the fields a leaderboard /
+ * comparison / longitudinal view needs). Anything richer should be loaded
+ * from `resultPath` on demand via `fetchAudit`.
+ */
+import type { Dimension } from '../design/audit/v2/types.js';
+export interface AggregateRow {
+    /** Seed URL (groups multiple snapshots of the same site together). */
+    url: string;
+    /** Snapshot URL (only set for wayback rows). */
+    snapshotUrl?: string;
+    /** ISO datetime of capture (only set for wayback rows). */
+    capturedAt?: string;
+    /** runId of the source audit. */
+    runId: string;
+    /** Page-type classification from the audit. */
+    pageType?: string;
+    /** Domain tag (e.g. "fintech", "health") from classification. */
+    domain?: string;
+    /** Rollup score (0-10). */
+    rollupScore: number;
+    /** Per-dimension scores (subset — only the v2 universal dimensions). */
+    dimensions: Partial<Record<Dimension, number>>;
+    /** Number of ethics violations detected. */
+    ethicsViolations: number;
+    /** Path to the per-run report.json for drill-down. */
+    resultPath?: string;
+}
+export interface DimensionDelta {
+    dim: Dimension;
+    beforeScore: number;
+    afterScore: number;
+    delta: number;
+}
+export interface CompareRunsResult {
+    a: AggregateRow;
+    b: AggregateRow;
+    rollupDelta: number;
+    /** Negative = a worse than b, positive = a better. */
+    perDimension: DimensionDelta[];
+}
+export interface LongitudinalRow {
+    url: string;
+    capturedAt: string;
+    rollupScore: number;
+    pageType?: string;
+}
+export type ReportTemplate = 'leaderboard' | 'longitudinal' | 'batch-comparison' | 'brand-evolution';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reports/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAE5D,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC9C,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,YAAY,CAAA;IACf,CAAC,EAAE,YAAY,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,YAAY,EAAE,cAAc,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,kBAAkB,GAAG,iBAAiB,CAAA"}

package/dist/reports/types.js

@@ -0,0 +1,9 @@
+/**
+ * Report shapes — flat rows that templates and tool calls share.
+ *
+ * `AggregateRow` is intentionally narrow (just the fields a leaderboard /
+ * comparison / longitudinal view needs). Anything richer should be loaded
+ * from `resultPath` on demand via `fetchAudit`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reports/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/browser-agent-driver",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "LLM-driven browser agent for UI automation, testing, and evaluation",
   "publishConfig": {
     "access": "public"
@@ -133,6 +133,7 @@
     "pixelmatch": "^7.1.0",
     "playwright": "^1.40.0",
     "pngjs": "^7.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.3.0",
     "vitest": "^4.0.18"
   }