@mcpmake/core 0.2.0

package/dist/transformer/har-dedup.js

@@ -0,0 +1,82 @@
+/**
+ * Deduplicate HAR entries that are likely pagination or retries.
+ *
+ * Strategy:
+ * - Group by method + normalizedPath (same as clustering)
+ * - Within each group, detect pagination patterns (same URL with different page/offset/cursor params)
+ * - Remove retries: consecutive requests to the same URL within 5s with same method
+ */
+export function deduplicateEntries(entries) {
+    const result = [];
+    const seenSignatures = new Map();
+    for (const entry of entries) {
+        const url = entry.entry.request.url;
+        const method = entry.entry.request.method;
+        const signature = `${method} ${stripPaginationParams(url)}`;
+        const timestamp = new Date(entry.entry.startedDateTime).getTime();
+        const seen = seenSignatures.get(signature);
+        if (seen) {
+            // Skip retries: same signature within 5 seconds
+            if (timestamp - seen.lastTime < 5000) {
+                seen.lastTime = timestamp;
+                seen.count++;
+                continue;
+            }
+            // Skip excessive pagination: keep at most 3 examples per endpoint
+            if (isPaginationVariant(url, entries, entry) && seen.count >= 3) {
+                seen.lastTime = timestamp;
+                seen.count++;
+                continue;
+            }
+        }
+        seenSignatures.set(signature, {
+            lastTime: timestamp,
+            count: (seen?.count ?? 0) + 1,
+        });
+        result.push(entry);
+    }
+    return result;
+}
+const PAGINATION_PARAMS = new Set([
+    'page',
+    'offset',
+    'limit',
+    'cursor',
+    'after',
+    'before',
+    'skip',
+    'take',
+    'per_page',
+    'page_size',
+    'pagesize',
+    'start',
+    'count',
+    'from',
+    'next_token',
+    'continuation',
+]);
+function stripPaginationParams(url) {
+    try {
+        const parsed = new URL(url);
+        for (const key of [...parsed.searchParams.keys()]) {
+            if (PAGINATION_PARAMS.has(key.toLowerCase())) {
+                parsed.searchParams.delete(key);
+            }
+        }
+        return `${parsed.origin}${parsed.pathname}${parsed.search}`;
+    }
+    catch {
+        return url;
+    }
+}
+function isPaginationVariant(url, allEntries, current) {
+    try {
+        const parsed = new URL(url);
+        const paramKeys = [...parsed.searchParams.keys()].map((k) => k.toLowerCase());
+        return paramKeys.some((k) => PAGINATION_PARAMS.has(k));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=har-dedup.js.map

package/dist/transformer/har-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-dedup.js","sourceRoot":"","sources":["../../src/transformer/har-dedup.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,GAAG,EAA+C,CAAC;IAE9E,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC;QAElE,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,IAAI,EAAE,CAAC;YACT,gDAAgD;YAChD,IAAI,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,kEAAkE;YAClE,IAAI,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;QACH,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE;YAC5B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;IACX,UAAU;IACV,OAAO;IACP,OAAO;IACP,MAAM;IACN,YAAY;IACZ,cAAc;CACf,CAAC,CAAC;AAEH,SAAS,qBAAqB,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAW,EACX,UAA6B,EAC7B,OAAwB;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/transformer/har-schema-inferrer.d.ts

@@ -0,0 +1,16 @@
+import type { JsonSchema } from '../types/index.js';
+/**
+ * Infer a JSON Schema from a sample JSON value.
+ * Handles objects, arrays, and primitives.
+ */
+export declare function inferJsonSchema(value: unknown, depth?: number): JsonSchema;
+/**
+ * Try to parse a response body as JSON and infer its schema.
+ * Returns undefined if not JSON or parsing fails.
+ */
+export declare function inferResponseSchema(body: string | undefined, mimeType: string): JsonSchema | undefined;
+/**
+ * Try to parse a request body and infer its schema.
+ */
+export declare function inferRequestBodySchema(text: string | undefined, mimeType: string): JsonSchema | undefined;
+//# sourceMappingURL=har-schema-inferrer.d.ts.map

package/dist/transformer/har-schema-inferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-schema-inferrer.d.ts","sourceRoot":"","sources":["../../src/transformer/har-schema-inferrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,UAAU,CA4CrE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,SAAS,CASxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,SAAS,CA0BxB"}

package/dist/transformer/har-schema-inferrer.js

@@ -0,0 +1,91 @@
+import { isDangerousKey } from '../utils/sanitize.js';
+const MAX_INFERENCE_DEPTH = 20;
+/**
+ * Infer a JSON Schema from a sample JSON value.
+ * Handles objects, arrays, and primitives.
+ */
+export function inferJsonSchema(value, depth = 0) {
+    if (depth > MAX_INFERENCE_DEPTH) {
+        return { type: 'object' };
+    }
+    if (value === null || value === undefined) {
+        return { type: 'string' };
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return { type: 'array', items: {} };
+        }
+        return { type: 'array', items: inferJsonSchema(value[0], depth + 1) };
+    }
+    if (typeof value === 'object') {
+        const properties = {};
+        const required = [];
+        for (const [key, val] of Object.entries(value)) {
+            if (isDangerousKey(key))
+                continue;
+            properties[key] = inferJsonSchema(val, depth + 1);
+            if (val !== null && val !== undefined) {
+                required.push(key);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        };
+    }
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? { type: 'integer' } : { type: 'number' };
+    }
+    if (typeof value === 'boolean') {
+        return { type: 'boolean' };
+    }
+    return { type: 'string' };
+}
+/**
+ * Try to parse a response body as JSON and infer its schema.
+ * Returns undefined if not JSON or parsing fails.
+ */
+export function inferResponseSchema(body, mimeType) {
+    if (!body || !mimeType.includes('json'))
+        return undefined;
+    try {
+        const parsed = JSON.parse(body);
+        return inferJsonSchema(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Try to parse a request body and infer its schema.
+ */
+export function inferRequestBodySchema(text, mimeType) {
+    if (!text)
+        return undefined;
+    if (mimeType.includes('json')) {
+        try {
+            return inferJsonSchema(JSON.parse(text));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (mimeType.includes('x-www-form-urlencoded')) {
+        const params = new URLSearchParams(text);
+        const properties = {};
+        const required = [];
+        for (const [key, value] of params) {
+            properties[key] = { type: 'string' };
+            required.push(key);
+            // Try to detect numbers/booleans
+            if (/^\d+$/.test(value))
+                properties[key] = { type: 'integer' };
+            else if (value === 'true' || value === 'false')
+                properties[key] = { type: 'boolean' };
+        }
+        return { type: 'object', properties, required };
+    }
+    return undefined;
+}
+//# sourceMappingURL=har-schema-inferrer.js.map

package/dist/transformer/har-schema-inferrer.js.map

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

package/dist/transformer/har-to-operations.d.ts

@@ -0,0 +1,14 @@
+import type { OperationDescriptor } from '../types/index.js';
+import type { EntryCluster } from './har-clusterer.js';
+export interface HarConversionResult {
+    operations: OperationDescriptor[];
+    baseUrl: string;
+    detectedAuth: DetectedAuth[];
+}
+export interface DetectedAuth {
+    type: 'bearer' | 'basic' | 'apiKey';
+    headerName: string;
+    exampleValue?: string;
+}
+export declare function clustersToOperations(clusters: EntryCluster[]): HarConversionResult;
+//# sourceMappingURL=har-to-operations.d.ts.map

package/dist/transformer/har-to-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-to-operations.d.ts","sourceRoot":"","sources":["../../src/transformer/har-to-operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAMpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA+BvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAkGlF"}

package/dist/transformer/har-to-operations.js

@@ -0,0 +1,193 @@
+import { mergeRequestBodySchemas } from './schema-merger.js';
+const AUTH_HEADER_PATTERNS = [
+    { pattern: /^Bearer\s+/i, schemeName: 'bearer' },
+    { pattern: /^Basic\s+/i, schemeName: 'basic' },
+    { pattern: /^Token\s+/i, schemeName: 'token' },
+];
+const CUSTOM_AUTH_HEADERS = [
+    'x-api-key',
+    'api-key',
+    'authorization-token',
+    'x-auth-token',
+    'x-access-token',
+    'x-csrf-token',
+    'x-session-token',
+];
+const SESSION_COOKIE_PATTERNS = [
+    /^sess/i,
+    /^sid$/i,
+    /^session/i,
+    /^token/i,
+    /^auth/i,
+    /^jwt/i,
+    /^connect\.sid$/i,
+];
+export function clustersToOperations(clusters) {
+    const operations = [];
+    const allAuth = new Map();
+    let baseUrl = '';
+    for (const cluster of clusters) {
+        if (!baseUrl)
+            baseUrl = cluster.baseUrl;
+        const canonical = pickCanonicalEntry(cluster.entries);
+        const entry = canonical.entry;
+        const auth = detectAuth(entry);
+        for (const a of auth) {
+            allAuth.set(a.headerName.toLowerCase(), a);
+        }
+        const operationId = generateOperationId(cluster.method, cluster.normalizedPath);
+        const parameters = [];
+        // Path params from normalization
+        for (const pp of canonical.pathParams) {
+            const schemaType = pp.inferredType === 'integer' ? 'integer' : 'string';
+            const schema = pp.inferredType === 'uuid' ? { type: 'string', format: 'uuid' } : { type: schemaType };
+            parameters.push({
+                name: pp.name,
+                in: 'path',
+                required: true,
+                description: pp.name,
+                schema,
+            });
+        }
+        // Query params merged across all entries in cluster
+        const queryMap = new Map();
+        for (const ne of cluster.entries) {
+            for (const qp of ne.queryParams) {
+                const existing = queryMap.get(qp.name);
+                if (existing) {
+                    existing.values.add(qp.exampleValue);
+                }
+                else {
+                    queryMap.set(qp.name, { values: new Set([qp.exampleValue]), type: qp.inferredType });
+                }
+            }
+        }
+        for (const [name, info] of queryMap) {
+            parameters.push({
+                name,
+                in: 'query',
+                required: false,
+                schema: { type: info.type },
+            });
+        }
+        // Request body — merge schemas across all entries in the cluster
+        let requestBody;
+        const bodyEntries = cluster.entries
+            .map((ne) => ne.entry.request.postData)
+            .filter((pd) => !!pd?.text)
+            .map((pd) => ({ text: pd.text, mimeType: pd.mimeType }));
+        if (bodyEntries.length > 0) {
+            const mergedSchema = mergeRequestBodySchemas(bodyEntries);
+            if (mergedSchema) {
+                requestBody = {
+                    required: true,
+                    contentType: bodyEntries[0].mimeType.split(';')[0].trim(),
+                    schema: mergedSchema,
+                };
+            }
+        }
+        // Security
+        const security = auth.map((a) => ({
+            schemeName: a.type,
+            scopes: [],
+        }));
+        operations.push({
+            operationId,
+            method: cluster.method,
+            path: cluster.normalizedPath,
+            summary: `${cluster.method.toUpperCase()} ${cluster.normalizedPath}`,
+            tags: [extractTag(cluster.normalizedPath)],
+            parameters,
+            requestBody,
+            responses: [],
+            security,
+            deprecated: false,
+        });
+    }
+    return {
+        operations,
+        baseUrl,
+        detectedAuth: [...allAuth.values()],
+    };
+}
+function pickCanonicalEntry(entries) {
+    // Prefer entries with 2xx responses
+    const successful = entries.filter((e) => e.entry.response.status >= 200 && e.entry.response.status < 300);
+    return successful[0] ?? entries[0];
+}
+function detectAuth(entry) {
+    const result = [];
+    for (const header of entry.request.headers) {
+        const name = header.name.toLowerCase();
+        if (name === 'authorization') {
+            for (const { pattern, schemeName } of AUTH_HEADER_PATTERNS) {
+                if (pattern.test(header.value)) {
+                    result.push({
+                        type: schemeName,
+                        headerName: 'Authorization',
+                        exampleValue: '[REDACTED]',
+                    });
+                    break;
+                }
+            }
+        }
+        if (CUSTOM_AUTH_HEADERS.includes(name)) {
+            result.push({
+                type: 'apiKey',
+                headerName: header.name,
+                exampleValue: '[REDACTED]',
+            });
+        }
+        // Detect cookie-based session auth
+        if (name === 'cookie') {
+            const cookies = header.value.split(';').map((c) => c.trim().split('=')[0]);
+            for (const cookieName of cookies) {
+                if (SESSION_COOKIE_PATTERNS.some((p) => p.test(cookieName))) {
+                    result.push({
+                        type: 'apiKey',
+                        headerName: 'Cookie',
+                        exampleValue: '[REDACTED]',
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    return result;
+}
+function generateOperationId(method, path) {
+    const segments = path
+        .replace(/\{[^}]+\}/g, '')
+        .split('/')
+        .filter(Boolean);
+    const resource = segments[segments.length - 1] ?? 'resource';
+    switch (method.toLowerCase()) {
+        case 'get':
+            return path.includes('{') ? `get_${singularize(resource)}` : `list_${resource}`;
+        case 'post':
+            return `create_${singularize(resource)}`;
+        case 'put':
+        case 'patch':
+            return `update_${singularize(resource)}`;
+        case 'delete':
+            return `delete_${singularize(resource)}`;
+        default:
+            return `${method.toLowerCase()}_${resource}`;
+    }
+}
+function extractTag(path) {
+    const segments = path.split('/').filter((s) => s && !s.startsWith('{'));
+    // Skip api/v1/v2 prefixes
+    const meaningful = segments.filter((s) => !/^(api|v\d+)$/i.test(s));
+    return meaningful[0] ?? 'default';
+}
+function singularize(word) {
+    if (word.endsWith('ies'))
+        return word.slice(0, -3) + 'y';
+    if (word.endsWith('ses') || word.endsWith('xes') || word.endsWith('zes'))
+        return word.slice(0, -2);
+    if (word.endsWith('s') && !word.endsWith('ss'))
+        return word.slice(0, -1);
+    return word;
+}
+//# sourceMappingURL=har-to-operations.js.map

package/dist/transformer/har-to-operations.js.map

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

package/dist/transformer/index.d.ts

@@ -0,0 +1,9 @@
+export { toToolName, toToolTitle, toFileName, toFunctionName } from './naming.js';
+export { detectAuthSchemes } from './auth-detector.js';
+export { buildToolDefinition, buildAllTools } from './tool-builder.js';
+export { clusterEntries } from './har-clusterer.js';
+export type { EntryCluster } from './har-clusterer.js';
+export { clustersToOperations } from './har-to-operations.js';
+export type { HarConversionResult, DetectedAuth } from './har-to-operations.js';
+export { inferJsonSchema, inferResponseSchema, inferRequestBodySchema, } from './har-schema-inferrer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transformer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transformer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/transformer/index.js

@@ -0,0 +1,7 @@
+export { toToolName, toToolTitle, toFileName, toFunctionName } from './naming.js';
+export { detectAuthSchemes } from './auth-detector.js';
+export { buildToolDefinition, buildAllTools } from './tool-builder.js';
+export { clusterEntries } from './har-clusterer.js';
+export { clustersToOperations } from './har-to-operations.js';
+export { inferJsonSchema, inferResponseSchema, inferRequestBodySchema, } from './har-schema-inferrer.js';
+//# sourceMappingURL=index.js.map

package/dist/transformer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/transformer/llm-namer.d.ts

@@ -0,0 +1,7 @@
+import type { OperationDescriptor } from '../types/index.js';
+/**
+ * Use Claude to generate better tool names and descriptions
+ * from HAR-captured request/response patterns.
+ */
+export declare function improveToolNames(operations: OperationDescriptor[], model?: string): Promise<OperationDescriptor[]>;
+//# sourceMappingURL=llm-namer.d.ts.map

package/dist/transformer/llm-namer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-namer.d.ts","sourceRoot":"","sources":["../../src/transformer/llm-namer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,mBAAmB,EAAE,EACjC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2DhC"}

package/dist/transformer/llm-namer.js

@@ -0,0 +1,60 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { logger } from '../utils/logger.js';
+/**
+ * Use Claude to generate better tool names and descriptions
+ * from HAR-captured request/response patterns.
+ */
+export async function improveToolNames(operations, model) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        logger.warn('ANTHROPIC_API_KEY not set — skipping LLM tool naming');
+        return operations;
+    }
+    const client = new Anthropic({ apiKey });
+    const operationSummaries = operations.map((op) => ({
+        method: op.method,
+        path: op.path,
+        currentId: op.operationId,
+        summary: op.summary,
+        paramNames: op.parameters.map((p) => p.name),
+        hasBody: !!op.requestBody,
+        tags: op.tags,
+    }));
+    const prompt = `Given these API operations captured from network traffic, suggest better operationId names and descriptions. Return a JSON array with one object per operation: { "index": number, "operationId": "camelCase name", "summary": "one-line description" }. Keep names concise (camelCase, under 40 chars). Only output JSON, no explanation.
+
+Operations:
+${JSON.stringify(operationSummaries, null, 2)}`;
+    try {
+        logger.info('Improving tool names with Claude...');
+        const message = await client.messages.create({
+            model: model ?? 'claude-sonnet-4-20250514',
+            max_tokens: 2048,
+            messages: [{ role: 'user', content: prompt }],
+        });
+        const content = message.content[0];
+        if (content.type !== 'text')
+            return operations;
+        let json = content.text.trim();
+        if (json.startsWith('```')) {
+            json = json.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const improvements = JSON.parse(json);
+        const result = operations.map((op, i) => {
+            const improvement = improvements.find((imp) => imp.index === i);
+            if (!improvement)
+                return op;
+            return {
+                ...op,
+                operationId: improvement.operationId || op.operationId,
+                summary: improvement.summary || op.summary,
+            };
+        });
+        logger.info(`Improved ${improvements.length} tool names`);
+        return result;
+    }
+    catch (err) {
+        logger.warn(`LLM naming failed, using defaults: ${err instanceof Error ? err.message : err}`);
+        return operations;
+    }
+}
+//# sourceMappingURL=llm-namer.js.map

package/dist/transformer/llm-namer.js.map

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

package/dist/transformer/naming.d.ts

@@ -0,0 +1,5 @@
+export declare function toToolName(operationId: string): string;
+export declare function toToolTitle(operationId: string): string;
+export declare function toFileName(operationId: string): string;
+export declare function toFunctionName(operationId: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/transformer/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/transformer/naming.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/transformer/naming.js

@@ -0,0 +1,31 @@
+export function toToolName(operationId) {
+    return toSnakeCase(operationId);
+}
+export function toToolTitle(operationId) {
+    const snake = toSnakeCase(operationId);
+    return snake
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+export function toFileName(operationId) {
+    return toSnakeCase(operationId)
+        .replace(/_/g, '-')
+        .replace(/\.\./g, '')
+        .replace(/[/\\]/g, '')
+        .replace(/[^a-z0-9\-]/g, '');
+}
+export function toFunctionName(operationId) {
+    const snake = toSnakeCase(operationId);
+    return snake.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function toSnakeCase(str) {
+    return str
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')
+        .replace(/[\s\-]+/g, '_')
+        .toLowerCase()
+        .replace(/^_+|_+$/g, '')
+        .replace(/_+/g, '_');
+}
+//# sourceMappingURL=naming.js.map

package/dist/transformer/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/transformer/naming.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,OAAO,WAAW,CAAC,WAAW,CAAC;SAC5B,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG;SACP,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,WAAW,EAAE;SACb,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/transformer/operation-filter.d.ts

@@ -0,0 +1,14 @@
+import type { OperationDescriptor } from '../types/index.js';
+export interface FilterOptions {
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Filter operations by tag or path pattern.
+ * Patterns can be:
+ *   - A tag name: "pets" matches operations tagged with "pets"
+ *   - A path prefix: "/users*" matches /users, /users/{id}, etc.
+ *   - A glob-like pattern: "*admin*" matches any operation with "admin" in path or tags
+ */
+export declare function filterOperations(operations: OperationDescriptor[], options: FilterOptions): OperationDescriptor[];
+//# sourceMappingURL=operation-filter.d.ts.map

package/dist/transformer/operation-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-filter.d.ts","sourceRoot":"","sources":["../../src/transformer/operation-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,mBAAmB,EAAE,EACjC,OAAO,EAAE,aAAa,GACrB,mBAAmB,EAAE,CAgBvB"}