webmcp-cli 1.0.0 → 1.2.1

package/dist/agent/llm-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Unified LLM Client
+ *
+ * Provides a unified interface for LLM interactions including
+ * chat completions and function/tool calling via OpenRouter.
+ */
+import type { DetectedTool } from '../core/types/tool.js';
+export interface LLMClientConfig {
+    provider: 'openrouter' | 'ollama';
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    tool_calls?: ToolCallMessage[];
+    tool_call_id?: string;
+}
+export interface ToolCallMessage {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMTool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export interface LLMToolCall {
+    toolName: string;
+    toolInput: Record<string, unknown>;
+}
+export interface LLMResponse {
+    text: string | null;
+    toolCalls: LLMToolCall[];
+    stopReason: 'end_turn' | 'tool_use' | 'max_tokens' | 'error';
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    latencyMs: number;
+    cost: number;
+}
+export declare class LLMClient {
+    private config;
+    private baseUrl;
+    constructor(config: LLMClientConfig);
+    /**
+     * Check if the client has valid credentials
+     */
+    isAvailable(): boolean;
+    /**
+     * Simple chat completion (no tools)
+     */
+    chat(messages: LLMMessage[]): Promise<LLMResponse>;
+    /**
+     * Chat completion WITH tools (function calling)
+     */
+    chatWithTools(messages: LLMMessage[], tools: LLMTool[]): Promise<LLMResponse>;
+    /**
+     * Convert DetectedTool to LLMTool format
+     */
+    static toLLMTools(tools: DetectedTool[]): LLMTool[];
+    private getHeaders;
+    private estimateCost;
+}
+/**
+ * Create an LLM client from environment configuration
+ */
+export declare function createLLMClient(config?: Partial<LLMClientConfig>): LLMClient;
+export default LLMClient;

package/dist/agent/llm-client.js

@@ -0,0 +1,198 @@
+/**
+ * Unified LLM Client
+ *
+ * Provides a unified interface for LLM interactions including
+ * chat completions and function/tool calling via OpenRouter.
+ */
+// ═══════════════════════════════════════════════════════
+// COST ESTIMATES (per 1M tokens)
+// ═══════════════════════════════════════════════════════
+const MODEL_COSTS = {
+    'anthropic/claude-sonnet-4-20250514': { input: 3, output: 15 },
+    'anthropic/claude-sonnet-4': { input: 3, output: 15 },
+    'anthropic/claude-3.5-sonnet': { input: 3, output: 15 },
+    'openai/gpt-4.1': { input: 2, output: 8 },
+    'openai/gpt-4.1-mini': { input: 0.4, output: 1.6 },
+    'openai/gpt-4.1-nano': { input: 0.1, output: 0.4 },
+    'openai/gpt-4o': { input: 2.5, output: 10 },
+    'openai/gpt-4o-mini': { input: 0.15, output: 0.6 },
+    'google/gemini-2.5-flash': { input: 0.15, output: 0.6 },
+    'google/gemini-2.5-pro': { input: 1.25, output: 10 },
+    'meta-llama/llama-4-scout': { input: 0.15, output: 0.6 },
+};
+// ═══════════════════════════════════════════════════════
+// LLM CLIENT CLASS
+// ═══════════════════════════════════════════════════════
+export class LLMClient {
+    config;
+    baseUrl;
+    constructor(config) {
+        this.config = {
+            temperature: 0.1,
+            maxTokens: 4096,
+            ...config,
+        };
+        // Set base URL based on provider
+        const baseUrls = {
+            openrouter: 'https://openrouter.ai/api/v1',
+            ollama: 'http://localhost:11434/v1',
+        };
+        this.baseUrl = config.baseUrl || baseUrls[config.provider] || baseUrls['openrouter'] || 'https://openrouter.ai/api/v1';
+    }
+    /**
+     * Check if the client has valid credentials
+     */
+    isAvailable() {
+        if (this.config.provider === 'ollama')
+            return true;
+        return Boolean(this.config.apiKey && this.config.apiKey.length > 10);
+    }
+    /**
+     * Simple chat completion (no tools)
+     */
+    async chat(messages) {
+        const start = Date.now();
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify({
+                model: this.config.model,
+                messages: messages.map(m => ({
+                    role: m.role,
+                    content: m.content,
+                    ...(m.tool_calls && { tool_calls: m.tool_calls }),
+                    ...(m.tool_call_id && { tool_call_id: m.tool_call_id }),
+                })),
+                temperature: this.config.temperature,
+                max_tokens: this.config.maxTokens,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`LLM API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        const choice = data.choices[0];
+        return {
+            text: choice?.message?.content || null,
+            toolCalls: [],
+            stopReason: choice?.finish_reason === 'stop' ? 'end_turn' : 'max_tokens',
+            model: this.config.model,
+            inputTokens: data.usage?.prompt_tokens || 0,
+            outputTokens: data.usage?.completion_tokens || 0,
+            latencyMs: Date.now() - start,
+            cost: this.estimateCost(data.usage?.prompt_tokens || 0, data.usage?.completion_tokens || 0),
+        };
+    }
+    /**
+     * Chat completion WITH tools (function calling)
+     */
+    async chatWithTools(messages, tools) {
+        const start = Date.now();
+        // Convert tools to OpenAI format
+        const openaiTools = tools.map(t => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.input_schema,
+            },
+        }));
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: this.getHeaders(),
+            body: JSON.stringify({
+                model: this.config.model,
+                messages: messages.map(m => ({
+                    role: m.role,
+                    content: m.content,
+                    ...(m.tool_calls && { tool_calls: m.tool_calls }),
+                    ...(m.tool_call_id && { tool_call_id: m.tool_call_id }),
+                })),
+                tools: openaiTools,
+                tool_choice: 'auto',
+                temperature: this.config.temperature,
+                max_tokens: this.config.maxTokens,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`LLM API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        const choice = data.choices[0];
+        // Parse tool calls
+        const toolCalls = (choice?.message?.tool_calls || []).map((tc) => ({
+            toolName: tc.function.name,
+            toolInput: parseToolArguments(tc.function.arguments),
+        }));
+        return {
+            text: choice?.message?.content || null,
+            toolCalls,
+            stopReason: choice?.finish_reason === 'tool_calls' ? 'tool_use' : 'end_turn',
+            model: this.config.model,
+            inputTokens: data.usage?.prompt_tokens || 0,
+            outputTokens: data.usage?.completion_tokens || 0,
+            latencyMs: Date.now() - start,
+            cost: this.estimateCost(data.usage?.prompt_tokens || 0, data.usage?.completion_tokens || 0),
+        };
+    }
+    /**
+     * Convert DetectedTool to LLMTool format
+     */
+    static toLLMTools(tools) {
+        return tools.map(t => ({
+            name: t.name,
+            description: t.description,
+            input_schema: t.inputSchema || { type: 'object', properties: {} },
+        }));
+    }
+    getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+        }
+        if (this.config.provider === 'openrouter') {
+            headers['HTTP-Referer'] = 'https://agentready.dev';
+            headers['X-Title'] = 'AgentReady CLI';
+        }
+        return headers;
+    }
+    estimateCost(inputTokens, outputTokens) {
+        const rate = MODEL_COSTS[this.config.model] || { input: 1, output: 3 };
+        return (inputTokens * rate.input + outputTokens * rate.output) / 1_000_000;
+    }
+}
+function parseToolArguments(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Ignore malformed tool-call arguments and continue simulation gracefully.
+    }
+    return {};
+}
+// ═══════════════════════════════════════════════════════
+// FACTORY FUNCTION
+// ═══════════════════════════════════════════════════════
+/**
+ * Create an LLM client from environment configuration
+ */
+export function createLLMClient(config) {
+    const apiKey = config?.apiKey || process.env['OPENROUTER_API_KEY'];
+    const model = config?.model || process.env['OPENROUTER_MODEL'] || 'anthropic/claude-sonnet-4';
+    return new LLMClient({
+        provider: config?.provider || 'openrouter',
+        model,
+        apiKey,
+        temperature: config?.temperature ?? 0.1,
+        maxTokens: config?.maxTokens ?? 4096,
+    });
+}
+export default LLMClient;
+//# sourceMappingURL=llm-client.js.map

