webmcp-cli 1.2.1 → 1.2.3

package/dist/analysis/form-to-tool-mapper.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Form-to-Tool Mapper
+ *
+ * Takes unregistered HTML forms and generates complete WebMCP tool definitions
+ * by mapping form fields to JSON Schema properties.
+ */
+import type { UnregisteredForm } from '../core/types/tool.js';
+import type { ToolInputSchema } from '../core/types/tool.js';
+/**
+ * A suggested WebMCP tool definition generated from an unregistered form
+ */
+export interface SuggestedTool {
+    /** Kebab-case tool name */
+    suggestedName: string;
+    /** Human-readable description */
+    suggestedDescription: string;
+    /** JSON Schema for inputs */
+    suggestedSchema: ToolInputSchema;
+    /** How valuable this tool is for AI agents */
+    agenticValue: 'critical' | 'high' | 'medium' | 'low';
+    /** Estimated score improvement if implemented */
+    estimatedScoreImpact: number;
+    /** Source form metadata */
+    sourceForm: {
+        index: number;
+        action: string | null;
+        method: string;
+        fieldCount: number;
+        pageUrl: string;
+    };
+    /** Annotations hint for the tool */
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        requiresConfirmation: boolean;
+    };
+    /** Hidden fields present in the form */
+    hiddenFields: HiddenFieldInfo[];
+}
+export interface HiddenFieldInfo {
+    name: string;
+    value: string | null;
+    metadata: 'hidden-field';
+}
+/**
+ * Generate a tool name from form context clues.
+ * Uses form action URL, id, submit text, or field analysis to produce a kebab-case name.
+ */
+export declare function generateToolName(form: UnregisteredForm): string;
+/**
+ * Generate a tool description from form context
+ */
+export declare function generateToolDescription(form: UnregisteredForm): string;
+/**
+ * Map a single unregistered form to a SuggestedTool definition
+ */
+export declare function mapFormToTool(form: UnregisteredForm, html?: string): SuggestedTool;
+/**
+ * Map all unregistered forms to suggested tools
+ */
+export declare function mapFormsToTools(forms: UnregisteredForm[], html?: string): SuggestedTool[];

package/dist/analysis/form-to-tool-mapper.js

