@keak/webmcp-core 0.1.0

package/dist/synthesizer/safety-classifier.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifySafety = classifySafety;
+function classifySafety(actions) {
+    let level = "read";
+    for (const action of actions) {
+        const actionLevel = classifyAction(action);
+        level = promoteSafety(level, actionLevel);
+    }
+    return {
+        level,
+        requiresConfirm: level !== "read",
+    };
+}
+function classifyAction(action) {
+    switch (action.kind) {
+        case "form_submit":
+            return classifyFormAction(action);
+        case "api_call":
+            return classifyApiAction(action);
+        case "click_flow":
+            return "write"; // Clicks can trigger side effects
+        case "route_change":
+            return "read"; // Navigation is read-only
+    }
+}
+function classifyFormAction(action) {
+    const labels = action.labels.join(" ").toLowerCase();
+    const method = action.method || "POST";
+    if (/delete|remove|cancel|destroy|purge/i.test(labels))
+        return "danger";
+    if (/payment|pay|purchase|checkout|billing/i.test(labels))
+        return "danger";
+    // GET forms are typically searches
+    if (method === "GET")
+        return "read";
+    if (/search|find|filter|sort|lookup/i.test(labels))
+        return "read";
+    // Login creates a session, so it's a write not a read
+    if (/login|sign.?in|auth/i.test(labels))
+        return "write";
+    return "write";
+}
+function classifyApiAction(action) {
+    const method = action.request.method;
+    const path = action.request.url.toLowerCase();
+    if (method === "DELETE")
+        return "danger";
+    if (/payment|charge|billing|purchase|checkout/i.test(path))
+        return "danger";
+    if (/delete|destroy|remove|purge/i.test(path))
+        return "danger";
+    if (method === "GET")
+        return "read";
+    if (action.request.operationType === "query")
+        return "read";
+    if (action.request.operationType === "mutation")
+        return "write";
+    return "write";
+}
+// Returns the more restrictive of two safety levels.
+function promoteSafety(a, b) {
+    const order = ["read", "write", "danger"];
+    const ai = order.indexOf(a);
+    const bi = order.indexOf(b);
+    return order[Math.max(ai, bi)];
+}
+//# sourceMappingURL=safety-classifier.js.map

package/dist/synthesizer/safety-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-classifier.js","sourceRoot":"","sources":["../../src/synthesizer/safety-classifier.ts"],"names":[],"mappings":";;AAEA,wCAYC;AAZD,SAAgB,cAAc,CAAC,OAAiB;IAC9C,IAAI,KAAK,GAAgB,MAAM,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,KAAK;QACL,eAAe,EAAE,KAAK,KAAK,MAAM;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa;YAChB,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,UAAU;YACb,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,CAAC,kCAAkC;QACpD,KAAK,cAAc;YACjB,OAAO,MAAM,CAAC,CAAC,0BAA0B;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAwC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IAEvC,IAAI,qCAAqC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxE,IAAI,wCAAwC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE3E,mCAAmC;IACnC,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,iCAAiC,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAElE,sDAAsD;IACtD,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAExD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqC;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAE9C,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAEzC,IAAI,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5E,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE/D,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC;IAEpC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAEhE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qDAAqD;AACrD,SAAS,aAAa,CAAC,CAAc,EAAE,CAAc;IACnD,MAAM,KAAK,GAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/synthesizer/schema-builder.d.ts

@@ -0,0 +1,3 @@
+import type { Action, JsonSchema } from "../types.js";
+export declare function buildInputSchema(actions: Action[]): JsonSchema;
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/synthesizer/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../src/synthesizer/schema-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,aAAa,CAAC;AAGrB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,CA2B9D"}