package/dist/agent/llm-client.js.map

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

package/dist/audit/run-single-page-audit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared single-page audit pipeline.
+ *
+ * This is used by both CLI and interactive flows so detection and scoring stay
+ * behaviorally consistent.
+ */
+import type { BrowserContext } from 'playwright';
+import type { Finding, RuleContext, RuleResult } from '../core/types/rule.js';
+import type { ScoreSummary } from '../core/types/audit.js';
+import type { DetectedTool, UnregisteredForm } from '../core/types/tool.js';
+export type SinglePageAuditStage = 'loading-page' | 'detecting-imperative' | 'detecting-declarative' | 'finding-opportunities' | 'running-rules' | 'scoring';
+export interface SinglePageAuditProgress {
+    stage: SinglePageAuditStage;
+    message: string;
+    toolCount?: number;
+    findingCount?: number;
+    opportunityCount?: number;
+    hasWebMCP?: boolean;
+}
+export interface SinglePageAuditOptions {
+    context: BrowserContext;
+    url: string;
+    timeout: number;
+    extraWaitMs?: number;
+    onProgress?: (progress: SinglePageAuditProgress) => void;
+}
+export interface SinglePageAuditResult {
+    title: string;
+    html: string;
+    hasWebMCP: boolean;
+    hasFeatureDetection: boolean;
+    imperativeTools: DetectedTool[];
+    declarativeTools: DetectedTool[];
+    tools: DetectedTool[];
+    opportunities: UnregisteredForm[];
+    ruleContext: RuleContext;
+    ruleResults: Map<string, RuleResult>;
+    findings: Finding[];
+    score: ScoreSummary;
+}
+export declare function runSinglePageAudit(options: SinglePageAuditOptions): Promise<SinglePageAuditResult>;

