@keak/webmcp-core 0.1.0 → 0.1.1

package/README.md

@@ -13,14 +13,74 @@ Auto-generate [WebMCP](https://nicholasc.au/2025/05/02/webmcp.html) tool definit
 npm install @keak/webmcp-core
 ```
 
-Playwright is an optional peer dependency — only required if you use `scanUrl()` or `generateToolDefinitions()`:
+Playwright is an optional peer dependency — only required for scanning:
 
 ```bash
 npm install playwright
 npx playwright install chromium
 ```
 
-## Quick Start
+## CLI
+
+The fastest way to get started. Works with Next.js, React, Vue, Svelte, Vite, Shopify, Astro, and plain HTML.
+
+### `webmcp init`
+
+Interactive project setup. Detects your framework, creates `webmcp.config.json`, and adds an npm script.
+
+```bash
+npx @keak/webmcp-core init
+```
+
+### `webmcp generate <url>`
+
+Scan a URL and generate tool definitions in one step.
+
+```bash
+npx @keak/webmcp-core generate https://example.com
+```
+
+Options:
+
+```
+--format <format>   Output format: snippet, react-hook, html-embed, manifest, userscript, yaml
+--output <dir>      Output directory (default: auto-detected from framework)
+--lang <js|ts>      Output language (default: ts if tsconfig.json exists)
+--depth <n>         Crawl depth (default: 2)
+--headless          Run browser in headless mode
+--timeout <ms>      Page timeout in milliseconds (default: 30000)
+--cookie <string>   Cookie string for authenticated pages
+--api-key <key>     OpenAI or Anthropic API key for AI enrichment
+--model <model>     AI model to use (default: gpt-4o-mini or claude-sonnet-4-20250514)
+```
+
+### `webmcp scan <url>`
+
+Scan only — saves raw results to `.webmcp/scan.json` for later export.
+
+```bash
+npx @keak/webmcp-core scan https://example.com
+```
+
+### `webmcp export`
+
+Export tool definitions from a previous scan.
+
+```bash
+npx @keak/webmcp-core export --format=react-hook
+```
+
+### AI Enrichment (BYOK)
+
+Pass your own OpenAI or Anthropic API key to improve tool names, descriptions, and field documentation. The provider is auto-detected from the key prefix (`sk-ant-*` for Anthropic, otherwise OpenAI).
+
+```bash
+npx @keak/webmcp-core generate https://example.com --api-key=sk-...
+```
+
+API keys are never stored in config files. You can also set them via environment variables: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `WEBMCP_API_KEY`.
+
+## Quick Start (Programmatic)
 
 ```ts
 import { generateToolDefinitions } from "@keak/webmcp-core";
@@ -38,12 +98,14 @@ for (const tool of tools) {
 
 ## Features
 
+- **CLI with framework detection** — Auto-detects Next.js, React, Vue, Svelte, Vite, Shopify, Astro
 - **Page scanning** — BFS crawl with Playwright, capturing forms, buttons, links, and network calls
 - **Action extraction** — Identifies form submissions, API calls, click flows, and route changes
 - **Tool synthesis** — Clusters related actions into named, described tool definitions with input schemas
 - **Safety classification** — Tags each tool as `read`, `write`, or `danger` based on its behavior
+- **AI enrichment** — BYOK support for OpenAI and Anthropic to improve tool quality
 - **Linting** — Validates naming conventions, descriptions, schemas, and safety annotations
-- **Multiple export formats** — TypeScript snippets, JSON manifests, Tampermonkey userscripts, YAML configs
+- **Multiple export formats** — Snippets, React hooks, HTML embeds, JSON manifests, userscripts, YAML
 
 ## API
 
@@ -85,8 +147,8 @@ const tools = proposeTools(scanResult, { minConfidence: 0.5 });
 Export tool definitions in a specific format.
 
 ```ts
-const result = exportTools(tools, "manifest", { domain: "example.com" });
-fs.writeFileSync("webmcp.manifest.json", result.files[0].content);
+const result = exportTools(tools, "react-hook", { domain: "example.com" });
+fs.writeFileSync(result.files[0].filename, result.files[0].content);
 ```
 
 ### `lintTools(tools)`
@@ -106,14 +168,34 @@ console.log(`${summary.errors} errors, ${summary.warnings} warnings`);
 | Format | Output | Use Case |
 |--------|--------|----------|
 | `snippet` | `webmcp.tools.ts` | Drop-in `navigator.modelContext.registerTool()` code |
+| `react-hook` | `webmcp.hooks.tsx` | `useWebMCPTools()` React hook with cleanup |
+| `html-embed` | `webmcp.embed.html` | `<script>` tag for any HTML page |
 | `manifest` | `webmcp.manifest.json` | Platform upload / API integration |
 | `userscript` | `webmcp.*.user.js` | Tampermonkey / Greasemonkey script |
 | `yaml` | `webmcp.tools.yaml` | Human-readable config |
 
+## Config File
+
+Running `webmcp init` creates a `webmcp.config.json`:
+
+```json
+{
+  "baseUrl": "https://example.com",
+  "framework": "next",
+  "output": { "format": "snippet", "lang": "ts", "outDir": "public" },
+  "scan": { "depth": 2, "timeout": 30000, "headless": true, "ignore": [] },
+  "ai": { "provider": "openai", "model": "gpt-4o-mini" },
+  "auth": { "method": "none" }
+}
+```
+
+CLI flags override config values. API keys are resolved from environment variables, never stored in config.
+
 ## Architecture
 
 ```
 src/
+├── cli/            CLI commands, framework detection, UI utilities
 ├── scanner/        Playwright-based page crawling and DOM capture
 ├── extractor/      Action extraction (forms, APIs, clicks, routes)
 ├── synthesizer/    Clustering, naming, description, safety, schemas
@@ -122,7 +204,7 @@ src/
 └── utils/          Validation schemas and PII redaction
 ```
 
-**Pipeline:** `scanUrl` → extractors → `clusterActions` → `ToolSpec[]` → `exportTools`
+**Pipeline:** `scanUrl` -> extractors -> `clusterActions` -> `ToolSpec[]` -> `exportTools`
 
 ## Tool Definition Shape
 

package/bin/webmcp.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { run } from "../dist/cli/index.js";
+
+run(process.argv.slice(2)).catch((err) => {
+  console.error(err.message || err);
+  process.exit(1);
+});

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,2 @@
+export declare function exportCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/cli/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAcA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFjE"}

package/dist/cli/commands/export.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportCommand = exportCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const chalk_1 = __importDefault(require("chalk"));
+const args_js_1 = require("../util/args.js");
+const version_js_1 = require("../util/version.js");
+const banner_js_1 = require("../ui/banner.js");
+const spinner_js_1 = require("../ui/spinner.js");
+const logger_js_1 = require("../ui/logger.js");
+const table_js_1 = require("../ui/table.js");
+const config_writer_js_1 = require("../framework/config-writer.js");
+const SCAN_PATH = (0, node_path_1.join)(".webmcp", "scan.json");
+async function exportCommand(args) {
+    const { values, positionals } = (0, args_js_1.parseCommandArgs)(args);
+    if (values.help) {
+        console.log(`
+  ${chalk_1.default.bold("webmcp export")} — Export tool definitions from saved scan data
+
+  ${chalk_1.default.dim("Usage:")}
+    webmcp export [scan-file] [options]
+
+  If no file is given, reads from .webmcp/scan.json (created by "webmcp scan").
+`);
+        return;
+    }
+    (0, banner_js_1.printBanner)((0, version_js_1.getVersion)());
+    const config = (0, config_writer_js_1.loadConfig)();
+    const scanFile = positionals[0] ?? SCAN_PATH;
+    if (!(0, node_fs_1.existsSync)(scanFile)) {
+        logger_js_1.log.error(`Scan data not found at ${chalk_1.default.cyan(scanFile)}`);
+        logger_js_1.log.info('Run "webmcp scan <url>" first to create scan data.');
+        process.exit(1);
+    }
+    const spinner = (0, spinner_js_1.createSpinner)("Loading scan data...");
+    spinner.start();
+    let scanResult;
+    try {
+        scanResult = JSON.parse((0, node_fs_1.readFileSync)(scanFile, "utf-8"));
+    }
+    catch {
+        spinner.fail("Failed to parse scan data");
+        process.exit(1);
+    }
+    spinner.succeed(`Loaded scan from ${chalk_1.default.cyan(scanResult.metadata.baseUrl)}`);
+    const proposeSpinner = (0, spinner_js_1.createSpinner)("Proposing tool definitions...");
+    proposeSpinner.start();
+    const { proposeTools, exportTools, lintTools } = await import("../../index.js");
+    const minConfidence = values["min-confidence"]
+        ? parseFloat(values["min-confidence"])
+        : 0.5;
+    const tools = proposeTools(scanResult, { minConfidence });
+    proposeSpinner.succeed(`Proposed ${tools.length} tool${tools.length !== 1 ? "s" : ""}`);
+    if (tools.length === 0) {
+        logger_js_1.log.warn("No tools found in scan data.");
+        return;
+    }
+    const format = values.format ?? config?.output.format ?? "snippet";
+    const lang = values.lang ?? config?.output.lang ?? "ts";
+    const outDir = values.output ?? config?.output.outDir ?? "./webmcp-output";
+    let domain;
+    try {
+        domain = new URL(scanResult.metadata.baseUrl).hostname;
+    }
+    catch {
+        domain = "unknown";
+    }
+    const exportSpinner = (0, spinner_js_1.createSpinner)(`Exporting as ${chalk_1.default.cyan(format)}...`);
+    exportSpinner.start();
+    const result = exportTools(tools, format, { lang, domain });
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    for (const file of result.files) {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outDir, file.name), file.content, "utf-8");
+    }
+    exportSpinner.succeed(`Exported to ${chalk_1.default.cyan(outDir + "/")}`);
+    const lintResults = lintTools(tools);
+    (0, table_js_1.printToolsTable)(tools);
+    (0, table_js_1.printLintSummary)(lintResults);
+    for (const file of result.files) {
+        logger_js_1.log.info(`  ${chalk_1.default.dim("→")} ${(0, node_path_1.join)(outDir, file.name)}`);
+    }
+    logger_js_1.log.blank();
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

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

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,2 @@
+export declare function generateCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAaA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkInE"}

package/dist/cli/commands/generate.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommand = generateCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const chalk_1 = __importDefault(require("chalk"));
+const args_js_1 = require("../util/args.js");
+const env_js_1 = require("../util/env.js");
+const version_js_1 = require("../util/version.js");
+const banner_js_1 = require("../ui/banner.js");
+const spinner_js_1 = require("../ui/spinner.js");
+const logger_js_1 = require("../ui/logger.js");
+const table_js_1 = require("../ui/table.js");
+const config_writer_js_1 = require("../framework/config-writer.js");
+async function generateCommand(args) {
+    const { values, positionals } = (0, args_js_1.parseCommandArgs)(args);
+    if (values.help) {
+        console.log(`
+  ${chalk_1.default.bold("webmcp generate")} <url> — Scan a URL and generate tool definitions
+
+  ${chalk_1.default.dim("Usage:")}
+    webmcp generate <url> [options]
+
+  If no URL is given, reads from webmcp.config.json.
+`);
+        return;
+    }
+    (0, banner_js_1.printBanner)((0, version_js_1.getVersion)());
+    const config = (0, config_writer_js_1.loadConfig)();
+    const url = positionals[0] ?? config?.baseUrl;
+    if (!url) {
+        logger_js_1.log.error("No URL provided. Usage: webmcp generate <url>");
+        logger_js_1.log.info('Or run "webmcp init" to create a config file.');
+        process.exit(1);
+    }
+    const format = values.format ?? config?.output.format ?? "snippet";
+    const lang = values.lang ?? config?.output.lang ?? "ts";
+    const depth = values.depth ? parseInt(values.depth, 10) : config?.scan.depth ?? 2;
+    const headless = (values.headless === true) || (config?.scan.headless ?? true);
+    const timeout = values.timeout ? parseInt(values.timeout, 10) : config?.scan.timeout ?? 30000;
+    const outDir = values.output ?? config?.output.outDir ?? "./webmcp-output";
+    const apiKey = (0, env_js_1.resolveApiKey)(values);
+    // Step 1: Scan
+    const scanSpinner = (0, spinner_js_1.createSpinner)(`Scanning ${chalk_1.default.cyan(url)}...`);
+    scanSpinner.start();
+    let scanUrl;
+    try {
+        const mod = await import("../../index.js");
+        scanUrl = mod.scanUrl;
+    }
+    catch {
+        scanSpinner.fail("Playwright not installed");
+        logger_js_1.log.blank();
+        logger_js_1.log.error("Playwright is required for scanning. Install it with:");
+        console.log(chalk_1.default.cyan("    npm install playwright && npx playwright install chromium"));
+        logger_js_1.log.blank();
+        process.exit(1);
+    }
+    const scanResult = await scanUrl({
+        url,
+        depth,
+        headless,
+        timeout,
+        onProgress: (event) => {
+            if (event.type === "page_visited") {
+                scanSpinner.text = `Scanned ${event.url} (${event.formsFound} forms, ${event.buttonsFound} buttons)`;
+            }
+        },
+    });
+    scanSpinner.succeed(`Scanned ${scanResult.metadata.pagesVisited} page${scanResult.metadata.pagesVisited !== 1 ? "s" : ""}`);
+    // Step 2: Propose tools
+    const proposeSpinner = (0, spinner_js_1.createSpinner)("Proposing tool definitions...");
+    proposeSpinner.start();
+    const { proposeTools } = await import("../../index.js");
+    const minConfidence = values["min-confidence"]
+        ? parseFloat(values["min-confidence"])
+        : 0.5;
+    let tools = proposeTools(scanResult, { minConfidence });
+    proposeSpinner.succeed(`Proposed ${tools.length} tool${tools.length !== 1 ? "s" : ""}`);
+    if (tools.length === 0) {
+        logger_js_1.log.warn("No tools found. Try scanning a different URL or lowering --min-confidence.");
+        return;
+    }
+    // Step 3: AI Enrichment
+    if (apiKey) {
+        const aiSpinner = (0, spinner_js_1.createSpinner)("Enriching with AI...");
+        aiSpinner.start();
+        const { enhanceWithLlm } = await import("../../synthesizer/llm-client.js");
+        const provider = (0, env_js_1.resolveProvider)(apiKey, values);
+        const model = values.model ?? config?.ai?.model;
+        tools = await enhanceWithLlm(tools, scanResult.actions, {
+            apiKey,
+            provider,
+            model,
+        });
+        aiSpinner.succeed("AI enrichment complete");
+    }
+    // Step 4: Lint
+    const { lintTools } = await import("../../index.js");
+    const lintResults = lintTools(tools);
+    // Step 5: Export
+    const exportSpinner = (0, spinner_js_1.createSpinner)(`Exporting as ${chalk_1.default.cyan(format)}...`);
+    exportSpinner.start();
+    const { exportTools } = await import("../../index.js");
+    let domain;
+    try {
+        domain = new URL(url).hostname;
+    }
+    catch {
+        domain = "unknown";
+    }
+    const result = exportTools(tools, format, { lang, domain });
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    for (const file of result.files) {
+        const filepath = (0, node_path_1.join)(outDir, file.name);
+        (0, node_fs_1.writeFileSync)(filepath, file.content, "utf-8");
+    }
+    exportSpinner.succeed(`Exported to ${chalk_1.default.cyan(outDir + "/")}`);
+    // Step 6: Summary
+    (0, table_js_1.printToolsTable)(tools);
+    (0, table_js_1.printLintSummary)(lintResults);
+    for (const file of result.files) {
+        logger_js_1.log.info(`  ${chalk_1.default.dim("→")} ${(0, node_path_1.join)(outDir, file.name)}`);
+    }
+    logger_js_1.log.blank();
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/commands/generate.js.map

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

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(_args: string[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAUA,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqIhE"}

package/dist/cli/commands/init.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const prompts_1 = require("@inquirer/prompts");
+const chalk_1 = __importDefault(require("chalk"));
+const banner_js_1 = require("../ui/banner.js");
+const logger_js_1 = require("../ui/logger.js");
+const version_js_1 = require("../util/version.js");
+const detect_js_1 = require("../framework/detect.js");
+const presets_js_1 = require("../framework/presets.js");
+const config_writer_js_1 = require("../framework/config-writer.js");
+async function initCommand(_args) {
+    (0, banner_js_1.printBanner)((0, version_js_1.getVersion)());
+    if ((0, config_writer_js_1.configExists)()) {
+        const overwrite = await (0, prompts_1.confirm)({
+            message: "webmcp.config.json already exists. Overwrite?",
+            default: false,
+        });
+        if (!overwrite) {
+            logger_js_1.log.info("Init cancelled.");
+            return;
+        }
+    }
+    const detection = (0, detect_js_1.detectFramework)();
+    const preset = (0, presets_js_1.getPreset)(detection.framework);
+    logger_js_1.log.info(`Detected framework: ${chalk_1.default.cyan(preset.label)}`);
+    if (detection.hasTypeScript)
+        logger_js_1.log.info("TypeScript: " + chalk_1.default.green("yes"));
+    logger_js_1.log.blank();
+    const frameworkChoices = [
+        { value: detection.framework, name: `${preset.label} (detected)` },
+        { value: "next", name: "Next.js" },
+        { value: "react-vite", name: "React + Vite" },
+        { value: "vue", name: "Vue.js" },
+        { value: "svelte", name: "SvelteKit" },
+        { value: "vite", name: "Vite" },
+        { value: "shopify", name: "Shopify" },
+        { value: "astro", name: "Astro" },
+        { value: "html", name: "Plain HTML" },
+    ];
+    const framework = await (0, prompts_1.select)({
+        message: "Confirm your framework:",
+        default: detection.framework,
+        choices: frameworkChoices.filter((c, i, arr) => i === 0 || c.value !== arr[0].value),
+    });
+    const selectedPreset = (0, presets_js_1.getPreset)(framework);
+    const baseUrl = await (0, prompts_1.input)({
+        message: "Base URL to scan:",
+        validate: (val) => {
+            try {
+                new URL(val);
+                return true;
+            }
+            catch {
+                return "Enter a valid URL (e.g., https://example.com)";
+            }
+        },
+    });
+    const format = await (0, prompts_1.select)({
+        message: "Output format:",
+        default: selectedPreset.defaultFormat,
+        choices: [
+            { value: "snippet", name: "snippet — JavaScript/TypeScript file" },
+            { value: "react-hook", name: "react-hook — React useWebMCPTools() hook" },
+            { value: "html-embed", name: "html-embed — <script> tag for any HTML page" },
+            { value: "manifest", name: "manifest — JSON manifest" },
+            { value: "userscript", name: "userscript — Tampermonkey/Greasemonkey" },
+            { value: "yaml", name: "yaml — YAML config" },
+        ],
+    });
+    const lang = detection.hasTypeScript ? "ts" : "js";
+    const outDir = selectedPreset.defaultOutDir;
+    let aiProvider;
+    let aiModel;
+    const useAi = await (0, prompts_1.confirm)({
+        message: "Enable AI enrichment? (requires an OpenAI or Anthropic API key)",
+        default: false,
+    });
+    if (useAi) {
+        aiProvider = await (0, prompts_1.select)({
+            message: "AI provider:",
+            choices: [
+                { value: "openai", name: "OpenAI" },
+                { value: "anthropic", name: "Anthropic" },
+            ],
+        });
+        const key = await (0, prompts_1.password)({
+            message: `${aiProvider === "openai" ? "OpenAI" : "Anthropic"} API key:`,
+        });
+        if (key) {
+            const envVar = aiProvider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+            logger_js_1.log.info(`Set ${chalk_1.default.cyan(envVar)}=${chalk_1.default.dim("sk-...")} in your environment.`);
+            logger_js_1.log.info("API keys are not stored in the config file.");
+        }
+        aiModel = aiProvider === "openai" ? "gpt-4o-mini" : "claude-sonnet-4-20250514";
+    }
+    (0, config_writer_js_1.writeConfig)({
+        baseUrl,
+        framework,
+        output: { format, lang, outDir },
+        scan: { depth: 2, timeout: 30000, headless: true, ignore: [] },
+        ai: aiProvider ? { provider: aiProvider, model: aiModel } : undefined,
+        auth: { method: "none" },
+    });
+    logger_js_1.log.success("Created " + chalk_1.default.cyan("webmcp.config.json"));
+    const addScript = await (0, prompts_1.confirm)({
+        message: 'Add "webmcp:generate" script to package.json?',
+        default: true,
+    });
+    if (addScript) {
+        const added = (0, config_writer_js_1.addNpmScript)("webmcp:generate", "webmcp generate");
+        if (added) {
+            logger_js_1.log.success('Added "webmcp:generate" to package.json scripts');
+        }
+        else {
+            logger_js_1.log.warn("Could not add script — no package.json found");
+        }
+    }
+    logger_js_1.log.blank();
+    logger_js_1.log.success("WebMCP is ready!");
+    logger_js_1.log.blank();
+    console.log(chalk_1.default.dim("  Next steps:"));
+    console.log(`    ${chalk_1.default.cyan("npx @keak/webmcp-core generate")}  — Generate tool definitions`);
+    console.log(`    ${chalk_1.default.cyan("npm run webmcp:generate")}         — Or use the npm script`);
+    logger_js_1.log.blank();
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/scan.d.ts

@@ -0,0 +1,2 @@
+export declare function scanCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/cli/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scan.ts"],"names":[],"mappings":"AAYA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE/D"}

package/dist/cli/commands/scan.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanCommand = scanCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const chalk_1 = __importDefault(require("chalk"));
+const args_js_1 = require("../util/args.js");
+const version_js_1 = require("../util/version.js");
+const banner_js_1 = require("../ui/banner.js");
+const spinner_js_1 = require("../ui/spinner.js");
+const logger_js_1 = require("../ui/logger.js");
+const config_writer_js_1 = require("../framework/config-writer.js");
+const WEBMCP_DIR = ".webmcp";
+async function scanCommand(args) {
+    const { values, positionals } = (0, args_js_1.parseCommandArgs)(args);
+    if (values.help) {
+        console.log(`
+  ${chalk_1.default.bold("webmcp scan")} <url> — Scan a URL and save raw results
+
+  ${chalk_1.default.dim("Usage:")}
+    webmcp scan <url> [options]
+
+  Results are saved to .webmcp/scan.json for later use with "webmcp export".
+`);
+        return;
+    }
+    (0, banner_js_1.printBanner)((0, version_js_1.getVersion)());
+    const config = (0, config_writer_js_1.loadConfig)();
+    const url = positionals[0] ?? config?.baseUrl;
+    if (!url) {
+        logger_js_1.log.error("No URL provided. Usage: webmcp scan <url>");
+        process.exit(1);
+    }
+    const depth = values.depth ? parseInt(values.depth, 10) : config?.scan.depth ?? 2;
+    const headless = (values.headless === true) || (config?.scan.headless ?? true);
+    const timeout = values.timeout ? parseInt(values.timeout, 10) : config?.scan.timeout ?? 30000;
+    const spinner = (0, spinner_js_1.createSpinner)(`Scanning ${chalk_1.default.cyan(url)}...`);
+    spinner.start();
+    let scanUrl;
+    try {
+        const mod = await import("../../index.js");
+        scanUrl = mod.scanUrl;
+    }
+    catch {
+        spinner.fail("Playwright not installed");
+        logger_js_1.log.blank();
+        logger_js_1.log.error("Playwright is required for scanning. Install it with:");
+        console.log(chalk_1.default.cyan("    npm install playwright && npx playwright install chromium"));
+        logger_js_1.log.blank();
+        process.exit(1);
+    }
+    const scanResult = await scanUrl({
+        url,
+        depth,
+        headless,
+        timeout,
+        onProgress: (event) => {
+            if (event.type === "page_visited") {
+                spinner.text = `Scanned ${event.url} (${event.formsFound} forms, ${event.buttonsFound} buttons)`;
+            }
+        },
+    });
+    spinner.succeed(`Scanned ${scanResult.metadata.pagesVisited} page${scanResult.metadata.pagesVisited !== 1 ? "s" : ""}`);
+    (0, node_fs_1.mkdirSync)(WEBMCP_DIR, { recursive: true });
+    const outPath = (0, node_path_1.join)(WEBMCP_DIR, "scan.json");
+    (0, node_fs_1.writeFileSync)(outPath, JSON.stringify(scanResult, null, 2), "utf-8");
+    logger_js_1.log.success(`Saved scan results to ${chalk_1.default.cyan(outPath)}`);
+    logger_js_1.log.info(`Found ${scanResult.pages.reduce((n, p) => n + p.forms.length, 0)} forms, ${scanResult.networkCalls.length} network calls`);
+    logger_js_1.log.blank();
+    logger_js_1.log.info(`Next: ${chalk_1.default.cyan("webmcp export")} to generate tool definitions from this scan.`);
+    logger_js_1.log.blank();
+}
+//# sourceMappingURL=scan.js.map

package/dist/cli/commands/scan.js.map

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