package/dist/synthesizer/schema-builder.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInputSchema = buildInputSchema;
+const schema_inferrer_js_1 = require("../extractor/schema-inferrer.js");
+function buildInputSchema(actions) {
+    const schemas = [];
+    for (const action of actions) {
+        switch (action.kind) {
+            case "form_submit":
+                schemas.push(buildFormSchema(action));
+                break;
+            case "api_call":
+                schemas.push(buildApiSchema(action));
+                break;
+            case "click_flow":
+                break;
+            case "route_change":
+                break;
+        }
+    }
+    if (schemas.length === 0) {
+        return { type: "object", properties: {} };
+    }
+    if (schemas.length === 1) {
+        return schemas[0];
+    }
+    return mergeSchemas(schemas);
+}
+function buildFormSchema(action) {
+    return (0, schema_inferrer_js_1.schemaFromFields)(action.fields);
+}
+function buildApiSchema(action) {
+    if (action.request.requestBodySample &&
+        ["POST", "PUT", "PATCH"].includes(action.request.method)) {
+        return (0, schema_inferrer_js_1.schemaFromSample)(action.request.requestBodySample);
+    }
+    if (action.request.requestBodySchema) {
+        return action.request.requestBodySchema;
+    }
+    if (action.request.method === "GET") {
+        return schemaFromQueryParams(action.request.url);
+    }
+    return { type: "object", properties: {} };
+}
+function schemaFromQueryParams(url) {
+    try {
+        const parsed = new URL(url);
+        const properties = {};
+        for (const [key, value] of parsed.searchParams) {
+            properties[key] = inferParamType(value);
+        }
+        if (Object.keys(properties).length === 0) {
+            return { type: "object", properties: {} };
+        }
+        return { type: "object", properties };
+    }
+    catch {
+        return { type: "object", properties: {} };
+    }
+}
+function inferParamType(value) {
+    if (/^\d+$/.test(value))
+        return { type: "integer" };
+    if (/^\d+\.\d+$/.test(value))
+        return { type: "number" };
+    if (value === "true" || value === "false")
+        return { type: "boolean" };
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return { type: "string", format: "date" };
+    }
+    return { type: "string" };
+}
+function mergeSchemas(schemas) {
+    const allProperties = {};
+    const allRequired = new Set();
+    for (const schema of schemas) {
+        if (schema.properties) {
+            for (const [key, value] of Object.entries(schema.properties)) {
+                if (!allProperties[key]) {
+                    allProperties[key] = value;
+                }
+            }
+        }
+        if (schema.required) {
+            for (const r of schema.required) {
+                allRequired.add(r);
+            }
+        }
+    }
+    const merged = {
+        type: "object",
+        properties: allProperties,
+    };
+    if (allRequired.size > 0) {
+        merged.required = Array.from(allRequired);
+    }
+    return merged;
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/synthesizer/schema-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../src/synthesizer/schema-builder.ts"],"names":[],"mappings":";;AAQA,4CA2BC;AA7BD,wEAAqF;AAErF,SAAgB,gBAAgB,CAAC,OAAiB;IAChD,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,aAAa;gBAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtC,MAAM;YACR,KAAK,UAAU;gBACb,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,YAAY;gBACf,MAAM;YACR,KAAK,cAAc;gBACjB,MAAM;QACV,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,eAAe,CAAC,MAAwB;IAC/C,OAAO,IAAA,qCAAgB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,MAAqB;IAC3C,IACE,MAAM,CAAC,OAAO,CAAC,iBAAiB;QAChC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EACxD,CAAC;QACD,OAAO,IAAA,qCAAgB,EAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACpC,OAAO,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,UAAU,GAA+B,EAAE,CAAC;QAElD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/C,UAAU,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACpD,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAExD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAEtE,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,OAAqB;IACzC,MAAM,aAAa,GAA+B,EAAE,CAAC;IACrD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAe;QACzB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,aAAa;KAC1B,CAAC;IAEF,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,271 @@
+export interface JsonSchema {
+    type?: "object" | "string" | "number" | "integer" | "boolean" | "array";
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: string[];
+    description?: string;
+    default?: unknown;
+    format?: "email" | "uri" | "date" | "time" | "date-time";
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    additionalProperties?: boolean | JsonSchema;
+    examples?: unknown[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+}
+export interface FieldSpec {
+    name: string;
+    type: "string" | "number" | "boolean" | "enum" | "date" | "email" | "tel" | "url";
+    required: boolean;
+    label?: string;
+    placeholder?: string;
+    options?: string[];
+    pattern?: string;
+    min?: number;
+    max?: number;
+    defaultValue?: string;
+}
+export interface NetworkCall {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    url: string;
+    status?: number;
+    requestHeaders?: Record<string, string>;
+    requestBodySchema?: JsonSchema;
+    responseBodySchema?: JsonSchema;
+    requestBodySample?: unknown;
+    responseBodySample?: unknown;
+    operationName?: string;
+    operationType?: "query" | "mutation" | "subscription";
+}
+export type Action = FormSubmitAction | ClickFlowAction | ApiCallAction | RouteChangeAction;
+export interface FormSubmitAction {
+    kind: "form_submit";
+    id: string;
+    pageUrl: string;
+    formSelector: string;
+    fields: FieldSpec[];
+    submitSelector: string;
+    labels: string[];
+    method?: "GET" | "POST";
+    action?: string;
+    networkCalls: NetworkCall[];
+}
+export interface ClickFlowAction {
+    kind: "click_flow";
+    id: string;
+    pageUrl: string;
+    startSelector: string;
+    intermediateSteps?: string[];
+    resultingUrl?: string;
+    networkCalls: NetworkCall[];
+    labels: string[];
+    screenshotPath?: string;
+}
+export interface ApiCallAction {
+    kind: "api_call";
+    id: string;
+    pageUrl: string;
+    request: NetworkCall;
+    triggerSelector?: string;
+    labels: string[];
+}
+export interface RouteChangeAction {
+    kind: "route_change";
+    id: string;
+    from: string;
+    to: string;
+    trigger?: string;
+    labels: string[];
+}
+export type HandlerStep = {
+    step: "ensure_page";
+    urlPattern: string;
+} | {
+    step: "fill_form";
+    formSelector: string;
+    mapping: Record<string, string>;
+} | {
+    step: "click";
+    selector: string;
+    waitFor?: string;
+} | {
+    step: "wait_network";
+    match: {
+        urlIncludes?: string;
+        operationName?: string;
+    };
+} | {
+    step: "wait_element";
+    selector: string;
+    timeout?: number;
+} | {
+    step: "extract";
+    selector: string;
+    attribute?: string;
+} | {
+    step: "return";
+    format: "text" | "json";
+    mapping?: Record<string, string>;
+};
+export interface HandlerTemplate {
+    steps: HandlerStep[];
+}
+export type SafetyLevel = "read" | "write" | "danger";
+export interface Safety {
+    level: SafetyLevel;
+    requiresConfirm: boolean;
+}
+export interface ToolSpec {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    outputSchema?: JsonSchema;
+    safety: Safety;
+    availability: {
+        urlPatterns: string[];
+        requiresAuth: boolean;
+    };
+    implementation: {
+        kind: "js_handler" | "form_declarative";
+        handlerTemplate?: HandlerTemplate;
+        form?: {
+            toolname: string;
+            tooldescription: string;
+            toolautosubmit?: boolean;
+            formSelector: string;
+        };
+    };
+    provenance: {
+        actions: string[];
+        createdFrom: "autogen-v1";
+        confidence: number;
+        pageUrl: string;
+    };
+}
+export type AuthMethod = "none" | "cookie" | "browser-login";
+export type OutputTarget = "snippet" | "userscript" | "manifest" | "yaml";
+export type OutputLang = "ts" | "js";
+export type Framework = "vanilla" | "react" | "vue";
+export interface AutogenConfig {
+    baseUrl: string;
+    auth: {
+        method: AuthMethod;
+        profilePath?: string | null;
+        cookie?: string | null;
+    };
+    output: {
+        target: OutputTarget;
+        lang: OutputLang;
+        outDir: string;
+        framework: Framework;
+    };
+    browser: {
+        executablePath?: string | null;
+        headless: boolean;
+    };
+    scan: {
+        depth: number;
+        ignore: string[];
+        timeout: number;
+    };
+}
+export interface DomSnapshot {
+    url: string;
+    title: string;
+    forms: DomForm[];
+    buttons: DomButton[];
+    links: DomLink[];
+    timestamp: string;
+}
+export interface DomForm {
+    selector: string;
+    id?: string;
+    action?: string;
+    method?: string;
+    fields: FieldSpec[];
+    submitSelector?: string;
+    labels: string[];
+}
+export interface DomButton {
+    selector: string;
+    text: string;
+    ariaLabel?: string;
+    type?: string;
+    isInsideForm: boolean;
+}
+export interface DomLink {
+    selector: string;
+    text: string;
+    href: string;
+    ariaLabel?: string;
+    isInternal: boolean;
+}
+export interface ScanResult {
+    pages: DomSnapshot[];
+    networkCalls: NetworkCall[];
+    actions: Action[];
+    metadata: {
+        baseUrl: string;
+        startedAt: string;
+        completedAt: string;
+        pagesVisited: number;
+        depth: number;
+    };
+}
+export type ScanProgressEvent = {
+    type: "page_visiting";
+    url: string;
+    depth: number;
+} | {
+    type: "page_visited";
+    url: string;
+    formsFound: number;
+    buttonsFound: number;
+} | {
+    type: "network_call";
+    method: string;
+    url: string;
+} | {
+    type: "action_discovered";
+    kind: Action["kind"];
+    label: string;
+} | {
+    type: "screenshot";
+    path: string;
+} | {
+    type: "error";
+    message: string;
+} | {
+    type: "complete";
+    summary: ScanResult["metadata"];
+};
+export type LintSeverity = "error" | "warning" | "info";
+export interface LintWarning {
+    toolId: string;
+    toolName: string;
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    suggestion?: string;
+}
+export interface LintResult {
+    tool: ToolSpec;
+    warnings: LintWarning[];
+}
+export interface ExportResult {
+    files: ExportFile[];
+    target: OutputTarget;
+}
+export interface ExportFile {
+    name: string;
+    content: string;
+    language: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;CACvD;AAED,MAAM,MAAM,MAAM,GACd,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,iBAAiB,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,GACD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEN,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF,cAAc,EAAE;QACd,IAAI,EAAE,YAAY,GAAG,kBAAkB,CAAC;QACxC,eAAe,CAAC,EAAE,eAAe,CAAC;QAClC,IAAI,CAAC,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC;YACjB,eAAe,EAAE,MAAM,CAAC;YACxB,cAAc,CAAC,EAAE,OAAO,CAAC;YACzB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;IAEF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,WAAW,EAAE,YAAY,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,MAAM,EAAE,UAAU,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,YAAY,CAAC;QACrB,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,SAAS,CAAC;KACtB,CAAC;IACF,OAAO,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/redact.d.ts

@@ -0,0 +1,3 @@
+export declare function redact(data: unknown, maxStringLength?: number): unknown;
+export declare function isSensitiveFieldName(name: string): boolean;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAYA,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EACb,eAAe,GAAE,MAAY,GAC5B,OAAO,CAmBT;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/utils/redact.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redact = redact;
+exports.isSensitiveFieldName = isSensitiveFieldName;
+const SENSITIVE_PATTERNS = [
+    /password/i,
+    /secret/i,
+    /token/i,
+    /key/i,
+    /auth/i,
+    /credit.?card/i,
+    /cvv/i,
+    /ssn/i,
+    /social.?security/i,
+];
+function redact(data, maxStringLength = 200) {
+    if (data === null || data === undefined)
+        return data;
+    if (typeof data === "string") {
+        return data.length > maxStringLength
+            ? data.slice(0, 50) + "...[truncated]"
+            : data;
+    }
+    if (typeof data !== "object")
+        return data;
+    if (Array.isArray(data))
+        return data.map((item) => redact(item, maxStringLength));
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (SENSITIVE_PATTERNS.some((p) => p.test(key))) {
+            result[key] = "[REDACTED]";
+        }
+        else {
+            result[key] = redact(value, maxStringLength);
+        }
+    }
+    return result;
+}
+function isSensitiveFieldName(name) {
+    return SENSITIVE_PATTERNS.some((p) => p.test(name));
+}
+//# sourceMappingURL=redact.js.map

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":";;AAYA,wBAsBC;AAED,oDAEC;AAtCD,MAAM,kBAAkB,GAAG;IACzB,WAAW;IACX,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;IACP,eAAe;IACf,MAAM;IACN,MAAM;IACN,mBAAmB;CACpB,CAAC;AAEF,SAAgB,MAAM,CACpB,IAAa,EACb,kBAA0B,GAAG;IAE7B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,GAAG,eAAe;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,gBAAgB;YACtC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAElF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC"}