package/dist/audit/run-single-page-audit.js

@@ -0,0 +1,103 @@
+/**
+ * Shared single-page audit pipeline.
+ *
+ * This is used by both CLI and interactive flows so detection and scoring stay
+ * behaviorally consistent.
+ */
+import { auditPage } from '../browser/playwright.js';
+import { processInterceptedData, deduplicateTools, } from '../detection/imperative.js';
+import { scanDeclarativeTools, toDetectedTool, scanUnregisteredForms, } from '../detection/declarative.js';
+import { ensureRulesRegistered, runAllRules, getRuleCategories, getRuleSeverities, } from '../rules/index.js';
+import { calculateScore, extractFindings } from '../scoring/calculator.js';
+export async function runSinglePageAudit(options) {
+    const { context, url, timeout, extraWaitMs = 2000, onProgress, } = options;
+    const pageResult = await auditPage(context, url, {
+        timeout,
+        extraWaitMs,
+    });
+    try {
+        const html = pageResult.html;
+        const title = pageResult.title;
+        onProgress?.({
+            stage: 'loading-page',
+            message: title
+                ? `Loaded "${title.substring(0, 30)}..."`
+                : 'Loaded page',
+        });
+        const { tools: rawImperativeTools, hasWebMCP } = processInterceptedData(pageResult.data);
+        const imperativeTools = deduplicateTools(rawImperativeTools);
+        onProgress?.({
+            stage: 'detecting-imperative',
+            message: 'Processed imperative tools',
+            toolCount: imperativeTools.length,
+            hasWebMCP,
+        });
+        const declTools = scanDeclarativeTools(html, url);
+        const declarativeTools = declTools.map(toDetectedTool);
+        onProgress?.({
+            stage: 'detecting-declarative',
+            message: 'Processed declarative tools',
+            toolCount: imperativeTools.length + declarativeTools.length,
+        });
+        const opportunities = scanUnregisteredForms(html, url);
+        onProgress?.({
+            stage: 'finding-opportunities',
+            message: 'Scanned unregistered forms',
+            opportunityCount: opportunities.length,
+        });
+        const tools = [...imperativeTools, ...declarativeTools];
+        const ruleContext = {
+            url,
+            tools,
+            opportunities,
+            pages: [
+                {
+                    url,
+                    title,
+                    statusCode: 200,
+                    loadTime: 0,
+                    hasWebMCP,
+                    toolCount: tools.length,
+                    formCount: declarativeTools.length,
+                    opportunityCount: opportunities.length,
+                    depth: 0,
+                },
+            ],
+            hasWebMCP,
+            html,
+        };
+        ensureRulesRegistered();
+        onProgress?.({
+            stage: 'running-rules',
+            message: 'Running audit rules',
+            toolCount: tools.length,
+        });
+        const ruleResults = await runAllRules(ruleContext);
+        const findings = extractFindings(ruleResults, getRuleSeverities());
+        const score = calculateScore(ruleResults, getRuleCategories());
+        onProgress?.({
+            stage: 'scoring',
+            message: 'Calculated score',
+            toolCount: tools.length,
+            findingCount: findings.length,
+        });
+        return {
+            title,
+            html,
+            hasWebMCP,
+            hasFeatureDetection: pageResult.hasFeatureDetection,
+            imperativeTools,
+            declarativeTools,
+            tools,
+            opportunities,
+            ruleContext,
+            ruleResults,
+            findings,
+            score,
+        };
+    }
+    finally {
+        await pageResult.page.close();
+    }
+}
+//# sourceMappingURL=run-single-page-audit.js.map