@@ -0,0 +1,360 @@
+/**
+ * Form-to-Tool Mapper
+ *
+ * Takes unregistered HTML forms and generates complete WebMCP tool definitions
+ * by mapping form fields to JSON Schema properties.
+ */
+import * as cheerio from 'cheerio';
+import { INPUT_TYPE_MAP } from '../core/constants.js';
+/**
+ * Map an HTML input type to a JSON Schema type
+ */
+function mapInputTypeToSchema(inputType) {
+    const mapped = INPUT_TYPE_MAP[inputType.toLowerCase()];
+    if (mapped === 'number')
+        return 'number';
+    if (mapped === 'boolean')
+        return 'boolean';
+    return 'string';
+}
+/**
+ * Map an HTML input type to a JSON Schema format string, if applicable
+ */
+function mapInputTypeToFormat(inputType) {
+    const formatMap = {
+        email: 'email',
+        url: 'uri',
+        date: 'date',
+        'datetime-local': 'date-time',
+        time: 'time',
+    };
+    return formatMap[inputType.toLowerCase()];
+}
+/**
+ * Generate a tool name from form context clues.
+ * Uses form action URL, id, submit text, or field analysis to produce a kebab-case name.
+ */
+export function generateToolName(form) {
+    const clues = form.contextClues;
+    // Try form id first
+    if (clues.formId) {
+        return toKebabCase(clues.formId);
+    }
+    // Try form action URL path
+    if (clues.formAction && clues.formAction !== '#' && clues.formAction !== '') {
+        const actionName = extractNameFromAction(clues.formAction);
+        if (actionName)
+            return actionName;
+    }
+    // Try submit button text
+    if (clues.submitText) {
+        const cleaned = clues.submitText.replace(/[^a-zA-Z0-9\s]/g, '').trim();
+        if (cleaned.length > 0 && cleaned.length < 40) {
+            return toKebabCase(cleaned);
+        }
+    }
+    // Try nearest heading
+    if (clues.nearestHeading) {
+        const cleaned = clues.nearestHeading.replace(/[^a-zA-Z0-9\s]/g, '').trim();
+        if (cleaned.length > 0 && cleaned.length < 40) {
+            return toKebabCase(cleaned);
+        }
+    }
+    // Try aria-label
+    if (clues.ariaLabel) {
+        return toKebabCase(clues.ariaLabel);
+    }
+    // Fallback: infer from field names
+    const fieldBased = inferNameFromFields(clues.fieldNames);
+    if (fieldBased)
+        return fieldBased;
+    // Last resort
+    return `form-${form.index}`;
+}
+/**
+ * Extract a meaningful name from a form action URL
+ */
+function extractNameFromAction(action) {
+    try {
+        // Handle relative and absolute URLs
+        const path = action.startsWith('http')
+            ? new URL(action).pathname
+            : action.split('?')[0] ?? action;
+        // Get the last meaningful segment
+        const segments = path
+            .split('/')
+            .filter((s) => s.length > 0 && !s.startsWith(':') && !s.startsWith('{'));
+        if (segments.length === 0)
+            return null;
+        // Use the last 1-2 segments
+        const relevant = segments.slice(-2).join('-');
+        const cleaned = relevant.replace(/[^a-zA-Z0-9-]/g, '');
+        return cleaned.length > 0 ? toKebabCase(cleaned) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Infer a tool name from field names
+ */
+function inferNameFromFields(fieldNames) {
+    const meaningful = fieldNames.filter((n) => n.length > 0 && !['csrf', 'token', '_method', 'utf8'].includes(n.toLowerCase()));
+    if (meaningful.length === 0)
+        return null;
+    // Check for common patterns
+    const joined = meaningful.join(' ').toLowerCase();
+    if (/search|query|q\b/.test(joined))
+        return 'search';
+    if (/login|signin|username.*password/.test(joined))
+        return 'login';
+    if (/register|signup/.test(joined))
+        return 'register';
+    if (/subscribe|newsletter|email/.test(joined))
+        return 'subscribe';
+    if (/contact|message|subject.*body/.test(joined))
+        return 'send-message';
+    if (/comment|reply/.test(joined))
+        return 'post-comment';
+    if (/filter|sort/.test(joined))
+        return 'filter';
+    if (/checkout|payment|card/.test(joined))
+        return 'checkout';
+    if (/address|shipping/.test(joined))
+        return 'submit-address';
+    if (/review|rating/.test(joined))
+        return 'submit-review';
+    // Use first 2-3 field names
+    const nameFields = meaningful.slice(0, 3);
+    return toKebabCase(nameFields.join('-'));
+}
+/**
+ * Convert a string to kebab-case
+ */
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-zA-Z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .toLowerCase()
+        .substring(0, 50);
+}
+/**
+ * Generate a tool description from form context
+ */
+export function generateToolDescription(form) {
+    const clues = form.contextClues;
+    const parts = [];
+    // Start with heading context
+    if (clues.nearestHeading) {
+        parts.push(clues.nearestHeading);
+    }
+    // Add submit text context
+    if (clues.submitText) {
+        const verb = clues.submitText.toLowerCase();
+        if (!parts.some((p) => p.toLowerCase().includes(verb))) {
+            parts.push(clues.submitText);
+        }
+    }
+    // Add field description context
+    const fieldDesc = describeFields(form);
+    if (fieldDesc) {
+        parts.push(fieldDesc);
+    }
+    if (parts.length === 0) {
+        // Fallback based on method
+        const method = clues.formMethod.toUpperCase();
+        if (method === 'GET') {
+            return `Query data using ${form.fieldCount} parameter(s)`;
+        }
+        return `Submit form data with ${form.fieldCount} field(s)`;
+    }
+    // Construct a coherent sentence
+    const context = parts.join(' - ');
+    return context.charAt(0).toUpperCase() + context.slice(1);
+}
+/**
+ * Describe fields in a human-readable way
+ */
+function describeFields(form) {
+    const labels = form.fields
+        .map((f) => f.label ?? f.placeholder ?? f.name)
+        .filter((l) => l.length > 0)
+        .slice(0, 4);
+    if (labels.length === 0)
+        return null;
+    if (labels.length <= 3) {
+        return `Accepts ${labels.join(', ')}`;
+    }
+    return `Accepts ${labels.slice(0, 3).join(', ')}, and more`;
+}
+/**
+ * Map a single form field to a JSON Schema property
+ */
+function mapFieldToProperty(field) {
+    const prop = {
+        type: mapInputTypeToSchema(field.type),
+    };
+    // Description from label or placeholder
+    const desc = field.label ?? field.placeholder;
+    if (desc) {
+        prop.description = desc;
+    }
+    // Format from input type
+    const format = mapInputTypeToFormat(field.type);
+    if (format) {
+        prop.format = format;
+    }
+    // Enum for select options
+    if (field.options && field.options.length > 0) {
+        prop.enum = field.options
+            .filter((o) => o.value !== '')
+            .map((o) => o.value);
+    }
+    // Checkbox -> boolean
+    if (field.type === 'checkbox') {
+        prop.type = 'boolean';
+    }
+    return prop;
+}
+/**
+ * Build a complete JSON Schema from form fields, handling radio groups
+ */
+function buildSchemaFromFields(form, html) {
+    const properties = {};
+    const required = [];
+    const hiddenFields = [];
+    const seenRadioGroups = new Set();
+    // Process visible fields
+    for (const field of form.fields) {
+        if (!field.name)
+            continue;
+        // Radio groups: only process once per name
+        if (field.type === 'radio') {
+            if (seenRadioGroups.has(field.name))
+                continue;
+            seenRadioGroups.add(field.name);
+            // Collect all radio options from the form HTML if available
+            if (html && form.formOuterHTML) {
+                const radioOptions = extractRadioOptions(form.formOuterHTML, field.name);
+                if (radioOptions.length > 0) {
+                    properties[field.name] = {
+                        type: 'string',
+                        enum: radioOptions.map((o) => o.value),
+                        description: field.label ?? undefined,
+                    };
+                    if (field.required)
+                        required.push(field.name);
+                    continue;
+                }
+            }
+        }
+        properties[field.name] = mapFieldToProperty(field);
+        if (field.required) {
+            required.push(field.name);
+        }
+    }
+    // Extract hidden fields from form HTML
+    if (form.formOuterHTML) {
+        const $ = cheerio.load(form.formOuterHTML);
+        $('input[type=hidden]').each((_i, el) => {
+            const name = $(el).attr('name');
+            if (name) {
+                hiddenFields.push({
+                    name,
+                    value: $(el).attr('value') ?? null,
+                    metadata: 'hidden-field',
+                });
+            }
+        });
+    }
+    return {
+        schema: {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        },
+        hiddenFields,
+    };
+}
+/**
+ * Extract radio button options from HTML snippet
+ */
+function extractRadioOptions(html, name) {
+    const $ = cheerio.load(html);
+    const options = [];
+    $(`input[type=radio][name="${name}"]`).each((_i, el) => {
+        const $el = $(el);
+        const value = $el.attr('value') ?? '';
+        const text = $el.closest('label').text().trim() ||
+            $el.next('label').text().trim() ||
+            value;
+        options.push({ value, text });
+    });
+    return options;
+}
+/**
+ * Estimate the agentic value score impact of implementing a tool
+ */
+function estimateScoreImpact(agenticValue, fieldCount) {
+    const baseImpact = {
+        critical: 8,
+        high: 5,
+        medium: 3,
+        low: 1,
+    };
+    const base = baseImpact[agenticValue] ?? 2;
+    // Larger forms have more impact
+    const complexity = Math.min(fieldCount / 5, 1.5);
+    return Math.round(base * (1 + complexity * 0.3));
+}
+/**
+ * Determine annotation hints from form context
+ */
+function inferAnnotations(form) {
+    const method = form.contextClues.formMethod.toUpperCase();
+    const isReadOnly = method === 'GET';
+    const isDestructive = form.contextClues.hasPaymentFields ||
+        /delete|remove|cancel/i.test([form.contextClues.submitText ?? '', form.contextClues.formAction ?? ''].join(' '));
+    const requiresConfirmation = form.sensitivity === 'critical' ||
+        form.sensitivity === 'high' ||
+        isDestructive;
+    return {
+        readOnlyHint: isReadOnly,
+        destructiveHint: isDestructive,
+        requiresConfirmation,
+    };
+}
+/**
+ * Map a single unregistered form to a SuggestedTool definition
+ */
+export function mapFormToTool(form, html) {
+    const suggestedName = generateToolName(form);
+    const suggestedDescription = generateToolDescription(form);
+    const { schema, hiddenFields } = buildSchemaFromFields(form, html);
+    return {
+        suggestedName,
+        suggestedDescription,
+        suggestedSchema: schema,
+        agenticValue: form.agenticValue,
+        estimatedScoreImpact: estimateScoreImpact(form.agenticValue, form.fieldCount),
+        sourceForm: {
+            index: form.index,
+            action: form.contextClues.formAction,
+            method: form.contextClues.formMethod,
+            fieldCount: form.fieldCount,
+            pageUrl: form.pageUrl ?? '',
+        },
+        annotations: inferAnnotations(form),
+        hiddenFields,
+    };
+}
+/**
+ * Map all unregistered forms to suggested tools
+ */
+export function mapFormsToTools(forms, html) {
+    return forms.map((form) => mapFormToTool(form, html));
+}
+//# sourceMappingURL=form-to-tool-mapper.js.map

package/dist/analysis/form-to-tool-mapper.js.map

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

package/dist/analysis/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Analysis Module
+ *
+ * Integrates form-to-tool mapping, missing tool analysis, and code generation
+ * into a single suggestion pipeline.
+ */
+import type { DetectedTool, UnregisteredForm } from '../core/types/tool.js';
+import type { SuggestedTool } from './form-to-tool-mapper.js';
+import type { InteractiveOpportunity } from './missing-tool-analyzer.js';
+export { mapFormToTool, mapFormsToTools, generateToolName, generateToolDescription } from './form-to-tool-mapper.js';
+export type { SuggestedTool, HiddenFieldInfo } from './form-to-tool-mapper.js';
+export { analyzeForMissingTools } from './missing-tool-analyzer.js';
+export type { InteractiveOpportunity } from './missing-tool-analyzer.js';
+/**
+ * Input data for the analysis pipeline
+ */
+export interface PageAnalysisData {
+    /** Raw HTML content of the page */
+    html: string;
+    /** Page URL */
+    pageUrl: string;
+    /** Already detected WebMCP tools */
+    existingTools: DetectedTool[];
+    /** Unregistered forms found by declarative scanner */
+    unregisteredForms: UnregisteredForm[];
+}
+/**
+ * Gap analysis summary
+ */
+export interface GapAnalysis {
+    /** Total interactive elements found */
+    totalInteractiveElements: number;
+    /** Elements already covered by WebMCP tools */
+    coveredElements: number;
+    /** Elements that should have WebMCP tools */
+    uncoveredElements: number;
+    /** Coverage ratio (0-1) */
+    coverageRatio: number;
+    /** Breakdown by element type */
+    breakdown: {
+        forms: {
+            total: number;
+            covered: number;
+        };
+        search: {
+            total: number;
+            covered: number;
+        };
+        filters: {
+            total: number;
+            covered: number;
+        };
+        actions: {
+            total: number;
+            covered: number;
+        };
+        navigation: {
+            total: number;
+            covered: number;
+        };
+    };
+}
+/**
+ * Complete result from the suggestion engine
+ */
+export interface SuggestionResult {
+    /** Tools suggested from unregistered forms */
+    suggestedTools: SuggestedTool[];
+    /** Interactive elements detected as opportunities */
+    interactiveOpportunities: InteractiveOpportunity[];
+    /** Combined generated code (JS + HTML) */
+    codeOutput: {
+        combinedJS: string;
+        combinedHTML: string;
+    };
+    /** Gap analysis summary */
+    gapAnalysis: GapAnalysis;
+    /** Projected score improvement if all suggestions are implemented */
+    projectedScoreImprovement: number;
+}
+/**
+ * Main entry point: analyze a page and produce tool suggestions
+ */
+export declare function analyzeAndSuggest(data: PageAnalysisData): SuggestionResult;

package/dist/analysis/index.js

@@ -0,0 +1,81 @@
+/**
+ * Analysis Module
+ *
+ * Integrates form-to-tool mapping, missing tool analysis, and code generation
+ * into a single suggestion pipeline.
+ */
+import { mapFormsToTools } from './form-to-tool-mapper.js';
+import { analyzeForMissingTools } from './missing-tool-analyzer.js';
+import { generateCombinedCode } from '../generators/tool-code-generator.js';
+export { mapFormToTool, mapFormsToTools, generateToolName, generateToolDescription } from './form-to-tool-mapper.js';
+export { analyzeForMissingTools } from './missing-tool-analyzer.js';
+/**
+ * Main entry point: analyze a page and produce tool suggestions
+ */
+export function analyzeAndSuggest(data) {
+    // 1. Map unregistered forms to suggested tools
+    const suggestedTools = mapFormsToTools(data.unregisteredForms, data.html);
+    // 2. Analyze for missing interactive tool opportunities
+    const interactiveOpportunities = analyzeForMissingTools(data.html, data.existingTools, data.pageUrl);
+    // 3. Generate code for form-based suggestions
+    const codeOutput = generateCombinedCode(suggestedTools);
+    // 4. Compute gap analysis
+    const gapAnalysis = computeGapAnalysis(data, suggestedTools, interactiveOpportunities);
+    // 5. Estimate projected score improvement
+    const projectedScoreImprovement = estimateProjectedImprovement(suggestedTools, interactiveOpportunities);
+    return {
+        suggestedTools,
+        interactiveOpportunities,
+        codeOutput,
+        gapAnalysis,
+        projectedScoreImprovement,
+    };
+}
+/**
+ * Compute the gap analysis for a page
+ */
+function computeGapAnalysis(data, suggestedTools, opportunities) {
+    const formsCovered = data.existingTools.filter((t) => t.source === 'declarative').length;
+    const formsTotal = formsCovered + data.unregisteredForms.length;
+    const searchOpps = opportunities.filter((o) => o.elementType === 'search');
+    const filterOpps = opportunities.filter((o) => o.elementType === 'filter');
+    const actionOpps = opportunities.filter((o) => o.elementType === 'action-button');
+    const navOpps = opportunities.filter((o) => o.elementType === 'navigation');
+    // Count existing tools that cover each category
+    const existingNames = data.existingTools.map((t) => t.name.toLowerCase());
+    const searchCovered = existingNames.some((n) => /search|find|query/.test(n)) ? 1 : 0;
+    const filterCovered = existingNames.some((n) => /filter|sort|refine/.test(n)) ? 1 : 0;
+    const totalInteractive = formsTotal +
+        searchOpps.length + searchCovered +
+        filterOpps.length + filterCovered +
+        actionOpps.length +
+        navOpps.length;
+    const covered = formsCovered +
+        searchCovered +
+        filterCovered;
+    const uncovered = totalInteractive - covered;
+    const coverageRatio = totalInteractive > 0 ? covered / totalInteractive : 1;
+    return {
+        totalInteractiveElements: totalInteractive,
+        coveredElements: covered,
+        uncoveredElements: uncovered,
+        coverageRatio,
+        breakdown: {
+            forms: { total: formsTotal, covered: formsCovered },
+            search: { total: searchOpps.length + searchCovered, covered: searchCovered },
+            filters: { total: filterOpps.length + filterCovered, covered: filterCovered },
+            actions: { total: actionOpps.length, covered: 0 },
+            navigation: { total: navOpps.length, covered: 0 },
+        },
+    };
+}
+/**
+ * Estimate projected score improvement from implementing all suggestions
+ */
+function estimateProjectedImprovement(suggestedTools, opportunities) {
+    const formImpact = suggestedTools.reduce((sum, t) => sum + t.estimatedScoreImpact, 0);
+    const interactiveImpact = opportunities.reduce((sum, o) => sum + o.estimatedScoreImpact, 0);
+    // Cap at reasonable maximum (coverage category is only 5% weight)
+    return Math.min(formImpact + interactiveImpact, 25);
+}
+//# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

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

package/dist/analysis/missing-tool-analyzer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Missing Tool Analyzer
+ *
+ * Detects interactive elements that SHOULD be WebMCP tools but aren't:
+ * search inputs, filter controls, action buttons, navigation patterns,
+ * and JS-only functionality.
+ */
+import type { DetectedTool, ToolInputSchema } from '../core/types/tool.js';
+/**
+ * An interactive element detected as a potential tool opportunity
+ */
+export interface InteractiveOpportunity {
+    /** Type of interactive element detected */
+    elementType: 'search' | 'filter' | 'action-button' | 'navigation' | 'js-interactive';
+    /** Suggested tool name in kebab-case */
+    suggestedName: string;
+    /** Suggested tool description */
+    suggestedDescription: string;
+    /** Suggested input schema */
+    suggestedSchema: ToolInputSchema;
+    /** How valuable this tool is for AI agents */
+    agenticValue: 'critical' | 'high' | 'medium' | 'low';
+    /** Estimated score improvement if implemented */
+    estimatedScoreImpact: number;
+    /** HTML snippet of the detected element */
+    elementHTML: string;
+    /** Selector that identifies the element */
+    selector: string;
+    /** Confidence level (0-1) */
+    confidence: number;
+}
+/**
+ * Analyze HTML for interactive elements that should be WebMCP tools
+ */
+export declare function analyzeForMissingTools(html: string, existingTools: DetectedTool[], pageUrl: string): InteractiveOpportunity[];