@keak/webmcp-core 0.1.0

package/dist/extractor/route-extractor.js.map

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

package/dist/extractor/schema-inferrer.d.ts

@@ -0,0 +1,4 @@
+import type { FieldSpec, JsonSchema } from "../types.js";
+export declare function schemaFromFields(fields: FieldSpec[]): JsonSchema;
+export declare function schemaFromSample(sample: unknown): JsonSchema;
+//# sourceMappingURL=schema-inferrer.d.ts.map

package/dist/extractor/schema-inferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-inferrer.d.ts","sourceRoot":"","sources":["../../src/extractor/schema-inferrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAEtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAsEhE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAyC5D"}

package/dist/extractor/schema-inferrer.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaFromFields = schemaFromFields;
+exports.schemaFromSample = schemaFromSample;
+function schemaFromFields(fields) {
+    const properties = {};
+    const required = [];
+    for (const field of fields) {
+        const prop = {};
+        switch (field.type) {
+            case "string":
+                prop.type = "string";
+                break;
+            case "number":
+                prop.type = "number";
+                if (field.min !== undefined)
+                    prop.minimum = field.min;
+                if (field.max !== undefined)
+                    prop.maximum = field.max;
+                break;
+            case "boolean":
+                prop.type = "boolean";
+                break;
+            case "enum":
+                prop.type = "string";
+                if (field.options && field.options.length > 0) {
+                    prop.enum = field.options;
+                }
+                break;
+            case "email":
+                prop.type = "string";
+                prop.format = "email";
+                break;
+            case "date":
+                prop.type = "string";
+                prop.description = "Date in YYYY-MM-DD format";
+                break;
+            case "tel":
+                prop.type = "string";
+                break;
+            case "url":
+                prop.type = "string";
+                prop.format = "uri";
+                break;
+            default:
+                prop.type = "string";
+        }
+        if (field.label) {
+            prop.description = field.label;
+        }
+        else if (field.placeholder) {
+            prop.description = field.placeholder;
+        }
+        if (field.defaultValue) {
+            prop.default = field.defaultValue;
+        }
+        if (field.pattern) {
+            prop.pattern = field.pattern;
+        }
+        properties[field.name] = prop;
+        if (field.required) {
+            required.push(field.name);
+        }
+    }
+    return {
+        type: "object",
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+    };
+}
+function schemaFromSample(sample) {
+    if (sample === null || sample === undefined) {
+        return { type: "string" };
+    }
+    if (typeof sample === "string") {
+        return detectStringFormat(sample);
+    }
+    if (typeof sample === "number") {
+        return Number.isInteger(sample)
+            ? { type: "integer" }
+            : { type: "number" };
+    }
+    if (typeof sample === "boolean") {
+        return { type: "boolean" };
+    }
+    if (Array.isArray(sample)) {
+        if (sample.length === 0) {
+            return { type: "array" };
+        }
+        return {
+            type: "array",
+            items: schemaFromSample(sample[0]),
+        };
+    }
+    if (typeof sample === "object") {
+        const properties = {};
+        for (const [key, value] of Object.entries(sample)) {
+            properties[key] = schemaFromSample(value);
+        }
+        return {
+            type: "object",
+            properties,
+        };
+    }
+    return { type: "string" };
+}
+function detectStringFormat(value) {
+    const schema = { type: "string" };
+    if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value)) {
+        schema.format = "email";
+        return schema;
+    }
+    if (/^https?:\/\//.test(value)) {
+        schema.format = "uri";
+        return schema;
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        schema.format = "date";
+        schema.description = "Date in YYYY-MM-DD format";
+        return schema;
+    }
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(value)) {
+        schema.format = "date-time";
+        return schema;
+    }
+    return schema;
+}
+//# sourceMappingURL=schema-inferrer.js.map

