@webmcp-bridge/local-mcp 0.1.0

package/dist/runtime.js

@@ -0,0 +1,154 @@
+/**
+ * This module boots a Playwright page and WebMCP gateway for one target site session.
+ * It depends on resolved site definitions and Playwright gateway APIs so local-mcp can proxy browser-side tool execution.
+ */
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createWebMcpPageGateway, } from "@webmcp-bridge/playwright";
+import { chromium, firefox, webkit, } from "playwright";
+function normalizeHost(value) {
+    return value.trim().toLowerCase();
+}
+function matchesHostPattern(host, pattern) {
+    const normalizedHost = normalizeHost(host);
+    const normalizedPattern = normalizeHost(pattern);
+    if (!normalizedPattern) {
+        return false;
+    }
+    if (normalizedPattern.startsWith("*.")) {
+        const suffix = normalizedPattern.slice(2);
+        if (!suffix) {
+            return false;
+        }
+        if (normalizedHost === suffix) {
+            return false;
+        }
+        return normalizedHost.endsWith(`.${suffix}`);
+    }
+    return normalizedHost === normalizedPattern;
+}
+export function isUrlAllowed(url, hostPatterns) {
+    let target;
+    try {
+        target = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (target.protocol === "about:") {
+        return target.href === "about:blank" && hostPatterns.includes("about:blank");
+    }
+    if (target.protocol !== "https:" && target.protocol !== "http:") {
+        return false;
+    }
+    return hostPatterns.some((pattern) => matchesHostPattern(target.hostname, pattern));
+}
+export function resolveTargetUrl(urlOverride, defaultUrl) {
+    const targetUrl = (urlOverride && urlOverride.trim()) || (defaultUrl && defaultUrl.trim()) || "";
+    if (!targetUrl) {
+        throw new Error("CONFIG_ERROR: no target url provided (missing --url and manifest.defaultUrl)");
+    }
+    return targetUrl;
+}
+function resolveBrowserType(browser) {
+    if (browser === "firefox") {
+        return firefox;
+    }
+    if (browser === "webkit") {
+        return webkit;
+    }
+    return chromium;
+}
+async function waitForPolyfillTools(pageGateway, timeoutMs = 5000, intervalMs = 200) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const tools = await pageGateway.listTools();
+        if (tools.length > 0) {
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+}
+export async function startLocalMcpRuntime(options) {
+    const site = options.siteDefinition;
+    const browserEngine = options.browser ?? "chromium";
+    const headless = options.headless ?? false;
+    const browserType = resolveBrowserType(browserEngine);
+    const targetUrl = resolveTargetUrl(options.url, site.manifest.defaultUrl);
+    if (!isUrlAllowed(targetUrl, site.manifest.hostPatterns)) {
+        throw new Error("URL_NOT_ALLOWED: target url host is not allowed by adapter hostPatterns");
+    }
+    let profileDirFromTemp = false;
+    const userDataDir = options.userDataDir ?? (await mkdtemp(join(tmpdir(), "webmcp-local-mcp-")));
+    if (!options.userDataDir) {
+        profileDirFromTemp = true;
+    }
+    let context;
+    let gatewaySession;
+    const cleanup = async () => {
+        await gatewaySession?.close().catch(() => {
+            // Cleanup should be best-effort when process is terminating.
+        });
+        await context?.close().catch(() => {
+            // Cleanup should be best-effort when process is terminating.
+        });
+        if (profileDirFromTemp) {
+            await rm(userDataDir, { recursive: true, force: true }).catch(() => {
+                // Cleanup should be best-effort when process is terminating.
+            });
+        }
+    };
+    try {
+        context = await browserType.launchPersistentContext(userDataDir, {
+            headless,
+        });
+        const page = context.pages()[0] ?? (await context.newPage());
+        await page.goto(targetUrl, { waitUntil: "domcontentloaded" });
+        const gatewayOptions = {
+            preferNative: options.preferNative ?? true,
+        };
+        const fallbackAdapterFactory = site.createFallbackAdapter;
+        if (fallbackAdapterFactory) {
+            gatewayOptions.fallbackAdapter = fallbackAdapterFactory();
+        }
+        gatewaySession = await createWebMcpPageGateway(page, gatewayOptions);
+        const pageGateway = gatewaySession;
+        if (pageGateway.mode === "polyfill") {
+            // Ensure page scripts run after modelContext polyfill injection so site tools can register.
+            await page.reload({ waitUntil: "domcontentloaded" });
+            await waitForPolyfillTools(pageGateway);
+        }
+        let closed = false;
+        const close = async () => {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            await cleanup();
+        };
+        const gateway = {
+            listTools: async () => {
+                return await pageGateway.listTools();
+            },
+            callTool: async (name, input) => {
+                return await pageGateway.callTool(name, input);
+            },
+        };
+        return {
+            site: site.id,
+            siteDefinition: site,
+            targetUrl,
+            mode: gatewaySession.mode,
+            headless,
+            page,
+            gateway,
+            close,
+        };
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,24 @@
+/**
+ * This module implements an MCP stdio JSON-RPC server that proxies tool calls to a page WebMCP gateway.
+ * It depends on the modelcontextprotocol/sdk server and stdio transport so MCP framing and lifecycle are handled by the official implementation.
+ */
+import type { JsonValue } from "@webmcp-bridge/core";
+import type { WebMcpToolDefinition } from "@webmcp-bridge/playwright";
+import type { Readable, Writable } from "node:stream";
+export type LocalMcpGateway = {
+    listTools: () => Promise<ReadonlyArray<WebMcpToolDefinition>>;
+    callTool: (name: string, input: Record<string, unknown>) => Promise<JsonValue>;
+};
+export type LocalMcpStdioServerOptions = {
+    gateway: LocalMcpGateway;
+    serviceVersion: string;
+    input?: Readable;
+    output?: Writable;
+    onError?: (error: unknown) => void;
+};
+export type LocalMcpStdioServer = {
+    start: () => Promise<void>;
+    close: () => Promise<void>;
+};
+export declare function createLocalMcpStdioServer(options: LocalMcpStdioServerOptions): LocalMcpStdioServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAChF,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AA2MF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAElG"}

package/dist/server.js

@@ -0,0 +1,189 @@
+/**
+ * This module implements an MCP stdio JSON-RPC server that proxies tool calls to a page WebMCP gateway.
+ * It depends on the modelcontextprotocol/sdk server and stdio transport so MCP framing and lifecycle are handled by the official implementation.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+class LocalMcpStdioServerImpl {
+    server;
+    transport;
+    started = false;
+    closed = false;
+    lastToolsSignature;
+    constructor(options) {
+        this.transport = new StdioServerTransport(options.input, options.output);
+        this.transport.onerror = (error) => {
+            options.onError?.(error);
+        };
+        this.server = new Server({
+            name: "webmcp-bridge-local-mcp",
+            version: options.serviceVersion,
+        }, {
+            capabilities: {
+                tools: {
+                    listChanged: true,
+                },
+            },
+        });
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = await options.gateway.listTools();
+            this.lastToolsSignature = this.computeToolsSignature(tools);
+            return {
+                tools: tools.map((tool) => this.toMcpToolDefinition(tool)),
+            };
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const previousSignature = await this.ensureToolsSignature(options.gateway);
+            const args = this.normalizeToolArguments(request.params.arguments);
+            const toolResult = await options.gateway.callTool(request.params.name, args);
+            await this.notifyIfToolsChanged(options.gateway, previousSignature);
+            return this.toCallToolResult(toolResult);
+        });
+    }
+    async start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        await this.server.connect(this.transport);
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.server.close();
+    }
+    toMcpToolDefinition(tool) {
+        const definition = {
+            name: tool.name,
+        };
+        if (tool.description !== undefined) {
+            definition.description = tool.description;
+        }
+        if (tool.inputSchema !== undefined) {
+            definition.inputSchema = tool.inputSchema;
+        }
+        if (tool.annotations !== undefined) {
+            definition.annotations = tool.annotations;
+        }
+        return definition;
+    }
+    normalizeToolArguments(value) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            return value;
+        }
+        return {};
+    }
+    toStructuredContent(value) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            return value;
+        }
+        return {
+            value,
+        };
+    }
+    toCallToolResult(value) {
+        if (this.isCallToolResultPayload(value)) {
+            return value;
+        }
+        const result = {
+            content: [],
+            structuredContent: this.toStructuredContent(value),
+        };
+        if (this.isErrorPayload(value)) {
+            result.isError = true;
+        }
+        return result;
+    }
+    isRecord(value) {
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
+    isContentArray(value) {
+        if (!Array.isArray(value)) {
+            return false;
+        }
+        return value.every((item) => this.isRecord(item) && typeof item.type === "string");
+    }
+    isCallToolResultPayload(value) {
+        if (!this.isRecord(value)) {
+            return false;
+        }
+        let hasKnownField = false;
+        if ("content" in value) {
+            hasKnownField = true;
+            if (!this.isContentArray(value.content)) {
+                return false;
+            }
+        }
+        if ("structuredContent" in value) {
+            hasKnownField = true;
+            if (!this.isRecord(value.structuredContent)) {
+                return false;
+            }
+        }
+        if ("isError" in value) {
+            hasKnownField = true;
+            if (typeof value.isError !== "boolean") {
+                return false;
+            }
+        }
+        return hasKnownField;
+    }
+    isErrorPayload(value) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            return false;
+        }
+        return "error" in value;
+    }
+    async ensureToolsSignature(gateway) {
+        if (this.lastToolsSignature !== undefined) {
+            return this.lastToolsSignature;
+        }
+        const tools = await gateway.listTools();
+        const signature = this.computeToolsSignature(tools);
+        this.lastToolsSignature = signature;
+        return signature;
+    }
+    async notifyIfToolsChanged(gateway, previousSignature) {
+        const tools = await gateway.listTools();
+        const nextSignature = this.computeToolsSignature(tools);
+        this.lastToolsSignature = nextSignature;
+        if (nextSignature === previousSignature) {
+            return;
+        }
+        await this.server.sendToolListChanged().catch(() => {
+            // Ignore when client does not advertise listChanged support or session is not notification-ready.
+        });
+    }
+    computeToolsSignature(tools) {
+        const normalized = tools
+            .map((tool) => ({
+            annotations: this.normalizeForSignature(tool.annotations ?? {}),
+            description: tool.description ?? "",
+            inputSchema: this.normalizeForSignature(tool.inputSchema ?? { type: "object" }),
+            name: tool.name,
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        return JSON.stringify(normalized);
+    }
+    normalizeForSignature(value) {
+        if (Array.isArray(value)) {
+            return value.map((item) => this.normalizeForSignature(item));
+        }
+        if (typeof value === "object" && value !== null) {
+            const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+            const output = {};
+            for (const [key, item] of entries) {
+                output[key] = this.normalizeForSignature(item);
+            }
+            return output;
+        }
+        return value;
+    }
+}
+export function createLocalMcpStdioServer(options) {
+    return new LocalMcpStdioServerImpl(options);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/sites.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This module defines built-in site presets and external adapter-module loading.
+ * It depends on adapter packages and adapter contracts so runtime startup can resolve one fallback adapter source per process.
+ */
+import type { AdapterManifest, SiteAdapter } from "@webmcp-bridge/playwright";
+export type BuiltinSite = "x" | "fixture";
+export type SiteDefinition = {
+    id: string;
+    source: "builtin" | "external" | "native";
+    manifest: AdapterManifest;
+    createFallbackAdapter?: () => SiteAdapter;
+    adapterModule?: string;
+};
+export type ResolveSiteSourceOptions = {
+    site?: string;
+    adapterModule?: string;
+    moduleBaseDir?: string;
+};
+export declare function resolveSiteDefinition(site: string): SiteDefinition;
+export declare function createNativeSiteDefinition(url: string): SiteDefinition;
+export declare function resolveSiteSource(options: ResolveSiteSourceOptions): Promise<SiteDefinition>;
+//# sourceMappingURL=sites.d.ts.map

package/dist/sites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../src/sites.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,SAAS,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,QAAQ,EAAE,eAAe,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,WAAW,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAuIF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAKlE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAwCtE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiBlG"}

package/dist/sites.js

@@ -0,0 +1,188 @@
+/**
+ * This module defines built-in site presets and external adapter-module loading.
+ * It depends on adapter packages and adapter contracts so runtime startup can resolve one fallback adapter source per process.
+ */
+import { pathToFileURL } from "node:url";
+import { resolve } from "node:path";
+import { createAdapter as createFixtureAdapter, manifest as fixtureManifest, } from "@webmcp-bridge/adapter-fixture";
+import { createAdapter as createXAdapter, manifest as xManifest, } from "@webmcp-bridge/adapter-x";
+const BUILTIN_SITE_DEFINITIONS = {
+    x: {
+        id: "x",
+        source: "builtin",
+        manifest: xManifest,
+        createFallbackAdapter: () => createXAdapter(),
+    },
+    fixture: {
+        id: "fixture",
+        source: "builtin",
+        manifest: fixtureManifest,
+        createFallbackAdapter: () => createFixtureAdapter(),
+    },
+};
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function validateManifest(value) {
+    if (!isRecord(value)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: adapter manifest must be an object");
+    }
+    const id = value.id;
+    const displayName = value.displayName;
+    const version = value.version;
+    const bridgeApiVersion = value.bridgeApiVersion;
+    const defaultUrl = value.defaultUrl;
+    const hostPatterns = value.hostPatterns;
+    const authProbeTool = value.authProbeTool;
+    if (!isNonEmptyString(id)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.id must be a non-empty string");
+    }
+    if (!isNonEmptyString(displayName)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.displayName must be a non-empty string");
+    }
+    if (!isNonEmptyString(version)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.version must be a non-empty string");
+    }
+    if (!isNonEmptyString(bridgeApiVersion)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.bridgeApiVersion must be a non-empty string");
+    }
+    if (defaultUrl !== undefined && !isNonEmptyString(defaultUrl)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.defaultUrl must be a non-empty string when provided");
+    }
+    if (!Array.isArray(hostPatterns) || hostPatterns.length === 0) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.hostPatterns must be a non-empty string array");
+    }
+    if (!hostPatterns.every((item) => isNonEmptyString(item))) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.hostPatterns must contain non-empty strings");
+    }
+    if (authProbeTool !== undefined && !isNonEmptyString(authProbeTool)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: manifest.authProbeTool must be a non-empty string when provided");
+    }
+    const output = {
+        id,
+        displayName,
+        version,
+        bridgeApiVersion,
+        hostPatterns,
+    };
+    if (defaultUrl !== undefined) {
+        output.defaultUrl = defaultUrl;
+    }
+    if (authProbeTool !== undefined) {
+        output.authProbeTool = authProbeTool;
+    }
+    return output;
+}
+function validateSiteAdapterModule(value) {
+    if (!isRecord(value)) {
+        throw new Error("ADAPTER_CONTRACT_ERROR: adapter module must export an object");
+    }
+    const root = isRecord(value.default) ? value.default : value;
+    const createAdapter = root.createAdapter;
+    if (typeof createAdapter !== "function") {
+        throw new Error("ADAPTER_CONTRACT_ERROR: adapter module must export createAdapter()");
+    }
+    return {
+        manifest: validateManifest(root.manifest),
+        createAdapter: createAdapter,
+    };
+}
+function resolveAdapterModuleSpecifier(specifier, baseDir) {
+    const trimmed = specifier.trim();
+    if (!trimmed) {
+        throw new Error("ADAPTER_LOAD_ERROR: adapter module specifier is empty");
+    }
+    if (trimmed.startsWith("file:")) {
+        return trimmed;
+    }
+    if (trimmed.startsWith(".") || trimmed.startsWith("/") || trimmed.startsWith("..")) {
+        const absolutePath = resolve(baseDir, trimmed);
+        return pathToFileURL(absolutePath).href;
+    }
+    return trimmed;
+}
+async function resolveExternalSiteDefinition(adapterModule, moduleBaseDir) {
+    const specifier = resolveAdapterModuleSpecifier(adapterModule, moduleBaseDir);
+    let loaded;
+    try {
+        loaded = await import(specifier);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`ADAPTER_LOAD_ERROR: failed to import adapter module (${adapterModule}): ${message}`);
+    }
+    const adapterModuleExports = validateSiteAdapterModule(loaded);
+    return {
+        id: adapterModuleExports.manifest.id,
+        source: "external",
+        manifest: adapterModuleExports.manifest,
+        createFallbackAdapter: adapterModuleExports.createAdapter,
+        adapterModule,
+    };
+}
+export function resolveSiteDefinition(site) {
+    if (site in BUILTIN_SITE_DEFINITIONS) {
+        return BUILTIN_SITE_DEFINITIONS[site];
+    }
+    throw new Error(`unsupported site: ${site}`);
+}
+export function createNativeSiteDefinition(url) {
+    const trimmedUrl = url.trim();
+    if (!trimmedUrl) {
+        throw new Error("CONFIG_ERROR: --url is required when --site/--adapter-module is not provided");
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmedUrl);
+    }
+    catch {
+        throw new Error("CONFIG_ERROR: --url must be a valid absolute URL");
+    }
+    let hostPatterns;
+    let id;
+    if (parsed.protocol === "about:") {
+        if (parsed.href !== "about:blank") {
+            throw new Error("CONFIG_ERROR: url mode supports about:blank only for about: URLs");
+        }
+        hostPatterns = ["about:blank"];
+        id = "native:about-blank";
+    }
+    else if (parsed.protocol === "https:" || parsed.protocol === "http:") {
+        hostPatterns = [parsed.hostname];
+        id = `native:${parsed.hostname}`;
+    }
+    else {
+        throw new Error("CONFIG_ERROR: --url must use http:, https:, or about:blank");
+    }
+    return {
+        id,
+        source: "native",
+        manifest: {
+            id,
+            displayName: "Native WebMCP Site",
+            version: "0.1.0",
+            bridgeApiVersion: "1.0.0",
+            defaultUrl: parsed.href,
+            hostPatterns,
+        },
+    };
+}
+export async function resolveSiteSource(options) {
+    const site = options.site?.trim();
+    const adapterModule = options.adapterModule?.trim();
+    if (site && adapterModule) {
+        throw new Error("CONFIG_ERROR: use either --site or --adapter-module, not both");
+    }
+    if (!site && !adapterModule) {
+        throw new Error("CONFIG_ERROR: one of --site or --adapter-module is required");
+    }
+    if (site) {
+        return resolveSiteDefinition(site);
+    }
+    const moduleBaseDir = options.moduleBaseDir ?? process.cwd();
+    return await resolveExternalSiteDefinition(adapterModule, moduleBaseDir);
+}
+//# sourceMappingURL=sites.js.map