package/dist/audit/run-single-page-audit.js.map

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

package/dist/bin/webmcp.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * WebMCP CLI Entry Point
+ */
+export {};

package/dist/bin/webmcp.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * WebMCP CLI Entry Point
+ */
+import chalk from 'chalk';
+import { run } from '../cli/index.js';
+run().catch((error) => {
+    console.error(chalk.red('Fatal error:'), error instanceof Error ? error.message : error);
+    if (error instanceof Error && error.stack) {
+        console.error(chalk.dim(error.stack));
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=webmcp.js.map

package/dist/bin/webmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.js","sourceRoot":"","sources":["../../src/bin/webmcp.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzF,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/browser/audit-runner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Audit Runner
+ *
+ * Executes browser audit and returns structured results for the interactive TUI
+ */
+import type { ScoreSummary } from '../core/types/audit.js';
+import type { DetectedTool, UnregisteredForm } from '../core/types/tool.js';
+import type { Finding } from '../core/types/rule.js';
+import type { SimulationTestCase } from '../ui/ink/types.js';
+export interface InteractiveAuditProgress {
+    progress: number;
+    currentPage: string;
+    pagesScanned: number;
+    toolsFound: number;
+    message: string;
+}
+export interface InteractiveAuditConfig {
+    timeout: number;
+    onProgress?: (progress: InteractiveAuditProgress) => void;
+}
+export interface InteractiveAuditResult {
+    score: ScoreSummary;
+    tools: DetectedTool[];
+    findings: Finding[];
+    opportunities: UnregisteredForm[];
+    simulation?: SimulationTestCase[];
+    hasWebMCP: boolean;
+    pageTitle: string;
+}
+export declare function executeAudit(url: string, config: InteractiveAuditConfig): Promise<InteractiveAuditResult>;

package/dist/browser/audit-runner.js

@@ -0,0 +1,77 @@
+/**
+ * Audit Runner
+ *
+ * Executes browser audit and returns structured results for the interactive TUI
+ */
+import { createAuditBrowser, closeBrowser, } from './playwright.js';
+import { runSinglePageAudit } from '../audit/run-single-page-audit.js';
+export async function executeAudit(url, config) {
+    const { onProgress } = config;
+    onProgress?.({
+        progress: 5,
+        currentPage: url,
+        pagesScanned: 0,
+        toolsFound: 0,
+        message: 'Starting browser...'
+    });
+    // Create browser
+    let browser;
+    try {
+        browser = await createAuditBrowser({
+            headless: true,
+            timeout: config.timeout,
+        });
+        onProgress?.({
+            progress: 15,
+            currentPage: url,
+            pagesScanned: 0,
+            toolsFound: 0,
+            message: 'Loading page...'
+        });
+        const stageProgress = {
+            'loading-page': 35,
+            'detecting-imperative': 45,
+            'detecting-declarative': 52,
+            'finding-opportunities': 60,
+            'running-rules': 70,
+            'scoring': 80,
+        };
+        const auditResult = await runSinglePageAudit({
+            context: browser.context,
+            url,
+            timeout: config.timeout,
+            extraWaitMs: 2000,
+            onProgress: (progress) => {
+                onProgress?.({
+                    progress: stageProgress[progress.stage],
+                    currentPage: url,
+                    pagesScanned: 1,
+                    toolsFound: progress.toolCount ?? 0,
+                    message: progress.message,
+                });
+            },
+        });
+        onProgress?.({
+            progress: 100,
+            currentPage: url,
+            pagesScanned: 1,
+            toolsFound: auditResult.tools.length,
+            message: 'Complete!'
+        });
+        return {
+            score: auditResult.score,
+            tools: auditResult.tools,
+            findings: auditResult.findings,
+            opportunities: auditResult.opportunities,
+            simulation: [],
+            hasWebMCP: auditResult.hasWebMCP,
+            pageTitle: auditResult.title,
+        };
+    }
+    finally {
+        if (browser) {
+            await closeBrowser(browser.browser);
+        }
+    }
+}
+//# sourceMappingURL=audit-runner.js.map

package/dist/browser/audit-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-runner.js","sourceRoot":"","sources":["../../src/browser/audit-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAyBvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,MAA8B;IAE9B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE9B,UAAU,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,GAAG;QAChB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;IAEH,iBAAiB;IACjB,IAAI,OAAiC,CAAC;IAEtC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,kBAAkB,CAAC;YACjC,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,UAAU,EAAE,CAAC;YACX,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,iBAAiB;SAC3B,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG;YACpB,cAAc,EAAE,EAAE;YAClB,sBAAsB,EAAE,EAAE;YAC1B,uBAAuB,EAAE,EAAE;YAC3B,uBAAuB,EAAE,EAAE;YAC3B,eAAe,EAAE,EAAE;YACnB,SAAS,EAAE,EAAE;SACL,CAAC;QAEX,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC;YAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACvB,UAAU,EAAE,CAAC;oBACX,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACvC,WAAW,EAAE,GAAG;oBAChB,YAAY,EAAE,CAAC;oBACf,UAAU,EAAE,QAAQ,CAAC,SAAS,IAAI,CAAC;oBACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;QAEH,UAAU,EAAE,CAAC;YACX,QAAQ,EAAE,GAAG;YACb,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;YACpC,OAAO,EAAE,WAAW;SACrB,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,aAAa,EAAE,WAAW,CAAC,aAAa;YACxC,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,SAAS,EAAE,WAAW,CAAC,KAAK;SAC7B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser Module
+ */
+export * from './interceptor.js';
+export * from './playwright.js';
+export * from './audit-runner.js';

package/dist/browser/index.js

@@ -0,0 +1,7 @@
+/**
+ * Browser Module
+ */
+export * from './interceptor.js';
+export * from './playwright.js';
+export * from './audit-runner.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}