package/dist/extractor/schema-inferrer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+export type { JsonSchema, FieldSpec, NetworkCall, Action, FormSubmitAction, ClickFlowAction, ApiCallAction, RouteChangeAction, HandlerStep, HandlerTemplate, SafetyLevel, Safety, ToolSpec, AuthMethod, OutputTarget, OutputLang, Framework, AutogenConfig, DomSnapshot, DomForm, DomButton, DomLink, ScanResult, ScanProgressEvent, LintSeverity, LintWarning, LintResult, ExportResult, ExportFile, } from "./types.js";
+export { FieldSpecSchema, NetworkCallSchema, FormSubmitActionSchema, ClickFlowActionSchema, ApiCallActionSchema, RouteChangeActionSchema, ActionSchema, SafetySchema, ToolSpecSchema, } from "./utils/validation.js";
+export { lintTools, lintSummary } from "./linter/linter.js";
+export { redact, isSensitiveFieldName } from "./utils/redact.js";
+import type { ScanResult, ToolSpec, OutputTarget, ExportResult, ScanProgressEvent } from "./types.js";
+export interface ScanOptions {
+    /** URL to scan. */
+    url: string;
+    /** Max crawl depth (default: 2). */
+    depth?: number;
+    /** Page load timeout in ms (default: 30000). */
+    timeout?: number;
+    /** Run browser in headless mode (default: true). */
+    headless?: boolean;
+    /** Playwright browser executable path. */
+    executablePath?: string;
+    /** CSS selectors to ignore during crawling. */
+    ignoreSelectors?: string[];
+    /** Session cookie string for authenticated scanning. */
+    cookie?: string;
+    /** Progress callback fired for each page visited. */
+    onProgress?: (event: ScanProgressEvent) => void;
+}
+export interface ProposeOptions {
+    /** Minimum confidence threshold (default: 0.5). */
+    minConfidence?: number;
+    /** Use LLM for naming/descriptions (default: false). */
+    useLlm?: boolean;
+    /** LLM model identifier. */
+    llmModel?: string;
+}
+export interface ExportOptions {
+    /** Output language for snippet format. */
+    lang?: "ts" | "js";
+    /** Domain for output metadata. */
+    domain?: string;
+}
+/**
+ * Scan a website using Playwright, capturing DOM snapshots and network calls.
+ * Requires `playwright` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * const result = await scanUrl({ url: "https://example.com", depth: 2 });
+ * console.log(`Scanned ${result.metadata.pagesVisited} pages`);
+ * ```
+ */
+export declare function scanUrl(options: ScanOptions): Promise<ScanResult>;
+/**
+ * Extract actions from scan data and cluster them into tool definitions.
+ *
+ * @example
+ * ```ts
+ * const result = await scanUrl({ url: "https://example.com" });
+ * const tools = proposeTools(result, { minConfidence: 0.6 });
+ * ```
+ */
+export declare function proposeTools(scanResult: ScanResult, options?: ProposeOptions): ToolSpec[];
+/**
+ * Export tool definitions to a specific format.
+ *
+ * @example
+ * ```ts
+ * const result = exportTools(tools, "manifest", { domain: "example.com" });
+ * console.log(result.files[0].content);
+ * ```
+ */
+export declare function exportTools(tools: ToolSpec[], format: OutputTarget, options?: ExportOptions): ExportResult;
+/**
+ * Scan a URL and generate tool definitions in a single call.
+ *
+ * @example
+ * ```ts
+ * import { generateToolDefinitions } from "@keak/webmcp-core";
+ *
+ * const tools = await generateToolDefinitions("https://example.com", {
+ *   depth: 2,
+ *   headless: true,
+ *   minConfidence: 0.5,
+ * });
+ *
+ * for (const tool of tools) {
+ *   console.log(`${tool.name}: ${tool.description}`);
+ * }
+ * ```
+ */
+export declare function generateToolDefinitions(url: string, options?: Omit<ScanOptions, "url"> & ProposeOptions): Promise<ToolSpec[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,OAAO,EACP,SAAS,EACT,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,KAAK,EACV,UAAU,EAIV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA8EvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,cAAmB,GAC3B,QAAQ,EAAE,CAiBZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAed;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,cAAmB,GACtD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAIrB"}

package/dist/index.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSensitiveFieldName = exports.redact = exports.lintSummary = exports.lintTools = exports.ToolSpecSchema = exports.SafetySchema = exports.ActionSchema = exports.RouteChangeActionSchema = exports.ApiCallActionSchema = exports.ClickFlowActionSchema = exports.FormSubmitActionSchema = exports.NetworkCallSchema = exports.FieldSpecSchema = void 0;
+exports.scanUrl = scanUrl;
+exports.proposeTools = proposeTools;
+exports.exportTools = exportTools;
+exports.generateToolDefinitions = generateToolDefinitions;
+var validation_js_1 = require("./utils/validation.js");
+Object.defineProperty(exports, "FieldSpecSchema", { enumerable: true, get: function () { return validation_js_1.FieldSpecSchema; } });
+Object.defineProperty(exports, "NetworkCallSchema", { enumerable: true, get: function () { return validation_js_1.NetworkCallSchema; } });
+Object.defineProperty(exports, "FormSubmitActionSchema", { enumerable: true, get: function () { return validation_js_1.FormSubmitActionSchema; } });
+Object.defineProperty(exports, "ClickFlowActionSchema", { enumerable: true, get: function () { return validation_js_1.ClickFlowActionSchema; } });
+Object.defineProperty(exports, "ApiCallActionSchema", { enumerable: true, get: function () { return validation_js_1.ApiCallActionSchema; } });
+Object.defineProperty(exports, "RouteChangeActionSchema", { enumerable: true, get: function () { return validation_js_1.RouteChangeActionSchema; } });
+Object.defineProperty(exports, "ActionSchema", { enumerable: true, get: function () { return validation_js_1.ActionSchema; } });
+Object.defineProperty(exports, "SafetySchema", { enumerable: true, get: function () { return validation_js_1.SafetySchema; } });
+Object.defineProperty(exports, "ToolSpecSchema", { enumerable: true, get: function () { return validation_js_1.ToolSpecSchema; } });
+var linter_js_1 = require("./linter/linter.js");
+Object.defineProperty(exports, "lintTools", { enumerable: true, get: function () { return linter_js_1.lintTools; } });
+Object.defineProperty(exports, "lintSummary", { enumerable: true, get: function () { return linter_js_1.lintSummary; } });
+var redact_js_1 = require("./utils/redact.js");
+Object.defineProperty(exports, "redact", { enumerable: true, get: function () { return redact_js_1.redact; } });
+Object.defineProperty(exports, "isSensitiveFieldName", { enumerable: true, get: function () { return redact_js_1.isSensitiveFieldName; } });
+const form_extractor_js_1 = require("./extractor/form-extractor.js");
+const api_extractor_js_1 = require("./extractor/api-extractor.js");
+const click_extractor_js_1 = require("./extractor/click-extractor.js");
+const route_extractor_js_1 = require("./extractor/route-extractor.js");
+const clusterer_js_1 = require("./synthesizer/clusterer.js");
+const snippet_js_1 = require("./exporter/snippet.js");
+const manifest_js_1 = require("./exporter/manifest.js");
+const userscript_js_1 = require("./exporter/userscript.js");
+const yaml_js_1 = require("./exporter/yaml.js");
+/**
+ * Scan a website using Playwright, capturing DOM snapshots and network calls.
+ * Requires `playwright` as a peer dependency.
+ *
+ * @example
+ * ```ts
+ * const result = await scanUrl({ url: "https://example.com", depth: 2 });
+ * console.log(`Scanned ${result.metadata.pagesVisited} pages`);
+ * ```
+ */
+async function scanUrl(options) {
+    const { url, depth = 2, timeout = 30000, headless = true, executablePath, ignoreSelectors = [], cookie, onProgress, } = options;
+    // Playwright is lazily imported so it stays an optional peer dep
+    const { launchBrowser } = await import("./scanner/browser.js");
+    const { crawlSite } = await import("./scanner/crawler.js");
+    const { captureDom } = await import("./scanner/dom-capture.js");
+    const { createNetworkRecorder } = await import("./scanner/network-capture.js");
+    const { browser, context, page } = await launchBrowser({
+        executablePath,
+        headless,
+        cookie,
+    });
+    const allPages = [];
+    const allNetworkCalls = [];
+    let pageCount = 0;
+    const startedAt = new Date().toISOString();
+    try {
+        const networkRecorder = createNetworkRecorder(page, url);
+        for await (const visit of crawlSite(page, url, {
+            depth,
+            timeout,
+            ignoreSelectors,
+        })) {
+            pageCount++;
+            onProgress?.({
+                type: "page_visiting",
+                url: visit.url,
+                depth: visit.depth,
+            });
+            const domSnapshot = await captureDom(page);
+            allPages.push(domSnapshot);
+            onProgress?.({
+                type: "page_visited",
+                url: visit.url,
+                formsFound: domSnapshot.forms.length,
+                buttonsFound: domSnapshot.buttons.length,
+            });
+        }
+        allNetworkCalls.push(...networkRecorder.getCalls());
+        networkRecorder.stop();
+    }
+    finally {
+        await browser.close();
+    }
+    const scanResult = {
+        pages: allPages,
+        networkCalls: allNetworkCalls,
+        actions: [],
+        metadata: {
+            baseUrl: url,
+            startedAt,
+            completedAt: new Date().toISOString(),
+            pagesVisited: pageCount,
+            depth,
+        },
+    };
+    onProgress?.({ type: "complete", summary: scanResult.metadata });
+    return scanResult;
+}
+/**
+ * Extract actions from scan data and cluster them into tool definitions.
+ *
+ * @example
+ * ```ts
+ * const result = await scanUrl({ url: "https://example.com" });
+ * const tools = proposeTools(result, { minConfidence: 0.6 });
+ * ```
+ */
+function proposeTools(scanResult, options = {}) {
+    const { minConfidence = 0.5 } = options;
+    const actions = [
+        ...(0, form_extractor_js_1.extractForms)(scanResult.pages),
+        ...(0, api_extractor_js_1.extractApiCalls)(scanResult.networkCalls, scanResult.pages, scanResult.metadata.baseUrl),
+        ...(0, click_extractor_js_1.extractClickFlows)(scanResult.pages),
+        ...(0, route_extractor_js_1.extractRouteChanges)(scanResult.pages),
+    ];
+    if (actions.length === 0)
+        return [];
+    return (0, clusterer_js_1.clusterActions)(actions, { minConfidence });
+}
+/**
+ * Export tool definitions to a specific format.
+ *
+ * @example
+ * ```ts
+ * const result = exportTools(tools, "manifest", { domain: "example.com" });
+ * console.log(result.files[0].content);
+ * ```
+ */
+function exportTools(tools, format, options = {}) {
+    const { lang = "ts", domain = "unknown-domain" } = options;
+    switch (format) {
+        case "snippet":
+            return (0, snippet_js_1.generateSnippet)(tools, { lang, domain });
+        case "manifest":
+            return (0, manifest_js_1.generateManifest)(tools, { domain });
+        case "userscript":
+            return (0, userscript_js_1.generateUserscript)(tools, { domain });
+        case "yaml":
+            return (0, yaml_js_1.generateYaml)(tools, { domain });
+        default:
+            throw new Error(`Unknown export format: ${format}`);
+    }
+}
+/**
+ * Scan a URL and generate tool definitions in a single call.
+ *
+ * @example
+ * ```ts
+ * import { generateToolDefinitions } from "@keak/webmcp-core";
+ *
+ * const tools = await generateToolDefinitions("https://example.com", {
+ *   depth: 2,
+ *   headless: true,
+ *   minConfidence: 0.5,
+ * });
+ *
+ * for (const tool of tools) {
+ *   console.log(`${tool.name}: ${tool.description}`);
+ * }
+ * ```
+ */
+async function generateToolDefinitions(url, options = {}) {
+    const { minConfidence, useLlm, llmModel, ...scanOptions } = options;
+    const scanResult = await scanUrl({ url, ...scanOptions });
+    return proposeTools(scanResult, { minConfidence, useLlm, llmModel });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/linter/linter.d.ts

@@ -0,0 +1,10 @@
+import type { ToolSpec, LintResult } from "../types.js";
+export declare function lintTools(tools: ToolSpec[]): LintResult[];
+export declare function lintSummary(results: LintResult[]): {
+    totalTools: number;
+    totalWarnings: number;
+    errors: number;
+    warnings: number;
+    info: number;
+};
+//# sourceMappingURL=linter.d.ts.map

package/dist/linter/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/linter/linter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGxD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,CAKzD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CA4BA"}

package/dist/linter/linter.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lintTools = lintTools;
+exports.lintSummary = lintSummary;
+const rules_js_1 = require("./rules.js");
+function lintTools(tools) {
+    return tools.map((tool) => ({
+        tool,
+        warnings: rules_js_1.rules.flatMap((rule) => rule(tool)),
+    }));
+}
+function lintSummary(results) {
+    let errors = 0;
+    let warnings = 0;
+    let info = 0;
+    for (const result of results) {
+        for (const w of result.warnings) {
+            switch (w.severity) {
+                case "error":
+                    errors++;
+                    break;
+                case "warning":
+                    warnings++;
+                    break;
+                case "info":
+                    info++;
+                    break;
+            }
+        }
+    }
+    return {
+        totalTools: results.length,
+        totalWarnings: errors + warnings + info,
+        errors,
+        warnings,
+        info,
+    };
+}
+//# sourceMappingURL=linter.js.map

package/dist/linter/linter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../src/linter/linter.ts"],"names":[],"mappings":";;AAGA,8BAKC;AAED,kCAkCC;AA3CD,yCAAmC;AAEnC,SAAgB,SAAS,CAAC,KAAiB;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI;QACJ,QAAQ,EAAE,gBAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC9C,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,WAAW,CAAC,OAAqB;IAO/C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACnB,KAAK,OAAO;oBACV,MAAM,EAAE,CAAC;oBACT,MAAM;gBACR,KAAK,SAAS;oBACZ,QAAQ,EAAE,CAAC;oBACX,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,EAAE,CAAC;oBACP,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;QACvC,MAAM;QACN,QAAQ;QACR,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/linter/rules.d.ts

@@ -0,0 +1,4 @@
+import type { ToolSpec, LintWarning } from "../types.js";
+export type LintRule = (tool: ToolSpec) => LintWarning[];
+export declare const rules: LintRule[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/linter/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/linter/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,WAAW,EAAE,CAAC;AAEzD,eAAO,MAAM,KAAK,EAAE,QAAQ,EAM3B,CAAC"}

package/dist/linter/rules.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rules = void 0;
+exports.rules = [
+    namingConvention,
+    descriptionQuality,
+    schemaCompleteness,
+    safetyAnnotation,
+    inputSchemaDesign,
+];
+function namingConvention(tool) {
+    const warnings = [];
+    if (tool.name !== tool.name.toLowerCase()) {
+        warnings.push(warn(tool, "naming/lowercase", "error", "Tool name must be lowercase.", `Rename to "${tool.name.toLowerCase()}".`));
+    }
+    if (!/^[a-z][a-z0-9_]*$/.test(tool.name)) {
+        warnings.push(warn(tool, "naming/snake-case", "error", "Tool name must be snake_case (letters, numbers, underscores only)."));
+    }
+    const segments = tool.name.split("_");
+    if (segments.length < 2) {
+        warnings.push(warn(tool, "naming/segments", "warning", "Tool name should follow domain_verb_noun pattern (at least verb_noun).", "Add a domain prefix and/or verb, e.g., 'mysite_search_items'."));
+    }
+    if (tool.name.length > 64) {
+        warnings.push(warn(tool, "naming/length", "warning", `Tool name is ${tool.name.length} chars (max recommended: 64).`, "Shorten the name while keeping it descriptive."));
+    }
+    return warnings;
+}
+function descriptionQuality(tool) {
+    const warnings = [];
+    if (!tool.description || tool.description.length < 10) {
+        warnings.push(warn(tool, "description/length", "error", "Tool description is too short (minimum 10 characters).", "Write a clear sentence explaining what this tool does."));
+    }
+    if (tool.description && tool.description.length > 500) {
+        warnings.push(warn(tool, "description/length", "warning", `Tool description is ${tool.description.length} chars (max recommended: 500).`, "Keep descriptions concise — AI models work better with shorter descriptions."));
+    }
+    const firstWord = tool.description?.split(" ")[0]?.toLowerCase() || "";
+    const actionVerbs = [
+        "search", "find", "get", "fetch", "create", "submit", "update",
+        "delete", "remove", "send", "login", "register", "book", "navigate",
+        "click", "filter", "sort", "subscribe", "log", "run", "execute",
+        "make", "check", "list", "view", "show", "download", "upload",
+    ];
+    if (!actionVerbs.includes(firstWord)) {
+        warnings.push(warn(tool, "description/verb", "info", "Consider starting the description with an action verb (e.g., 'Search for...', 'Create a...')."));
+    }
+    return warnings;
+}
+function schemaCompleteness(tool) {
+    const warnings = [];
+    const schema = tool.inputSchema;
+    if (!schema.properties || Object.keys(schema.properties).length === 0) {
+        warnings.push(warn(tool, "schema/empty", "warning", "Input schema has no properties. Tools without parameters are rare.", "Add parameters that the AI model needs to provide."));
+        return warnings;
+    }
+    for (const [name, prop] of Object.entries(schema.properties)) {
+        if (!prop.type) {
+            warnings.push(warn(tool, "schema/type-missing", "warning", `Property "${name}" has no type defined.`, `Add a type (string, number, boolean, etc.) to "${name}".`));
+        }
+        if (!prop.description) {
+            warnings.push(warn(tool, "schema/description-missing", "info", `Property "${name}" has no description.`, "Add a description to help the AI model understand this field."));
+        }
+    }
+    const requiredCount = schema.required?.length || 0;
+    const totalCount = Object.keys(schema.properties).length;
+    if (requiredCount === 0 && totalCount > 0) {
+        warnings.push(warn(tool, "schema/no-required", "info", "No required fields defined. Consider marking essential fields as required."));
+    }
+    return warnings;
+}
+function safetyAnnotation(tool) {
+    const warnings = [];
+    if (tool.safety.level === "danger" && !tool.safety.requiresConfirm) {
+        warnings.push(warn(tool, "safety/confirm-danger", "error", "Dangerous tools must require user confirmation.", "Set requiresConfirm: true for danger-level tools."));
+    }
+    // Name suggests side effects but safety is marked read-only
+    if (tool.safety.level === "read") {
+        const name = tool.name.toLowerCase();
+        if (/create|update|delete|submit|send|post|book|register/.test(name)) {
+            warnings.push(warn(tool, "safety/possible-write", "warning", `Tool "${tool.name}" is marked as "read" but its name suggests it may have side effects.`, 'Consider changing safety level to "write" or "danger".'));
+        }
+    }
+    return warnings;
+}
+// Minimize "model math" — avoid making the AI compute values.
+function inputSchemaDesign(tool) {
+    const warnings = [];
+    const schema = tool.inputSchema;
+    if (!schema.properties)
+        return warnings;
+    const propCount = Object.keys(schema.properties).length;
+    if (propCount > 10) {
+        warnings.push(warn(tool, "design/too-many-params", "warning", `Tool has ${propCount} parameters. Consider breaking it into smaller tools.`, "AI models work better with focused tools that have fewer parameters."));
+    }
+    for (const [name, prop] of Object.entries(schema.properties)) {
+        if (prop.enum && prop.enum.length > 20) {
+            warnings.push(warn(tool, "design/large-enum", "info", `Property "${name}" has ${prop.enum.length} enum options.`, "Consider using a free-text field with validation instead."));
+        }
+    }
+    return warnings;
+}
+function warn(tool, rule, severity, message, suggestion) {
+    return {
+        toolId: tool.id,
+        toolName: tool.name,
+        rule,
+        severity,
+        message,
+        suggestion,
+    };
+}
+//# sourceMappingURL=rules.js.map

package/dist/linter/rules.js.map

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

package/dist/scanner/browser.d.ts

@@ -0,0 +1,14 @@
+import { type Browser, type BrowserContext, type Page } from "playwright";
+export interface BrowserConfig {
+    executablePath?: string;
+    headless?: boolean;
+    userDataDir?: string;
+    cookie?: string;
+}
+export interface BrowserSession {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+}
+export declare function launchBrowser(config?: BrowserConfig): Promise<BrowserSession>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/scanner/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/scanner/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,aAAa,CACjC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CA6BzB"}