webmcp-cli 1.0.0 → 1.2.1

package/dist/detection/declarative.js

@@ -0,0 +1,343 @@
+/**
+ * Declarative Tool Detection
+ *
+ * Scans HTML for WebMCP form attributes (toolname, tooldescription, etc.)
+ */
+import * as cheerio from 'cheerio';
+import { WEBMCP_ATTRIBUTES, INPUT_TYPE_MAP, PAYMENT_KEYWORDS, AUTH_KEYWORDS, } from '../core/constants.js';
+/**
+ * Map HTML input type to JSON Schema type
+ */
+function mapInputType(inputType) {
+    const mapped = INPUT_TYPE_MAP[inputType.toLowerCase()];
+    if (mapped === 'number')
+        return 'number';
+    if (mapped === 'boolean')
+        return 'boolean';
+    return 'string';
+}
+/**
+ * Scan HTML for declarative WebMCP tools (forms with toolname attribute)
+ */
+export function scanDeclarativeTools(html, pageUrl) {
+    const $ = cheerio.load(html);
+    const tools = [];
+    $(`form[${WEBMCP_ATTRIBUTES.TOOL_NAME}]`).each((_index, form) => {
+        const $form = $(form);
+        const tool = {
+            toolname: $form.attr(WEBMCP_ATTRIBUTES.TOOL_NAME) ?? '',
+            tooldescription: $form.attr(WEBMCP_ATTRIBUTES.TOOL_DESCRIPTION) ?? '',
+            autosubmit: $form.attr(WEBMCP_ATTRIBUTES.TOOL_AUTO_SUBMIT) !== undefined,
+            formAction: $form.attr('action') ?? '',
+            formMethod: ($form.attr('method') ?? 'GET').toUpperCase(),
+            parameters: [],
+            formElement: $.html(form).substring(0, 500),
+            pageUrl,
+        };
+        // Scan form inputs
+        $form.find('input, select, textarea').each((_i, el) => {
+            const $el = $(el);
+            const type = $el.attr('type') ?? $el.prop('tagName')?.toLowerCase() ?? 'text';
+            // Skip submit buttons and hidden inputs without toolparam attrs
+            if (type === 'submit' || type === 'button')
+                return;
+            if (type === 'hidden' && !$el.attr(WEBMCP_ATTRIBUTES.PARAM_TITLE))
+                return;
+            const name = $el.attr('name') ?? '';
+            if (!name)
+                return;
+            // Find associated label
+            let labelText = null;
+            const id = $el.attr('id');
+            if (id) {
+                labelText = $(`label[for="${id}"]`).text().trim() || null;
+            }
+            if (!labelText) {
+                labelText = $el.closest('label').text().trim() || null;
+            }
+            // Build parameter
+            const param = {
+                name,
+                toolparamtitle: $el.attr(WEBMCP_ATTRIBUTES.PARAM_TITLE) ?? null,
+                toolparamdescription: $el.attr(WEBMCP_ATTRIBUTES.PARAM_DESCRIPTION) ?? null,
+                type: mapInputType(type),
+                required: $el.attr('required') !== undefined,
+                inputType: type,
+                options: null,
+                constraints: {
+                    min: $el.attr('min') ?? null,
+                    max: $el.attr('max') ?? null,
+                    minlength: $el.attr('minlength') ?? null,
+                    maxlength: $el.attr('maxlength') ?? null,
+                    pattern: $el.attr('pattern') ?? null,
+                    step: $el.attr('step') ?? null,
+                },
+                labelText,
+                ariaDescription: $el.attr('aria-description') ?? null,
+            };
+            // Handle select options
+            if ($el.prop('tagName')?.toLowerCase() === 'select') {
+                param.options = [];
+                $el.find('option').each((_j, opt) => {
+                    const $opt = $(opt);
+                    param.options.push({
+                        value: $opt.attr('value') ?? $opt.text().trim(),
+                        text: $opt.text().trim(),
+                        selected: $opt.attr('selected') !== undefined,
+                    });
+                });
+            }
+            // Handle radio groups (only capture once per name)
+            if (type === 'radio') {
+                const existingParam = tool.parameters.find((p) => p.name === name);
+                if (existingParam)
+                    return;
+                param.options = [];
+                $form.find(`input[type=radio][name="${name}"]`).each((_j, radio) => {
+                    const $radio = $(radio);
+                    const radioLabel = $radio.closest('label').text().trim() ||
+                        $radio.next('label').text().trim() ||
+                        $radio.attr('value') ||
+                        '';
+                    param.options.push({
+                        value: $radio.attr('value') ?? '',
+                        text: radioLabel,
+                        selected: $radio.attr('checked') !== undefined,
+                    });
+                });
+            }
+            tool.parameters.push(param);
+        });
+        tools.push(tool);
+    });
+    return tools;
+}
+/**
+ * Convert a declarative tool to a detected tool
+ */
+export function toDetectedTool(declarative) {
+    // Build inputSchema from parameters
+    const properties = {};
+    const required = [];
+    for (const param of declarative.parameters) {
+        const paramName = param.name;
+        const schema = {
+            type: param.type,
+        };
+        // Preserve human-friendly labels without changing canonical parameter keys
+        if (param.toolparamtitle) {
+            schema['title'] = param.toolparamtitle;
+        }
+        // Add description
+        const description = param.toolparamdescription ?? param.labelText ?? param.ariaDescription;
+        if (description) {
+            schema['description'] = description;
+        }
+        // Add constraints
+        if (param.constraints.min != null) {
+            schema['minimum'] = parseFloat(param.constraints.min);
+        }
+        if (param.constraints.max != null) {
+            schema['maximum'] = parseFloat(param.constraints.max);
+        }
+        if (param.constraints.minlength != null) {
+            schema['minLength'] = parseInt(param.constraints.minlength, 10);
+        }
+        if (param.constraints.maxlength != null) {
+            schema['maxLength'] = parseInt(param.constraints.maxlength, 10);
+        }
+        if (param.constraints.pattern != null) {
+            schema['pattern'] = param.constraints.pattern;
+        }
+        // Add enum for select/radio options
+        if (param.options && param.options.length > 0) {
+            schema['enum'] = param.options.map((o) => o.value);
+        }
+        // Add format based on input type
+        if (param.inputType === 'email')
+            schema['format'] = 'email';
+        if (param.inputType === 'url')
+            schema['format'] = 'uri';
+        if (param.inputType === 'date')
+            schema['format'] = 'date';
+        if (param.inputType === 'datetime-local')
+            schema['format'] = 'date-time';
+        if (param.inputType === 'time')
+            schema['format'] = 'time';
+        properties[paramName] = schema;
+        if (param.required) {
+            required.push(paramName);
+        }
+    }
+    const inputSchema = {
+        type: 'object',
+        properties: properties,
+        required: required.length > 0 ? required : undefined,
+    };
+    return {
+        name: declarative.toolname,
+        description: declarative.tooldescription,
+        inputSchema,
+        source: 'declarative',
+        pageUrl: declarative.pageUrl ?? '',
+        formData: {
+            autosubmit: declarative.autosubmit,
+            formAction: declarative.formAction,
+            formMethod: declarative.formMethod,
+        },
+    };
+}
+/**
+ * Scan HTML for unregistered forms (opportunities)
+ */
+export function scanUnregisteredForms(html, pageUrl) {
+    const $ = cheerio.load(html);
+    const opportunities = [];
+    $(`form:not([${WEBMCP_ATTRIBUTES.TOOL_NAME}])`).each((index, form) => {
+        const $form = $(form);
+        // Get all fields
+        const $fields = $form.find('input, select, textarea');
+        const meaningfulFields = $fields.filter((_i, el) => {
+            const type = $(el).attr('type') ?? 'text';
+            return type !== 'submit' && type !== 'button' && type !== 'hidden';
+        });
+        // Skip forms with no meaningful fields
+        if (meaningfulFields.length === 0)
+            return;
+        // Get submit button text
+        const $submit = $form.find('button[type=submit], input[type=submit], button:not([type])').first();
+        const submitText = $submit.text().trim() || $submit.attr('value') || null;
+        // Find nearest heading
+        let nearestHeading = null;
+        let $el = $form;
+        while ($el.length && !nearestHeading) {
+            const $prev = $el.prev('h1, h2, h3, h4, h5, h6');
+            if ($prev.length) {
+                nearestHeading = $prev.text().trim();
+                break;
+            }
+            $el = $el.parent();
+        }
+        // Collect field info
+        const fieldNames = [];
+        const fieldTypes = [];
+        meaningfulFields.each((_i, el) => {
+            const $el = $(el);
+            fieldNames.push($el.attr('name') ?? $el.attr('id') ?? '');
+            fieldTypes.push($el.attr('type') ?? $el.prop('tagName')?.toLowerCase() ?? 'text');
+        });
+        // Detect special fields
+        const hasPasswordField = $form.find('input[type=password]').length > 0;
+        const hasEmailField = $form.find('input[type=email]').length > 0;
+        const hasPaymentFields = $form.find('input').filter((_i, el) => {
+            const name = ($(el).attr('name') ?? '').toLowerCase();
+            return /card|payment|cvv|cvc|expir/i.test(name);
+        }).length > 0;
+        // Determine sensitivity
+        let sensitivity = 'low';
+        if (hasPaymentFields)
+            sensitivity = 'critical';
+        else if (hasPasswordField)
+            sensitivity = 'high';
+        else if (hasEmailField)
+            sensitivity = 'medium';
+        else if (meaningfulFields.length > 8)
+            sensitivity = 'medium';
+        // Estimate agentic value
+        const contextText = [
+            $form.attr('action') ?? '',
+            submitText ?? '',
+            nearestHeading ?? '',
+        ].join(' ').toLowerCase();
+        let agenticValue = 'medium';
+        if (/search|find|filter|browse/.test(contextText)) {
+            agenticValue = 'high';
+        }
+        if (PAYMENT_KEYWORDS.some((kw) => contextText.includes(kw))) {
+            agenticValue = 'critical';
+        }
+        if (AUTH_KEYWORDS.some((kw) => contextText.includes(kw))) {
+            agenticValue = 'high';
+        }
+        if (/subscribe|newsletter|contact|message|feedback/.test(contextText)) {
+            agenticValue = 'low';
+        }
+        // Build opportunity
+        const opportunity = {
+            index,
+            contextClues: {
+                formId: $form.attr('id') ?? null,
+                formAction: $form.attr('action') ?? null,
+                formMethod: ($form.attr('method') ?? 'GET').toUpperCase(),
+                formClass: $form.attr('class') ?? null,
+                submitText,
+                nearestHeading,
+                pageTitle: $('title').text().trim(),
+                ariaLabel: $form.attr('aria-label') ?? null,
+                fieldNames,
+                fieldTypes,
+                hasPasswordField,
+                hasEmailField,
+                hasPaymentFields,
+                fieldCount: meaningfulFields.length,
+            },
+            sensitivity,
+            agenticValue,
+            fieldCount: meaningfulFields.length,
+            formOuterHTML: $.html(form).substring(0, 1000),
+            fields: [],
+            pageUrl,
+        };
+        // Extract field details
+        meaningfulFields.each((_i, el) => {
+            const $el = $(el);
+            const name = $el.attr('name') ?? $el.attr('id') ?? '';
+            const type = $el.attr('type') ?? $el.prop('tagName')?.toLowerCase() ?? 'text';
+            let label = null;
+            const id = $el.attr('id');
+            if (id) {
+                label = $(`label[for="${id}"]`).text().trim() || null;
+            }
+            if (!label) {
+                label = $el.closest('label').text().trim() || null;
+            }
+            let options = null;
+            if ($el.prop('tagName')?.toLowerCase() === 'select') {
+                options = [];
+                $el.find('option').each((_j, opt) => {
+                    const $opt = $(opt);
+                    options.push({
+                        value: $opt.attr('value') ?? $opt.text().trim(),
+                        text: $opt.text().trim(),
+                    });
+                });
+            }
+            opportunity.fields.push({
+                name,
+                type,
+                required: $el.attr('required') !== undefined,
+                placeholder: $el.attr('placeholder') ?? null,
+                label,
+                options,
+            });
+        });
+        opportunities.push(opportunity);
+    });
+    return opportunities;
+}
+/**
+ * Get statistics about declarative tools on a page
+ */
+export function getDeclarativeStats(html) {
+    const $ = cheerio.load(html);
+    const totalForms = $('form').length;
+    const registeredForms = $(`form[${WEBMCP_ATTRIBUTES.TOOL_NAME}]`).length;
+    const autosubmitForms = $(`form[${WEBMCP_ATTRIBUTES.TOOL_NAME}][${WEBMCP_ATTRIBUTES.TOOL_AUTO_SUBMIT}]`).length;
+    return {
+        totalForms,
+        registeredForms,
+        unregisteredForms: totalForms - registeredForms,
+        autosubmitForms,
+    };
+}
+//# sourceMappingURL=declarative.js.map

