wmcp-annotate 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Satyan Avatara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# wmcp-annotate
+
+> The missing bridge between today's web and tomorrow's AI agents
+
+[![npm version](https://badge.fury.io/js/wmcp-annotate.svg)](https://www.npmjs.com/package/wmcp-annotate)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## The WebMCP Moment
+
+In February 2026, Google and Microsoft shipped WebMCP in Chrome 146 — a W3C standard that lets websites declare structured tools for AI agents.
+
+This isn't incremental. It's architectural.
+
+**Before WebMCP:** Agents scraped DOM (fragile) or parsed screenshots (expensive).
+**After WebMCP:** Websites declare capabilities. Agents call tools directly.
+
+The problem isn't the standard. It's adoption. **99% of websites have zero WebMCP annotations.**
+
+That's why this exists.
+
+## Installation
+
+### Option 1: Install globally (recommended)
+
+```bash
+npm install -g wmcp-annotate
+wmcp-annotate scan https://example.com
+```
+
+### Option 2: Run directly with npx
+
+```bash
+npx wmcp-annotate scan https://example.com
+```
+
+### Option 3: Run from GitHub (no npm publish needed)
+
+```bash
+npx github:rsatyan/wmcp-annotate scan https://example.com
+```
+
+> **Note:** Option 3 requires npm 10+. Check with `npm --version` and update with `npm install -g npm@latest` if needed.
+
+**Zero additional setup required.** Works instantly for static HTML sites.
+
+## Quick Start
+
+```bash
+# Scan a website (instant, no dependencies)
+wmcp-annotate scan https://example.com
+
+# Generate WebMCP tool definitions with AI
+wmcp-annotate suggest https://example.com
+
+# Output production-ready code
+wmcp-annotate generate https://example.com --format typescript
+```
+
+## Commands
+
+### `scan` — Analyze a website
+
+Discovers forms, buttons, links, and interactive elements.
+
+```bash
+# Default: Fast HTML parsing (works for most sites)
+wmcp-annotate scan https://example.com
+
+# For JavaScript-heavy SPAs (requires Playwright setup)
+wmcp-annotate scan https://react-app.com --browser
+```
+
+**Output:**
+```json
+{
+  "url": "https://example.com",
+  "elements": [
+    {
+      "type": "form",
+      "selector": "#search",
+      "label": "Search",
+      "inputs": [{ "name": "q", "type": "text" }]
+    }
+  ]
+}
+```
+
+### `suggest` — Generate tool definitions
+
+Uses AI to create meaningful WebMCP tool definitions from scan results.
+
+```bash
+wmcp-annotate suggest https://example.com
+wmcp-annotate suggest https://react-app.com --browser  # For SPAs
+wmcp-annotate suggest --scan-file scan.json --output tools.json
+```
+
+Requires an AI provider (see [Configuration](#ai-provider-configuration)).
+
+### `generate` — Output production code
+
+Creates ready-to-use JavaScript/TypeScript code.
+
+```bash
+wmcp-annotate generate https://example.com --format js
+wmcp-annotate generate https://example.com --format ts
+wmcp-annotate generate https://example.com --format react
+wmcp-annotate generate https://react-app.com --browser --format ts  # For SPAs
+```
+
+### `validate` — Check compliance
+
+Validates existing WebMCP implementations against the spec.
+
+```bash
+wmcp-annotate validate https://example.com
+wmcp-annotate validate https://example.com --ci  # Exit 1 on issues
+```
+
+## AI Provider Configuration
+
+The `suggest` command requires an AI provider. Configure one:
+
+**OpenAI:**
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+**Anthropic:**
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+npm install @anthropic-ai/sdk  # Required for Anthropic
+```
+
+**OpenAI-compatible APIs (Groq, Together, etc.):**
+```bash
+export OPENAI_API_KEY=your_key
+export OPENAI_BASE_URL=https://api.groq.com/openai
+export WMCP_MODEL=llama-3.3-70b-versatile
+```
+
+**Ollama (local, free):**
+```bash
+export OLLAMA_HOST=http://localhost:11434
+export WMCP_MODEL=llama3
+```
+
+## Browser Mode (for SPAs)
+
+By default, `wmcp-annotate` uses fast HTML parsing which works for 80%+ of websites.
+
+For JavaScript-heavy single-page apps (React, Vue, Angular), use `--browser` mode:
+
+```bash
+# One-time setup
+npm install playwright
+npx playwright install chromium
+
+# Scan with browser engine
+wmcp-annotate scan https://react-app.com --browser
+```
+
+## Example Output
+
+Generated code is fully compliant with the [WebMCP spec](https://webmachinelearning.github.io/webmcp/):
+
+```typescript
+navigator.modelContext.registerTool({
+  name: "searchProducts",
+  description: "Search the product catalog by keyword",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search terms" }
+    },
+    required: ["query"]
+  },
+  annotations: { readOnlyHint: true },
+  async execute({ query }, client) {
+    const form = document.querySelector('#search-form');
+    form.querySelector('input[name="q"]').value = query;
+    form.submit();
+    return {
+      content: [{ type: "text", text: JSON.stringify({ success: true }) }]
+    };
+  }
+});
+```
+
+## Why Open Source?
+
+WebMCP adoption benefits everyone building AI agents. Gatekeeping the tooling slows the ecosystem.
+
+This tool is MIT licensed. Fork it. Ship it. Make it better.
+
+## Author
+
+**Satyan Avatara**  
+📧 rsatyan@gmail.com
+
+Building at the intersection of AI, web infrastructure, and financial services.
+
+## License
+
+MIT — use it, fork it, ship it.

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,aAAa,CAAC;AAQlE,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCtG"}

package/dist/commands/generate.js

@@ -0,0 +1,47 @@
+import { generator } from '../lib/generator.js';
+import { analyzer } from '../lib/analyzer.js';
+import { scanner } from '../lib/scanner.js';
+import { readInput } from '../lib/output.js';
+import ora from 'ora';
+import chalk from 'chalk';
+export async function generateCommand(url, options) {
+    const spinner = ora('Generating...').start();
+    try {
+        // Get suggestions (from file or live analysis)
+        let suggestions;
+        if (options.suggestFile) {
+            spinner.text = 'Loading suggestions file...';
+            suggestions = await readInput(options.suggestFile);
+        }
+        else if (url) {
+            const mode = options.browser ? 'browser' : 'static HTML';
+            spinner.text = `Scanning ${url} (${mode})...`;
+            const scanResult = await scanner.scan(url, { depth: 1, browser: options.browser });
+            spinner.text = 'Generating tool suggestions...';
+            suggestions = await analyzer.suggest(scanResult);
+        }
+        else {
+            throw new Error('Either URL or --suggest-file is required');
+        }
+        spinner.text = `Generating ${options.format.toUpperCase()} code...`;
+        const code = await generator.generate(suggestions, {
+            format: options.format,
+            module: options.module,
+        });
+        spinner.succeed(`Generated code for ${suggestions.tools.length} tools`);
+        if (options.output) {
+            const fs = await import('fs/promises');
+            await fs.writeFile(options.output, code, 'utf-8');
+            console.log(chalk.green(`\\nSaved to ${options.output}`));
+        }
+        else {
+            console.log('\\n' + code);
+        }
+    }
+    catch (error) {
+        spinner.fail('Generation failed');
+        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAe,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAuB,EAAE,OAAwB;IACrF,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC;IAE7C,IAAI,CAAC;QACH,+CAA+C;QAC/C,IAAI,WAA0B,CAAC;QAC/B,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,GAAG,6BAA6B,CAAC;YAC7C,WAAW,GAAG,MAAM,SAAS,CAAgB,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;YACzD,OAAO,CAAC,IAAI,GAAG,YAAY,GAAG,KAAK,IAAI,MAAM,CAAC;YAC9C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnF,OAAO,CAAC,IAAI,GAAG,gCAAgC,CAAC;YAChD,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,CAAC,IAAI,GAAG,cAAc,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE;YACjD,MAAM,EAAE,OAAO,CAAC,MAAuC;YACvD,MAAM,EAAE,OAAO,CAAC,MAAuB;SACxC,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,sBAAsB,WAAW,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAExE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAM3D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlF"}

package/dist/commands/scan.js

@@ -0,0 +1,29 @@
+import { scanner } from '../lib/scanner.js';
+import { writeOutput } from '../lib/output.js';
+import ora from 'ora';
+import chalk from 'chalk';
+export async function scanCommand(url, options) {
+    const mode = options.browser ? 'browser' : 'static HTML';
+    const spinner = ora(`Scanning ${url} (${mode})...`).start();
+    try {
+        const result = await scanner.scan(url, {
+            depth: parseInt(options.depth, 10),
+            verbose: options.verbose,
+            browser: options.browser,
+        });
+        spinner.succeed(`Found ${result.elements.length} elements${result.apiCalls.length ? ` and ${result.apiCalls.length} API calls` : ''}`);
+        await writeOutput(result, options);
+        if (!options.output) {
+            console.log(chalk.dim('\nUse --output to save results to a file'));
+        }
+        if (!options.browser && result.elements.length === 0) {
+            console.log(chalk.yellow('\nTip: If this site uses JavaScript rendering, try: --browser'));
+        }
+    }
+    catch (error) {
+        spinner.fail('Scan failed');
+        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,OAAoB;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YACrC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEvI,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+DAA+D,CAAC,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/commands/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC;AAO7E,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpG"}

package/dist/commands/suggest.js

@@ -0,0 +1,37 @@
+import { analyzer } from '../lib/analyzer.js';
+import { scanner } from '../lib/scanner.js';
+import { writeOutput, readInput } from '../lib/output.js';
+import ora from 'ora';
+import chalk from 'chalk';
+export async function suggestCommand(url, options) {
+    const spinner = ora('Analyzing...').start();
+    try {
+        // Get scan results (from file or live scan)
+        let scanResult;
+        if (options.scanFile) {
+            spinner.text = 'Loading scan file...';
+            scanResult = await readInput(options.scanFile);
+        }
+        else if (url) {
+            const mode = options.browser ? 'browser' : 'static HTML';
+            spinner.text = `Scanning ${url} (${mode})...`;
+            scanResult = await scanner.scan(url, { depth: 1, browser: options.browser });
+        }
+        else {
+            throw new Error('Either URL or --scan-file is required');
+        }
+        spinner.text = 'Generating tool suggestions with AI...';
+        const result = await analyzer.suggest(scanResult);
+        spinner.succeed(`Generated ${result.tools.length} tool suggestions`);
+        await writeOutput(result, options);
+        if (!options.output) {
+            console.log(chalk.dim('\\nUse --output to save results to a file'));
+        }
+    }
+    catch (error) {
+        spinner.fail('Suggestion failed');
+        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=suggest.js.map

package/dist/commands/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../src/commands/suggest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAuB,EAAE,OAAuB;IACnF,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;IAE5C,IAAI,CAAC;QACH,4CAA4C;QAC5C,IAAI,UAAsB,CAAC;QAC3B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,GAAG,sBAAsB,CAAC;YACtC,UAAU,GAAG,MAAM,SAAS,CAAa,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;YACzD,OAAO,CAAC,IAAI,GAAG,YAAY,GAAG,KAAK,IAAI,MAAM,CAAC;YAC9C,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,CAAC,IAAI,GAAG,wCAAwC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAElD,OAAO,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,MAAM,mBAAmB,CAAC,CAAC;QAErE,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAMrE,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC1F"}

package/dist/commands/validate.js

@@ -0,0 +1,39 @@
+import { validator } from '../lib/validator.js';
+import { writeOutput } from '../lib/output.js';
+import ora from 'ora';
+import chalk from 'chalk';
+export async function validateCommand(url, options) {
+    const spinner = ora(`Validating ${url}...`).start();
+    try {
+        const result = await validator.validate(url);
+        const { summary } = result;
+        if (summary.errors > 0) {
+            spinner.fail(`Validation failed: ${summary.errors} errors, ${summary.warnings} warnings`);
+        }
+        else if (summary.warnings > 0) {
+            spinner.warn(`Validation passed with ${summary.warnings} warnings`);
+        }
+        else {
+            spinner.succeed(`Validation passed: ${summary.total} tools validated`);
+        }
+        await writeOutput(result, options);
+        // Handle CI mode
+        if (options.ci) {
+            if (summary.errors > 0 || (options.strict && summary.warnings > 0)) {
+                process.exit(1);
+            }
+        }
+        // Print summary
+        console.log('\\n' + chalk.bold('Summary:'));
+        console.log(`  Total tools: ${summary.total}`);
+        console.log(`  Valid: ${chalk.green(summary.valid)}`);
+        console.log(`  Warnings: ${chalk.yellow(summary.warnings)}`);
+        console.log(`  Errors: ${chalk.red(summary.errors)}`);
+    }
+    catch (error) {
+        spinner.fail('Validation failed');
+        console.error(chalk.red(error instanceof Error ? error.message : 'Unknown error'));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,OAAwB;IACzE,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAE7C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,MAAM,YAAY,OAAO,CAAC,QAAQ,WAAW,CAAC,CAAC;QAC5F,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,QAAQ,WAAW,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,sBAAsB,OAAO,CAAC,KAAK,kBAAkB,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnC,iBAAiB;QACjB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAExD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { scanCommand } from './commands/scan.js';
+import { suggestCommand } from './commands/suggest.js';
+import { generateCommand } from './commands/generate.js';
+import { validateCommand } from './commands/validate.js';
+const program = new Command();
+program
+    .name('wmcp-annotate')
+    .description('Make any website AI-agent ready with WebMCP annotations')
+    .version('1.0.3');
+program
+    .command('scan <url>')
+    .description('Analyze a website for WebMCP opportunities')
+    .option('-d, --depth <number>', 'How many pages deep to crawl', '1')
+    .option('-o, --output <file>', 'Output file')
+    .option('-f, --format <format>', 'Output format: json, table, markdown', 'json')
+    .option('-b, --browser', 'Use browser engine for JavaScript-heavy sites (requires Playwright)')
+    .option('-v, --verbose', 'Show detailed progress')
+    .action(scanCommand);
+program
+    .command('suggest [url]')
+    .description('Generate AI-powered WebMCP tool suggestions')
+    .option('-s, --scan-file <file>', 'Use existing scan output')
+    .option('-o, --output <file>', 'Output file')
+    .option('-f, --format <format>', 'Output format: json, yaml', 'json')
+    .option('-b, --browser', 'Use browser engine for JavaScript-heavy sites (requires Playwright)')
+    .action(suggestCommand);
+program
+    .command('generate [url]')
+    .description('Generate WebMCP registration code')
+    .option('-s, --suggest-file <file>', 'Use existing suggestions')
+    .option('-o, --output <file>', 'Output file')
+    .option('-f, --format <format>', 'Output format: js, ts, react, vue', 'js')
+    .option('-m, --module <type>', 'Module format: esm, cjs', 'esm')
+    .option('-b, --browser', 'Use browser engine for JavaScript-heavy sites (requires Playwright)')
+    .action(generateCommand);
+program
+    .command('validate <url>')
+    .description('Validate WebMCP implementation')
+    .option('-o, --output <file>', 'Output file')
+    .option('-f, --format <format>', 'Output format: json, table, markdown', 'json')
+    .option('--strict', 'Fail on warnings')
+    .option('--ci', 'Exit code 1 on any issues')
+    .action(validateCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,sBAAsB,EAAE,8BAA8B,EAAE,GAAG,CAAC;KACnE,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,EAAE,MAAM,CAAC;KAC/E,MAAM,CAAC,eAAe,EAAE,qEAAqE,CAAC;KAC9F,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,CAAC;KAC5D,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KACpE,MAAM,CAAC,eAAe,EAAE,qEAAqE,CAAC;KAC9F,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,2BAA2B,EAAE,0BAA0B,CAAC;KAC/D,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,uBAAuB,EAAE,mCAAmC,EAAE,IAAI,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,EAAE,KAAK,CAAC;KAC/D,MAAM,CAAC,eAAe,EAAE,qEAAqE,CAAC;KAC9F,MAAM,CAAC,eAAe,CAAC,CAAC;AAE3B,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,EAAE,MAAM,CAAC;KAC/E,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC;KACtC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC;KAC3C,MAAM,CAAC,eAAe,CAAC,CAAC;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/lib/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAW7E,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,SAAS;IA2CX,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;YAkB/C,cAAc;YAqDd,MAAM;YAaN,aAAa;YA0Bb,UAAU;YAyBV,UAAU;CAoBzB;AAED,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/lib/analyzer.js

@@ -0,0 +1,177 @@
+class Analyzer {
+    config = null;
+    getConfig() {
+        if (this.config)
+            return this.config;
+        // Check for Anthropic
+        if (process.env.ANTHROPIC_API_KEY) {
+            this.config = {
+                provider: 'anthropic',
+                apiKey: process.env.ANTHROPIC_API_KEY,
+                model: process.env.WMCP_MODEL || 'claude-sonnet-4-20250514',
+            };
+            return this.config;
+        }
+        // Check for OpenAI
+        if (process.env.OPENAI_API_KEY) {
+            this.config = {
+                provider: 'openai',
+                apiKey: process.env.OPENAI_API_KEY,
+                model: process.env.WMCP_MODEL || 'gpt-4o',
+                baseUrl: process.env.OPENAI_BASE_URL,
+            };
+            return this.config;
+        }
+        // Check for Ollama (local)
+        if (process.env.OLLAMA_HOST || process.env.WMCP_OLLAMA) {
+            this.config = {
+                provider: 'ollama',
+                model: process.env.WMCP_MODEL || 'llama3',
+                baseUrl: process.env.OLLAMA_HOST || 'http://localhost:11434',
+            };
+            return this.config;
+        }
+        throw new Error('No AI provider configured. Set one of:\n' +
+            '  - ANTHROPIC_API_KEY (for Claude)\n' +
+            '  - OPENAI_API_KEY (for GPT-4, or any OpenAI-compatible API)\n' +
+            '  - OLLAMA_HOST (for local Ollama)\n' +
+            '\nOptionally set WMCP_MODEL to specify the model.');
+    }
+    async suggest(scanResult) {
+        const tools = [];
+        for (const element of scanResult.elements) {
+            const suggestion = await this.analyzeElement(element);
+            if (suggestion) {
+                tools.push(suggestion);
+            }
+        }
+        return {
+            version: '1.0.0',
+            url: scanResult.url,
+            suggestedAt: new Date().toISOString(),
+            tools,
+        };
+    }
+    async analyzeElement(element) {
+        const config = this.getConfig();
+        const prompt = `Analyze this website element and generate a WebMCP tool definition.
+
+Element:
+- Type: ${element.type}
+- Label: ${element.label}
+- Selector: ${element.selector}
+${element.inputs ? `- Inputs: ${JSON.stringify(element.inputs)}` : ''}
+
+Generate a WebMCP tool definition with:
+1. name: camelCase, action-oriented verb (e.g., searchProducts, addToCart)
+2. description: 1-2 sentences explaining what it does
+3. readOnly: true if it's a search/view action, false for create/update/delete
+4. inputSchema: JSON Schema for the inputs
+
+Respond with valid JSON only:
+{
+  "name": "...",
+  "description": "...",
+  "readOnly": true/false,
+  "inputSchema": { ... }
+}`;
+        try {
+            const responseText = await this.callAI(config, prompt);
+            // Extract JSON from response (handle markdown code blocks)
+            let jsonStr = responseText;
+            const jsonMatch = responseText.match(/```(?:json)?\s*([\s\S]*?)```/);
+            if (jsonMatch) {
+                jsonStr = jsonMatch[1];
+            }
+            const json = JSON.parse(jsonStr.trim());
+            return {
+                name: json.name,
+                description: json.description,
+                readOnly: json.readOnly,
+                inputSchema: json.inputSchema,
+                sourceElement: {
+                    type: element.type,
+                    selector: element.selector,
+                },
+            };
+        }
+        catch (error) {
+            console.error('Analysis failed for element:', element.selector, error);
+            return null;
+        }
+    }
+    async callAI(config, prompt) {
+        switch (config.provider) {
+            case 'anthropic':
+                return this.callAnthropic(config, prompt);
+            case 'openai':
+                return this.callOpenAI(config, prompt);
+            case 'ollama':
+                return this.callOllama(config, prompt);
+            default:
+                throw new Error(`Unknown provider: ${config.provider}`);
+        }
+    }
+    async callAnthropic(config, prompt) {
+        // Dynamic import to avoid requiring the SDK if not using Anthropic
+        let Anthropic;
+        try {
+            const module = await import('@anthropic-ai/sdk');
+            Anthropic = module.default;
+        }
+        catch {
+            throw new Error('Anthropic SDK not installed. Install it with:\n' +
+                '  npm install @anthropic-ai/sdk');
+        }
+        const client = new Anthropic({ apiKey: config.apiKey });
+        const response = await client.messages.create({
+            model: config.model,
+            max_tokens: 1024,
+            messages: [{ role: 'user', content: prompt }],
+        });
+        const content = response.content[0];
+        if (content.type !== 'text')
+            throw new Error('Unexpected response type');
+        return content.text;
+    }
+    async callOpenAI(config, prompt) {
+        const url = `${config.baseUrl || 'https://api.openai.com'}/v1/chat/completions`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: config.model,
+                messages: [{ role: 'user', content: prompt }],
+                max_tokens: 1024,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${response.status} ${error}`);
+        }
+        const data = await response.json();
+        return data.choices[0].message.content;
+    }
+    async callOllama(config, prompt) {
+        const url = `${config.baseUrl}/api/generate`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: config.model,
+                prompt: prompt,
+                stream: false,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Ollama API error: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data.response;
+    }
+}
+export const analyzer = new Analyzer();
+//# sourceMappingURL=analyzer.js.map