webmcp-cli 1.2.2 → 1.2.3

package/dist/potential/analyzer.js

@@ -0,0 +1,383 @@
+import { crawlDepth2 } from '../crawler/depth-crawler.js';
+import { scanDeclarativeTools, toDetectedTool, scanUnregisteredForms, } from '../detection/declarative.js';
+import { analyzeForMissingTools } from '../analysis/missing-tool-analyzer.js';
+import { mapFormsToTools } from '../analysis/index.js';
+import { AIRecommender } from './ai-recommender.js';
+const DEFAULT_MAX_PAGES = 30;
+const DEFAULT_TIMEOUT = 15_000;
+const DEFAULT_MODEL = 'anthropic/claude-sonnet-4.5';
+const TOP_RECOMMENDATION_LIMIT = 5;
+const PRIORITY_DEDUCTIONS = {
+    critical: 15,
+    high: 10,
+    medium: 5,
+    low: 2,
+};
+const POTENTIAL_WEIGHTS = {
+    critical: 35,
+    high: 22,
+    medium: 12,
+    low: 6,
+};
+const CONFIDENCE_BY_PRIORITY = {
+    critical: 0.9,
+    high: 0.8,
+    medium: 0.7,
+    low: 0.6,
+};
+export async function runPotentialAnalysis(options) {
+    const targetUrl = options.url;
+    const maxPages = sanitizePositiveInt(options.maxPages, DEFAULT_MAX_PAGES);
+    const timeout = sanitizePositiveInt(options.timeout, DEFAULT_TIMEOUT);
+    const useAI = options.useAI ?? true;
+    const model = options.model ?? DEFAULT_MODEL;
+    const apiKey = options.apiKey ?? process.env['OPENROUTER_API_KEY'];
+    const onProgress = options.onProgress;
+    const discoveredUrls = new Set();
+    const crawlResult = await crawlWithProgress(targetUrl, {
+        maxPages,
+        timeout,
+        onPageCrawled: (url, internalLinks, crawledCount) => {
+            discoveredUrls.add(url);
+            for (const link of internalLinks) {
+                discoveredUrls.add(link);
+            }
+            onProgress?.({
+                phase: 'crawling',
+                pagesFound: discoveredUrls.size,
+                pagesCrawled: crawledCount,
+                currentUrl: url,
+            });
+        },
+    });
+    const analyzedPages = [];
+    const totalPages = crawlResult.pages.length;
+    let analyzedCount = 0;
+    for (const crawledPage of crawlResult.pages) {
+        analyzedCount += 1;
+        onProgress?.({
+            phase: 'analyzing',
+            pagesAnalyzed: analyzedCount,
+            totalPages,
+            currentUrl: crawledPage.url,
+        });
+        const declarativeTools = scanDeclarativeTools(crawledPage.html, crawledPage.url).map(toDetectedTool);
+        const unregisteredForms = scanUnregisteredForms(crawledPage.html, crawledPage.url);
+        const formMap = new Map();
+        for (const form of unregisteredForms) {
+            formMap.set(form.index, form);
+        }
+        const suggestedTools = mapFormsToTools(unregisteredForms, crawledPage.html);
+        const formOpportunities = suggestedTools.map((tool) => convertSuggestedToolToOpportunity(tool, formMap.get(tool.sourceForm.index)));
+        const interactiveOpportunities = analyzeForMissingTools(crawledPage.html, declarativeTools, crawledPage.url).map(convertInteractiveOpportunity);
+        const combinedOpportunities = mergeOpportunities(formOpportunities, interactiveOpportunities);
+        const pagePotential = {
+            url: crawledPage.url,
+            title: crawledPage.title || crawledPage.url,
+            depth: crawledPage.depth,
+            existingTools: declarativeTools.length,
+            opportunities: combinedOpportunities,
+            aiRecommendations: [],
+            potentialScore: calculatePagePotentialScore(combinedOpportunities, declarativeTools.length),
+        };
+        analyzedPages.push({
+            page: pagePotential,
+            html: crawledPage.html,
+            existingToolNames: declarativeTools.map((tool) => tool.name),
+        });
+    }
+    const pages = analyzedPages.map((entry) => entry.page);
+    let globalRecommendations = [];
+    const aiTargets = analyzedPages.filter((entry) => entry.page.opportunities.length > 0);
+    let aiSummaryProvider = null;
+    if (useAI && analyzedPages.length > 0) {
+        const recommender = new AIRecommender(apiKey, model);
+        const totalAiTargets = aiTargets.length;
+        let aiProcessed = 0;
+        for (const entry of aiTargets) {
+            aiProcessed += 1;
+            onProgress?.({
+                phase: 'ai-analyzing',
+                pagesAnalyzed: aiProcessed,
+                totalPages: totalAiTargets,
+                currentUrl: entry.page.url,
+            });
+            try {
+                const aiPage = await recommender.analyzePage(entry.page.url, entry.html, entry.existingToolNames);
+                entry.page.potentialScore = Math.max(entry.page.potentialScore, aiPage.potentialScore);
+                entry.page.aiRecommendations = mergeRecommendations(entry.page.aiRecommendations, aiPage.aiRecommendations);
+                entry.page.opportunities = mergeOpportunities(entry.page.opportunities, aiPage.opportunities);
+            }
+            catch {
+                // Swallow AI errors; heuristics already populated.
+            }
+        }
+        try {
+            globalRecommendations = await recommender.generateRecommendations(pages);
+        }
+        catch {
+            globalRecommendations = buildFallbackRecommendations(pages);
+        }
+        aiSummaryProvider = (report) => recommender.generateSummary(report);
+    }
+    else {
+        globalRecommendations = buildFallbackRecommendations(pages);
+    }
+    const sortedPages = [...pages].sort((a, b) => b.potentialScore - a.potentialScore);
+    const totalOpportunities = sortedPages.reduce((sum, page) => sum + page.opportunities.length, 0);
+    const readinessScore = calculateOverallReadiness(sortedPages);
+    const topRecommendations = (globalRecommendations.length > 0
+        ? globalRecommendations
+        : buildFallbackRecommendations(sortedPages)).slice(0, TOP_RECOMMENDATION_LIMIT);
+    onProgress?.({ phase: 'summarizing' });
+    const report = {
+        targetUrl,
+        crawledPages: crawlResult.totalPagesCrawled,
+        totalOpportunities,
+        pages: sortedPages,
+        topRecommendations,
+        overallReadinessScore: readinessScore,
+        summary: '',
+    };
+    if (aiSummaryProvider) {
+        try {
+            report.summary = await aiSummaryProvider(report);
+        }
+        catch {
+            report.summary = buildFallbackSummary(report);
+        }
+    }
+    else {
+        report.summary = buildFallbackSummary(report);
+    }
+    onProgress?.({ phase: 'complete', report });
+    return report;
+}
+async function crawlWithProgress(targetUrl, options) {
+    try {
+        return await crawlDepth2(targetUrl, {
+            maxPages: options.maxPages,
+            timeout: options.timeout,
+            onPageCrawled: (page, progress) => {
+                options.onPageCrawled(page.url, page.internalLinks, progress.done);
+            },
+        });
+    }
+    catch (error) {
+        return {
+            pages: [],
+            totalPagesFound: 0,
+            totalPagesCrawled: 0,
+            crawlDuration: 0,
+            errors: [
+                {
+                    url: targetUrl,
+                    error: error instanceof Error ? error.message : 'Unknown crawl failure',
+                },
+            ],
+        };
+    }
+}
+function convertSuggestedToolToOpportunity(tool, form) {
+    const descriptor = describeFormOpportunity(tool, form);
+    return {
+        type: 'form',
+        element: descriptor,
+        suggestedToolName: tool.suggestedName,
+        suggestedDescription: tool.suggestedDescription,
+        agenticValue: tool.agenticValue,
+        confidence: CONFIDENCE_BY_PRIORITY[tool.agenticValue],
+    };
+}
+function convertInteractiveOpportunity(opp) {
+    return {
+        type: mapElementType(opp.elementType),
+        element: opp.selector || truncateElement(opp.elementHTML),
+        suggestedToolName: opp.suggestedName,
+        suggestedDescription: opp.suggestedDescription,
+        agenticValue: opp.agenticValue,
+        confidence: clamp(opp.confidence ?? 0.6, 0, 1),
+    };
+}
+function mapElementType(type) {
+    switch (type) {
+        case 'search':
+            return 'search';
+        case 'filter':
+            return 'filter';
+        case 'navigation':
+            return 'navigation';
+        case 'action-button':
+            return 'action';
+        default:
+            return 'dynamic';
+    }
+}
+function describeFormOpportunity(tool, form) {
+    const clues = form?.contextClues;
+    const descriptorParts = [
+        form?.contextClues?.formId ? `#${form.contextClues?.formId}` : null,
+        clues?.nearestHeading,
+        tool.sourceForm.action ? `action=${tool.sourceForm.action}` : null,
+        clues?.submitText ? `submit=${clues.submitText}` : null,
+    ].filter(Boolean);
+    if (descriptorParts.length === 0) {
+        return `form-${tool.sourceForm.index}`;
+    }
+    return descriptorParts.join(' ').slice(0, 160);
+}
+function truncateElement(html) {
+    if (!html)
+        return 'unknown-element';
+    const normalized = html.replace(/\s+/g, ' ').trim();
+    return normalized.length > 160 ? `${normalized.slice(0, 157)}...` : normalized;
+}
+function mergeOpportunities(existing, additions) {
+    if (additions.length === 0) {
+        return existing.slice();
+    }
+    const merged = [...existing];
+    const indexByKey = new Map();
+    merged.forEach((opp, index) => indexByKey.set(opportunityKey(opp), index));
+    for (const addition of additions) {
+        const key = opportunityKey(addition);
+        const currentIndex = indexByKey.get(key);
+        if (currentIndex === undefined) {
+            indexByKey.set(key, merged.length);
+            merged.push(addition);
+            continue;
+        }
+        const current = merged[currentIndex];
+        if (!current) {
+            merged[currentIndex] = addition;
+            continue;
+        }
+        if (priorityWeight(addition.agenticValue) > priorityWeight(current.agenticValue)) {
+            merged[currentIndex] = {
+                ...addition,
+                confidence: Math.max(current.confidence, addition.confidence),
+            };
+        }
+        else {
+            merged[currentIndex] = {
+                ...current,
+                confidence: Math.max(current.confidence, addition.confidence),
+            };
+        }
+    }
+    return merged;
+}
+function mergeRecommendations(existing, additions) {
+    if (additions.length === 0) {
+        return existing;
+    }
+    const merged = [...existing];
+    const indexByTitle = new Map();
+    merged.forEach((rec, index) => indexByTitle.set(rec.title.toLowerCase(), index));
+    for (const addition of additions) {
+        const key = addition.title.toLowerCase();
+        const currentIndex = indexByTitle.get(key);
+        if (currentIndex === undefined) {
+            indexByTitle.set(key, merged.length);
+            merged.push(addition);
+            continue;
+        }
+        const current = merged[currentIndex];
+        if (!current) {
+            merged[currentIndex] = addition;
+            continue;
+        }
+        if (priorityWeight(addition.priority) > priorityWeight(current.priority)) {
+            merged[currentIndex] = addition;
+        }
+    }
+    return merged;
+}
+function opportunityKey(opp) {
+    return `${opp.element.toLowerCase()}::${opp.suggestedToolName.toLowerCase()}`;
+}
+function calculatePagePotentialScore(opportunities, existingToolCount) {
+    if (opportunities.length === 0) {
+        return existingToolCount > 0 ? 25 : 40;
+    }
+    const rawScore = opportunities.reduce((sum, opp) => sum + POTENTIAL_WEIGHTS[opp.agenticValue], 0) - existingToolCount * 5;
+    return clamp(rawScore, 15, 100);
+}
+function calculateOverallReadiness(pages) {
+    const deductions = pages
+        .flatMap((page) => page.opportunities)
+        .reduce((sum, opp) => sum + PRIORITY_DEDUCTIONS[opp.agenticValue], 0);
+    const score = 100 - deductions;
+    return score < 0 ? 0 : score;
+}
+function buildFallbackRecommendations(pages) {
+    const flattened = pages.flatMap((page) => page.opportunities.map((opp) => ({ page, opp })));
+    if (flattened.length === 0) {
+        return [];
+    }
+    flattened.sort((a, b) => {
+        const weightDiff = priorityWeight(b.opp.agenticValue) - priorityWeight(a.opp.agenticValue);
+        if (weightDiff !== 0) {
+            return weightDiff;
+        }
+        return b.page.potentialScore - a.page.potentialScore;
+    });
+    return flattened.slice(0, TOP_RECOMMENDATION_LIMIT).map(({ page, opp }) => ({
+        title: toTitleCase(opp.suggestedToolName),
+        description: `${opp.suggestedDescription} on ${page.title || page.url}.`,
+        priority: opp.agenticValue,
+        toolDefinition: {
+            name: opp.suggestedToolName,
+            description: opp.suggestedDescription,
+            inputSchema: {},
+        },
+        implementationHint: `Start with element: ${opp.element}`,
+        estimatedImpact: `Improves ${opp.type} coverage on ${page.url}`,
+    }));
+}
+function buildFallbackSummary(report) {
+    if (report.crawledPages === 0) {
+        return `Unable to crawl ${report.targetUrl}. Check connectivity or URL correctness.`;
+    }
+    const focusPage = report.pages[0];
+    const focus = focusPage
+        ? `${focusPage.title || focusPage.url} (${focusPage.opportunities.length} opportunities)`
+        : 'the site overall';
+    return `Analyzed ${report.crawledPages} pages on ${report.targetUrl}, uncovered ${report.totalOpportunities} opportunities. Focus on ${focus} to raise readiness above ${report.overallReadinessScore}/100.`;
+}
+function sanitizePositiveInt(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return fallback;
+    }
+    const normalized = Math.max(1, Math.floor(value));
+    return normalized;
+}
+function clamp(value, min, max) {
+    if (Number.isNaN(value))
+        return min;
+    if (value < min)
+        return min;
+    if (value > max)
+        return max;
+    return value;
+}
+function priorityWeight(priority) {
+    switch (priority) {
+        case 'critical':
+            return 4;
+        case 'high':
+            return 3;
+        case 'medium':
+            return 2;
+        default:
+            return 1;
+    }
+}
+function toTitleCase(value) {
+    return value
+        .split(/[-_\s]+/)
+        .filter((segment) => segment.length > 0)
+        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/potential/analyzer.js.map

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

package/dist/potential/index.d.ts

@@ -0,0 +1,3 @@
+export { runPotentialAnalysis, type PotentialAnalysisOptions, type PotentialProgressEvent, } from './analyzer.js';
+export * from './types.js';
+export { AIRecommender } from './ai-recommender.js';

package/dist/potential/index.js

@@ -0,0 +1,4 @@
+export { runPotentialAnalysis, } from './analyzer.js';
+export * from './types.js';
+export { AIRecommender } from './ai-recommender.js';
+//# sourceMappingURL=index.js.map

package/dist/potential/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/potential/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/potential/prompts.d.ts

@@ -0,0 +1,20 @@
+import type { PagePotential, PotentialOpportunity, PotentialReport } from './types.js';
+export interface PromptTemplate {
+    system: string;
+    user: string;
+}
+export interface AnalyzePagePromptInput {
+    url: string;
+    htmlSnippet: string;
+    existingTools: string[];
+    detectedOpportunities?: PotentialOpportunity[];
+}
+export interface RecommendToolsPromptInput {
+    pages: PagePotential[];
+}
+export interface SummarizeFindingsPromptInput {
+    report: PotentialReport;
+}
+export declare const ANALYZE_PAGE_PROMPT: (input: AnalyzePagePromptInput) => PromptTemplate;
+export declare const RECOMMEND_TOOLS_PROMPT: (input: RecommendToolsPromptInput) => PromptTemplate;
+export declare const SUMMARIZE_FINDINGS_PROMPT: (input: SummarizeFindingsPromptInput) => PromptTemplate;

package/dist/potential/prompts.js

@@ -0,0 +1,42 @@
+const JSON_RESPONSE_REMINDER = 'Respond with a single JSON object that adheres to the requested schema. Do not add commentary.';
+export const ANALYZE_PAGE_PROMPT = (input) => {
+    const detectedSection = input.detectedOpportunities && input.detectedOpportunities.length > 0
+        ? `\nDetected Opportunities Hints:\n${JSON.stringify(input.detectedOpportunities.slice(0, 10), null, 2)}`
+        : '';
+    return {
+        system: `You are an AI analyst helping developers implement the Model Context Protocol (WebMCP) on websites. Identify actionable opportunities for AI agents and propose high-impact tools. ${JSON_RESPONSE_REMINDER}`,
+        user: `Analyze the following web page for WebMCP integration potential. Consider agent workflows, interactive elements, and existing coverage.\n\nPage URL: ${input.url}\nExisting WebMCP tools (${input.existingTools.length}): ${input.existingTools.join(', ') || 'none'}\n${detectedSection}\nHTML snippet (truncated):\n\n\u0060\u0060\u0060html\n${input.htmlSnippet}\n\u0060\u0060\u0060\n\nReturn JSON shaped exactly like:\n{\n  "title": string,\n  "potentialScore": number (0-100),\n  "depthHint": number | null,\n  "opportunities": [\n    {\n      "type": "form"|"search"|"filter"|"action"|"navigation"|"dynamic",\n      "element": string,\n      "suggestedToolName": string,\n      "suggestedDescription": string,\n      "agenticValue": "critical"|"high"|"medium"|"low",\n      "confidence": number (0-1)\n    }\n  ],\n  "recommendations": [\n    {\n      "title": string,\n      "description": string,\n      "priority": "critical"|"high"|"medium"|"low",\n      "toolDefinition": {\n        "name": string,\n        "description": string,\n        "inputSchema": object\n      } | null,\n      "implementationHint": string,\n      "estimatedImpact": string\n    }\n  ]\n}`,
+    };
+};
+export const RECOMMEND_TOOLS_PROMPT = (input) => {
+    const payload = JSON.stringify(input.pages.map((page) => ({
+        url: page.url,
+        title: page.title,
+        potentialScore: page.potentialScore,
+        opportunities: page.opportunities,
+    })), null, 2);
+    return {
+        system: `You are a senior WebMCP architect. Prioritize the most impactful tools that should be built next for AI agents. ${JSON_RESPONSE_REMINDER}`,
+        user: `Given the following per-page opportunities, choose up to 5 cross-page tool recommendations that will unlock the most agentic value. Merge similar ideas, highlight dependencies, and prefer tools that reuse schemas. Dataset:\n\n\u0060\u0060\u0060json\n${payload}\n\u0060\u0060\u0060\n\nReturn JSON shaped like:\n{\n  "recommendations": [\n    {\n      "title": string,\n      "description": string,\n      "priority": "critical"|"high"|"medium"|"low",\n      "toolDefinition": {\n        "name": string,\n        "description": string,\n        "inputSchema": object\n      } | null,\n      "implementationHint": string,\n      "estimatedImpact": string\n    }\n  ],\n  "reasoning": string\n}`,
+    };
+};
+export const SUMMARIZE_FINDINGS_PROMPT = (input) => {
+    const payload = JSON.stringify({
+        targetUrl: input.report.targetUrl,
+        crawledPages: input.report.crawledPages,
+        totalOpportunities: input.report.totalOpportunities,
+        overallReadinessScore: input.report.overallReadinessScore,
+        topRecommendations: input.report.topRecommendations,
+        perPageScores: input.report.pages.map((page) => ({
+            url: page.url,
+            title: page.title,
+            potentialScore: page.potentialScore,
+            opportunityCount: page.opportunities.length,
+        })),
+    }, null, 2);
+    return {
+        system: `You are a concise executive advisor summarizing WebMCP readiness findings for stakeholders. ${JSON_RESPONSE_REMINDER}`,
+        user: `Write a crisp 3-4 sentence summary that explains overall readiness, key opportunity types, and the impact of recommended tools. Input data:\n\n\u0060\u0060\u0060json\n${payload}\n\u0060\u0060\u0060\n\nReturn JSON: { "summary": string }`,
+    };
+};
+//# sourceMappingURL=prompts.js.map

package/dist/potential/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/potential/prompts.ts"],"names":[],"mappings":"AAsBA,MAAM,sBAAsB,GAAG,gGAAgG,CAAC;AAEhI,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAA6B,EACb,EAAE;IAClB,MAAM,eAAe,GAAG,KAAK,CAAC,qBAAqB,IAAI,KAAK,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC;QAC3F,CAAC,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACzG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,MAAM,EAAE,sLAAsL,sBAAsB,EAAE;QACtN,IAAI,EAAE,wJAAwJ,KAAK,CAAC,GAAG,4BAA4B,KAAK,CAAC,aAAa,CAAC,MAAM,MAAM,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,eAAe,0DAA0D,KAAK,CAAC,WAAW,2yBAA2yB;KACtpC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAgC,EAChB,EAAE;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAC5B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,mHAAmH,sBAAsB,EAAE;QACnJ,IAAI,EAAE,6PAA6P,OAAO,gbAAgb;KAC3rB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAAmC,EACnB,EAAE;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAC5B;QACE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS;QACjC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;QACvC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,kBAAkB;QACnD,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,qBAAqB;QACzD,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,kBAAkB;QACnD,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM;SAC5C,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,+FAA+F,sBAAsB,EAAE;QAC/H,IAAI,EAAE,0KAA0K,OAAO,4DAA4D;KACpP,CAAC;AACJ,CAAC,CAAC"}

package/dist/potential/types.d.ts

@@ -0,0 +1,40 @@
+export type AgenticPriority = 'critical' | 'high' | 'medium' | 'low';
+export type PotentialOpportunityType = 'form' | 'search' | 'filter' | 'action' | 'navigation' | 'dynamic';
+export interface PotentialOpportunity {
+    type: PotentialOpportunityType;
+    element: string;
+    suggestedToolName: string;
+    suggestedDescription: string;
+    agenticValue: AgenticPriority;
+    confidence: number;
+}
+export interface AIRecommendation {
+    title: string;
+    description: string;
+    priority: AgenticPriority;
+    toolDefinition?: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    };
+    implementationHint: string;
+    estimatedImpact: string;
+}
+export interface PagePotential {
+    url: string;
+    title: string;
+    depth: number;
+    existingTools: number;
+    opportunities: PotentialOpportunity[];
+    aiRecommendations: AIRecommendation[];
+    potentialScore: number;
+}
+export interface PotentialReport {
+    targetUrl: string;
+    crawledPages: number;
+    totalOpportunities: number;
+    pages: PagePotential[];
+    topRecommendations: AIRecommendation[];
+    overallReadinessScore: number;
+    summary: string;
+}

package/dist/potential/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/potential/types.js.map

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

package/dist/recon/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Reconnaissance Module
+ *
+ * Orchestrates all recon sub-tasks: sitemap, robots.txt, manifest,
+ * meta extraction, and route discovery. Runs as many tasks in parallel
+ * as possible to minimize wall-clock time.
+ */
+import type { ReconResult } from '../core/types/recon.js';
+/**
+ * Run full reconnaissance on a target URL.
+ *
+ * Gathers sitemap, robots.txt, manifest, meta tags, and discovers
+ * routes — all without launching a browser.
+ */
+export declare function runReconnaissance(url: string): Promise<ReconResult>;
+export { parseSitemap } from './sitemap.js';
+export { parseRobots, isPathAllowed } from './robots.js';
+export { parseManifest } from './manifest.js';
+export { extractMeta } from './meta-extractor.js';
+export { discoverRoutes } from './route-discovery.js';