package/dist/detection/declarative.js.map

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

package/dist/detection/imperative.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Imperative Tool Detection
+ *
+ * Processes captured tool registrations from the browser interception script.
+ */
+import type { InterceptedData } from '../browser/interceptor.js';
+import type { CapturedTool, DetectedTool } from '../core/types/tool.js';
+/**
+ * Process intercepted data and extract detected tools
+ */
+export declare function processInterceptedData(data: InterceptedData): {
+    tools: DetectedTool[];
+    captured: CapturedTool[];
+    hasWebMCP: boolean;
+};
+/**
+ * Deduplicate tools by name, keeping the most recent registration
+ */
+export declare function deduplicateTools(tools: DetectedTool[]): DetectedTool[];
+/**
+ * Get statistics about intercepted data
+ */
+export declare function getInterceptionStats(data: InterceptedData): {
+    totalTools: number;
+    uniqueTools: number;
+    registerToolCount: number;
+    provideContextCount: number;
+    unregisterCount: number;
+    clearContextCount: number;
+    eventCount: number;
+};
+/**
+ * Validate that a captured tool has required fields
+ */
+export declare function validateCapturedTool(tool: CapturedTool): {
+    valid: boolean;
+    errors: string[];
+};

package/dist/detection/imperative.js

@@ -0,0 +1,99 @@
+/**
+ * Imperative Tool Detection
+ *
+ * Processes captured tool registrations from the browser interception script.
+ */
+/**
+ * Convert an intercepted tool to a captured tool
+ */
+function toCapuredTool(intercepted) {
+    return {
+        name: intercepted.name ?? '',
+        description: intercepted.description ?? '',
+        inputSchema: intercepted.inputSchema,
+        annotations: intercepted.annotations,
+        hasExecute: intercepted.hasExecute,
+        executeSource: intercepted.executeSource,
+        registeredAt: intercepted.registeredAt,
+        registrationMethod: intercepted.registrationMethod,
+        pageUrl: intercepted.pageUrl,
+    };
+}
+/**
+ * Convert a captured tool to a detected tool
+ */
+function toDetectedTool(captured) {
+    return {
+        name: captured.name,
+        description: captured.description,
+        inputSchema: captured.inputSchema,
+        annotations: captured.annotations,
+        source: 'imperative',
+        registrationMethod: captured.registrationMethod,
+        hasExecute: captured.hasExecute,
+        executeSource: captured.executeSource,
+        pageUrl: captured.pageUrl ?? '',
+    };
+}
+/**
+ * Process intercepted data and extract detected tools
+ */
+export function processInterceptedData(data) {
+    const captured = data.tools.map(toCapuredTool);
+    const tools = captured.map(toDetectedTool);
+    return {
+        tools,
+        captured,
+        hasWebMCP: data.hasModelContext,
+    };
+}
+/**
+ * Deduplicate tools by name, keeping the most recent registration
+ */
+export function deduplicateTools(tools) {
+    const byName = new Map();
+    for (const tool of tools) {
+        // Keep the latest registration for each tool name.
+        byName.set(tool.name, tool);
+    }
+    return Array.from(byName.values());
+}
+/**
+ * Get statistics about intercepted data
+ */
+export function getInterceptionStats(data) {
+    const registerToolCount = data.tools.filter((t) => t.registrationMethod === 'registerTool').length;
+    const provideContextCount = data.contextCalls.filter((c) => c.type === 'provideContext').length;
+    const unregisterCount = data.contextCalls.filter((c) => c.type === 'unregisterTool').length;
+    const clearContextCount = data.contextCalls.filter((c) => c.type === 'clearContext').length;
+    const uniqueNames = new Set(data.tools.map((t) => t.name));
+    return {
+        totalTools: data.tools.length,
+        uniqueTools: uniqueNames.size,
+        registerToolCount,
+        provideContextCount,
+        unregisterCount,
+        clearContextCount,
+        eventCount: data.events.length,
+    };
+}
+/**
+ * Validate that a captured tool has required fields
+ */
+export function validateCapturedTool(tool) {
+    const errors = [];
+    if (!tool.name || tool.name.trim() === '') {
+        errors.push('Tool is missing a name');
+    }
+    if (!tool.description || tool.description.trim() === '') {
+        errors.push('Tool is missing a description');
+    }
+    if (!tool.hasExecute) {
+        errors.push('Tool is missing an execute function');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=imperative.js.map

package/dist/detection/imperative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imperative.js","sourceRoot":"","sources":["../../src/detection/imperative.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,SAAS,aAAa,CAAC,WAA4B;IACjD,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,EAAE;QAC5B,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;QAC1C,WAAW,EAAE,WAAW,CAAC,WAA0C;QACnE,WAAW,EAAE,WAAW,CAAC,WAA0C;QACnE,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,aAAa,EAAE,WAAW,CAAC,aAAa;QACxC,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,kBAAkB,EAAE,WAAW,CAAC,kBAAkB;QAClD,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAsB;IAC5C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM,EAAE,YAAY;QACpB,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAqB;IAK1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE3C,OAAO;QACL,KAAK;QACL,QAAQ;QACR,SAAS,EAAE,IAAI,CAAC,eAAe;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mDAAmD;QACnD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAqB;IASxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,KAAK,cAAc,CAC/C,CAAC,MAAM,CAAC;IAET,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CACnC,CAAC,MAAM,CAAC;IAET,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CACnC,CAAC,MAAM,CAAC;IAET,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAChD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CACjC,CAAC,MAAM,CAAC;IAET,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE3D,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QAC7B,WAAW,EAAE,WAAW,CAAC,IAAI;QAC7B,iBAAiB;QACjB,mBAAmB;QACnB,eAAe;QACf,iBAAiB;QACjB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IAIrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/detection/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detection Module
+ */
+export * from './imperative.js';
+export * from './declarative.js';

package/dist/detection/index.js

@@ -0,0 +1,6 @@
+/**
+ * Detection Module
+ */
+export * from './imperative.js';
+export * from './declarative.js';
+//# sourceMappingURL=index.js.map

package/dist/detection/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AgentReady CLI
+ *
+ * Audit any website for AI agent readiness (WebMCP).
+ */
+export * from './core/types/index.js';
+export * from './core/constants.js';
+export * from './browser/index.js';
+export * from './detection/index.js';
+export * from './rules/index.js';
+export * from './scoring/index.js';
+export { run, createProgram, version } from './cli/index.js';

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * AgentReady CLI
+ *
+ * Audit any website for AI agent readiness (WebMCP).
+ */
+// Core types
+export * from './core/types/index.js';
+export * from './core/constants.js';
+// Browser
+export * from './browser/index.js';
+// Detection
+export * from './detection/index.js';
+// Rules
+export * from './rules/index.js';
+// Scoring
+export * from './scoring/index.js';
+// CLI
+export { run, createProgram, version } from './cli/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AAEpC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,MAAM;AACN,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/llm/advice-service.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Smart Advice Service
+ *
+ * Generates LLM-powered contextual advice for audit findings
+ * by calling the centralized WebMCP Advice Server.
+ */
+import type { Finding } from '../core/types/rule.js';
+import type { DetectedTool } from '../core/types/tool.js';
+import type { SmartAdvice } from './types.js';
+export interface AdviceServiceConfig {
+    serverUrl?: string;
+}
+export declare class AdviceService {
+    private cache;
+    private serverUrl;
+    private clientVersion;
+    constructor(config?: AdviceServiceConfig);
+    isAvailable(): boolean;
+    generateAdvice(finding: Finding, tool?: DetectedTool, siteUrl?: string): Promise<SmartAdvice>;
+    /**
+     * Generate proactive optimization advice for a tool
+     * (even if no specific finding exists)
+     */
+    generateToolAdvice(tool: DetectedTool, siteUrl?: string): Promise<SmartAdvice>;
+    /**
+     * Pre-fetch advice for all findings and tools in parallel
+     * Call this after audit completes, before displaying TUI
+     */
+    prefetchAll(findings: Finding[], tools: DetectedTool[], siteUrl?: string, onProgress?: (completed: number, total: number) => void): Promise<{
+        findingAdvice: Map<string, SmartAdvice>;
+        toolAdvice: Map<string, SmartAdvice>;
+    }>;
+    private callServer;
+    private getToolCacheKey;
+    private getCacheKey;
+    private loadCache;
+    private saveCache;
+}