package/dist/sites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites.js","sourceRoot":"","sources":["../src/sites.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,aAAa,IAAI,oBAAoB,EACrC,QAAQ,IAAI,eAAe,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,aAAa,IAAI,cAAc,EAC/B,QAAQ,IAAI,SAAS,GACtB,MAAM,0BAA0B,CAAC;AAuBlC,MAAM,wBAAwB,GAAwC;IACpE,CAAC,EAAE;QACD,EAAE,EAAE,GAAG;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,SAAS;QACnB,qBAAqB,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;KAC9C;IACD,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,eAAe;QACzB,qBAAqB,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE;KACpD;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IACpB,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IAE1C,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,EAAE;QACF,WAAW;QACX,OAAO;QACP,gBAAgB;QAChB,YAAY;KACb,CAAC;IACF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACzC,aAAa,EAAE,aAAmD;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,SAAiB,EAAE,OAAe;IACvE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,aAAqB,EACrB,aAAqB;IAErB,MAAM,SAAS,GAAG,6BAA6B,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAE9E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,wDAAwD,aAAa,MAAM,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO;QACL,EAAE,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EAAE;QACpC,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,oBAAoB,CAAC,QAAQ;QACvC,qBAAqB,EAAE,oBAAoB,CAAC,aAAa;QACzD,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,IAAI,IAAI,wBAAwB,EAAE,CAAC;QACrC,OAAO,wBAAwB,CAAC,IAAmB,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,YAAsB,CAAC;IAC3B,IAAI,EAAU,CAAC;IACf,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,YAAY,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/B,EAAE,GAAG,oBAAoB,CAAC;IAC5B,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACvE,YAAY,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,EAAE,GAAG,UAAU,MAAM,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,EAAE;QACF,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE;YACR,EAAE;YACF,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,OAAO;YAChB,gBAAgB,EAAE,OAAO;YACzB,UAAU,EAAE,MAAM,CAAC,IAAI;YACvB,YAAY;SACb;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAiC;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAEpD,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7D,OAAO,MAAM,6BAA6B,CAAC,aAAuB,EAAE,aAAa,CAAC,CAAC;AACrF,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@webmcp-bridge/local-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "webmcp-local-mcp": "dist/cli.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "playwright": "^1.58.2",
+    "zod": "^4.3.6",
+    "@webmcp-bridge/adapter-fixture": "0.1.0",
+    "@webmcp-bridge/adapter-x": "0.1.0",
+    "@webmcp-bridge/playwright": "0.1.0",
+    "@webmcp-bridge/core": "0.1.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}