@mcpmake/core 0.2.0

package/dist/site-transformer/tool-generator.js

@@ -0,0 +1,246 @@
+/**
+ * Converts a SiteDescriptor into SiteToolDefinition[].
+ *
+ * Generates two levels of tools:
+ * - Page-level: one tool per form (e.g., login(email, password))
+ * - Action-level: one tool per standalone button/link
+ * Plus built-in browser lifecycle tools.
+ */
+import { buildBrowserLifecycleTools } from './browser-tools.js';
+import { toToolName, toToolTitle, toFileName, toFunctionName } from '../transformer/naming.js';
+/**
+ * Generate all tools from a site descriptor.
+ */
+export function generateSiteTools(site) {
+    const tools = [];
+    const usedNames = new Set();
+    // 1. Built-in browser lifecycle tools
+    const lifecycleTools = buildBrowserLifecycleTools();
+    for (const tool of lifecycleTools) {
+        usedNames.add(tool.name);
+        tools.push(tool);
+    }
+    // 2. Navigation tool to the site's home page
+    const homeTool = buildNavigationTool('navigate_home', site.baseUrl, `Navigate to the home page at ${site.baseUrl}`, usedNames);
+    tools.push(homeTool);
+    // 3. Page-level tools (forms)
+    for (const page of site.pages) {
+        for (const form of page.forms) {
+            const tool = buildFormTool(page, form, usedNames);
+            if (tool)
+                tools.push(tool);
+        }
+    }
+    // 4. Action-level tools (standalone buttons)
+    for (const page of site.pages) {
+        for (const button of page.buttons) {
+            const tool = buildButtonTool(page, button, usedNames);
+            if (tool)
+                tools.push(tool);
+        }
+    }
+    // 5. Navigation tools (key links)
+    for (const page of site.pages) {
+        for (const link of page.links) {
+            if (!link.isNavigation)
+                continue;
+            const tool = buildLinkTool(page, link, usedNames);
+            if (tool)
+                tools.push(tool);
+        }
+    }
+    return tools;
+}
+// ─── Form Tool Builder ──────────────────────────────────────────────
+function buildFormTool(page, form, usedNames) {
+    // Skip forms with no visible fields
+    const visibleFields = form.fields.filter((f) => f.fieldType !== 'hidden');
+    if (visibleFields.length === 0)
+        return null;
+    // Generate tool name from semantic name or form fields
+    const rawName = form.semanticName || inferFormName(form);
+    const name = deduplicateName(toToolName(rawName), usedNames);
+    // Build Zod input schema from form fields
+    const inputSchemaCode = buildFormInputSchema(visibleFields);
+    // Collect all selectors this tool depends on
+    const selectors = [form.selector];
+    for (const field of visibleFields) {
+        selectors.push(field.selector);
+    }
+    if (form.submitButton)
+        selectors.push(form.submitButton);
+    const description = form.description ||
+        `Fill and submit the ${form.semanticName || 'form'} on ${page.title || page.url}`;
+    return {
+        name,
+        title: toToolTitle(rawName),
+        description,
+        inputSchemaCode,
+        fileName: toFileName(rawName),
+        functionName: toFunctionName(rawName),
+        toolType: 'page-action',
+        pageId: page.pageId,
+        pageUrl: page.url,
+        form,
+        selectors,
+        returnsScreenshot: true,
+        annotations: { readOnlyHint: false },
+    };
+}
+// ─── Button Tool Builder ────────────────────────────────────────────
+function buildButtonTool(page, button, usedNames) {
+    const rawName = button.semanticAction ||
+        (button.text ? `click_${button.text.replace(/\s+/g, '_').toLowerCase()}` : null);
+    if (!rawName)
+        return null;
+    const name = deduplicateName(toToolName(rawName), usedNames);
+    // Buttons typically don't need input parameters beyond sessionId
+    const inputSchemaCode = `z.object({
+  sessionId: z.string().max(64).regex(/^[a-zA-Z0-9_-]+$/).optional().describe('Browser session ID'),
+})`;
+    const description = button.description ||
+        `Click the "${button.text || button.ariaLabel}" button on ${page.title || page.url}`;
+    return {
+        name,
+        title: toToolTitle(rawName),
+        description,
+        inputSchemaCode,
+        fileName: toFileName(rawName),
+        functionName: toFunctionName(rawName),
+        toolType: 'element-action',
+        pageId: page.pageId,
+        pageUrl: page.url,
+        button,
+        selectors: [button.selector],
+        returnsScreenshot: true,
+        annotations: { readOnlyHint: false },
+    };
+}
+// ─── Link Tool Builder ──────────────────────────────────────────────
+function buildLinkTool(page, link, usedNames) {
+    const rawName = link.semanticAction ||
+        (link.text ? `navigate_to_${link.text.replace(/\s+/g, '_').toLowerCase()}` : null);
+    if (!rawName)
+        return null;
+    const name = deduplicateName(toToolName(rawName), usedNames);
+    const inputSchemaCode = `z.object({
+  sessionId: z.string().max(64).regex(/^[a-zA-Z0-9_-]+$/).optional().describe('Browser session ID'),
+})`;
+    const description = `Navigate to "${link.text}" at ${link.href}`;
+    return {
+        name,
+        title: toToolTitle(rawName),
+        description,
+        inputSchemaCode,
+        fileName: toFileName(rawName),
+        functionName: toFunctionName(rawName),
+        toolType: 'navigation',
+        pageId: page.pageId,
+        pageUrl: page.url,
+        link,
+        selectors: [link.selector],
+        returnsScreenshot: true,
+        annotations: { readOnlyHint: true },
+    };
+}
+// ─── Navigation Helper ──────────────────────────────────────────────
+function buildNavigationTool(rawName, url, description, usedNames) {
+    const name = deduplicateName(toToolName(rawName), usedNames);
+    return {
+        name,
+        title: toToolTitle(rawName),
+        description,
+        inputSchemaCode: `z.object({
+  sessionId: z.string().max(64).regex(/^[a-zA-Z0-9_-]+$/).optional().describe('Browser session ID'),
+})`,
+        fileName: toFileName(rawName),
+        functionName: toFunctionName(rawName),
+        toolType: 'navigation',
+        pageUrl: url,
+        selectors: [],
+        returnsScreenshot: true,
+        annotations: { readOnlyHint: true },
+    };
+}
+// ─── Schema Builders ────────────────────────────────────────────────
+function buildFormInputSchema(fields) {
+    const fieldLines = [
+        `  sessionId: z.string().max(64).regex(/^[a-zA-Z0-9_-]+$/).optional().describe('Browser session ID'),`,
+    ];
+    for (const field of fields) {
+        const zodType = mapFieldToZodType(field);
+        const desc = field.label || field.placeholder || field.name;
+        const required = field.required ? '' : '.optional()';
+        fieldLines.push(`  ${sanitizeFieldName(field.name)}: ${zodType}${required}.describe('${escapeString(desc)}'),`);
+    }
+    return `z.object({\n${fieldLines.join('\n')}\n})`;
+}
+function mapFieldToZodType(field) {
+    switch (field.fieldType) {
+        case 'email':
+            return 'z.string().email()';
+        case 'number':
+        case 'range':
+            return 'z.number()';
+        case 'checkbox':
+            return 'z.boolean()';
+        case 'url':
+            return 'z.string().url()';
+        case 'select':
+            if (field.options && field.options.length > 0) {
+                const opts = field.options.map((o) => `'${escapeString(o)}'`).join(', ');
+                return `z.enum([${opts}])`;
+            }
+            return 'z.string()';
+        case 'radio':
+            if (field.options && field.options.length > 0) {
+                const opts = field.options.map((o) => `'${escapeString(o)}'`).join(', ');
+                return `z.enum([${opts}])`;
+            }
+            return 'z.string()';
+        default:
+            return 'z.string()';
+    }
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+/** Infer a form name from its fields when no semantic name is available. */
+function inferFormName(form) {
+    const fieldNames = form.fields.map((f) => f.name.toLowerCase());
+    // Common form patterns
+    if (fieldNames.some((n) => n.includes('password'))) {
+        if (fieldNames.some((n) => n.includes('confirm') || n.includes('register') || n.includes('signup'))) {
+            return 'register';
+        }
+        return 'login';
+    }
+    if (fieldNames.some((n) => n.includes('search') || n.includes('query') || n.includes('q'))) {
+        return 'search';
+    }
+    if (fieldNames.some((n) => n.includes('email') && !fieldNames.some((n2) => n2.includes('password')))) {
+        return 'subscribe';
+    }
+    if (fieldNames.some((n) => n.includes('message') || n.includes('comment'))) {
+        return 'send_message';
+    }
+    // Fallback: use first field name or form ID
+    return form.formId.replace(/^form_/, 'submit_form_');
+}
+function deduplicateName(name, usedNames) {
+    let candidate = name;
+    let suffix = 2;
+    while (usedNames.has(candidate)) {
+        candidate = `${name}_${suffix}`;
+        suffix++;
+    }
+    usedNames.add(candidate);
+    return candidate;
+}
+function sanitizeFieldName(name) {
+    // Make valid JS identifier
+    const sanitized = name.replace(/[^a-zA-Z0-9_]/g, '_').replace(/^[0-9]/, '_$&');
+    return sanitized || '_field';
+}
+function escapeString(str) {
+    return str.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\n/g, ' ');
+}
+//# sourceMappingURL=tool-generator.js.map

package/dist/site-transformer/tool-generator.js.map

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

package/dist/transformer/auth-detector.d.ts

@@ -0,0 +1,29 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { AuthScheme, EnvVarDescriptor } from '../types/index.js';
+export interface OAuthFlowInfo {
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    scopes: string[];
+    flowType: 'authorizationCode' | 'clientCredentials' | 'implicit' | 'password';
+}
+export interface AuthDetectOptions {
+    /**
+     * Only emit the named OpenAPI security scheme (the rest are ignored). Maps a
+     * Stainless `security_scheme` choice so the generated server uses the same
+     * credential the SDK did, even when the spec declares several schemes.
+     */
+    onlyScheme?: string;
+    /**
+     * Override the credential env-var name for the single-secret schemes (apiKey /
+     * http-bearer). Maps a Stainless `read_env` so the generated server reads e.g.
+     * `ACME_API_KEY` instead of mcpmake's default. Ignored for basic/oauth2
+     * (multiple secrets — there is no single name to rename).
+     */
+    envVarName?: string;
+}
+export declare function detectAuthSchemes(securitySchemes: Record<string, OpenAPIV3.SecuritySchemeObject>, options?: AuthDetectOptions): {
+    authSchemes: AuthScheme[];
+    envVars: EnvVarDescriptor[];
+    oauthFlows: OAuthFlowInfo[];
+};
+//# sourceMappingURL=auth-detector.d.ts.map

package/dist/transformer/auth-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-detector.d.ts","sourceRoot":"","sources":["../../src/transformer/auth-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,UAAU,GAAG,UAAU,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAC/D,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,UAAU,EAAE,aAAa,EAAE,CAAA;CAAE,CAkHzF"}

package/dist/transformer/auth-detector.js

@@ -0,0 +1,104 @@
+export function detectAuthSchemes(securitySchemes, options) {
+    const authSchemes = [];
+    const envVars = [];
+    const oauthFlows = [];
+    // Honour an explicit scheme choice (Stainless `security_scheme`) when it
+    // exists; otherwise emit every detected scheme as before.
+    let entries = Object.entries(securitySchemes);
+    if (options?.onlyScheme && securitySchemes[options.onlyScheme]) {
+        entries = entries.filter(([name]) => name === options.onlyScheme);
+    }
+    // Renaming the credential env var is only unambiguous for a single emitted,
+    // single-secret scheme. Apply it to the chosen scheme, or the sole scheme.
+    const renameTarget = options?.envVarName !== undefined
+        ? (options.onlyScheme ?? (entries.length === 1 ? entries[0][0] : undefined))
+        : undefined;
+    for (const [name, scheme] of entries) {
+        if (scheme.type === 'apiKey') {
+            const envVarName = name === renameTarget ? options.envVarName : 'API_KEY';
+            authSchemes.push({
+                type: 'apiKey',
+                envVarName,
+                headerName: scheme.name,
+                in: scheme.in,
+                description: `API key for ${name}`,
+            });
+            envVars.push({
+                name: envVarName,
+                description: `API key (sent as ${scheme.in} "${scheme.name}")`,
+                required: true,
+            });
+        }
+        else if (scheme.type === 'http' && scheme.scheme === 'bearer') {
+            const envVarName = name === renameTarget ? options.envVarName : 'BEARER_TOKEN';
+            authSchemes.push({
+                type: 'http-bearer',
+                envVarName,
+                description: `Bearer token for ${name}`,
+            });
+            envVars.push({
+                name: envVarName,
+                description: 'Bearer authentication token',
+                required: true,
+            });
+        }
+        else if (scheme.type === 'http' && scheme.scheme === 'basic') {
+            authSchemes.push({
+                type: 'http-basic',
+                envVarName: 'BASIC_USERNAME',
+                description: `Basic auth for ${name}`,
+            });
+            envVars.push({ name: 'BASIC_USERNAME', description: 'Basic auth username', required: true }, { name: 'BASIC_PASSWORD', description: 'Basic auth password', required: true });
+        }
+        else if (scheme.type === 'oauth2') {
+            authSchemes.push({
+                type: 'oauth2',
+                envVarName: 'OAUTH2_CLIENT_ID',
+                description: `OAuth2 for ${name}`,
+            });
+            // Extract flow details
+            const flows = scheme.flows;
+            if (flows?.authorizationCode) {
+                const flow = flows.authorizationCode;
+                oauthFlows.push({
+                    authorizationUrl: flow.authorizationUrl,
+                    tokenUrl: flow.tokenUrl,
+                    scopes: Object.keys(flow.scopes ?? {}),
+                    flowType: 'authorizationCode',
+                });
+            }
+            if (flows?.clientCredentials) {
+                const flow = flows.clientCredentials;
+                oauthFlows.push({
+                    tokenUrl: flow.tokenUrl,
+                    scopes: Object.keys(flow.scopes ?? {}),
+                    flowType: 'clientCredentials',
+                });
+            }
+            // Emit OAuth env vars
+            envVars.push({ name: 'OAUTH2_CLIENT_ID', description: 'OAuth2 client ID', required: true }, { name: 'OAUTH2_CLIENT_SECRET', description: 'OAuth2 client secret', required: false }, {
+                name: 'OAUTH2_TOKEN',
+                description: 'Pre-obtained OAuth2 token (alternative to client credentials)',
+                required: false,
+            });
+            if (flows?.authorizationCode) {
+                envVars.push({
+                    name: 'OAUTH2_REDIRECT_URI',
+                    description: 'OAuth2 redirect URI for authorization code flow',
+                    required: false,
+                    example: 'http://localhost:3000/callback',
+                });
+            }
+        }
+    }
+    // Deduplicate env vars by name
+    const seen = new Set();
+    const uniqueEnvVars = envVars.filter((v) => {
+        if (seen.has(v.name))
+            return false;
+        seen.add(v.name);
+        return true;
+    });
+    return { authSchemes, envVars: uniqueEnvVars, oauthFlows };
+}
+//# sourceMappingURL=auth-detector.js.map

package/dist/transformer/auth-detector.js.map

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

package/dist/transformer/catalog-builder.d.ts

@@ -0,0 +1,19 @@
+import type { ToolDefinition } from '../types/index.js';
+export interface CatalogEntry {
+    name: string;
+    title: string;
+    description: string;
+    method: string;
+    path: string;
+    inputSchema: Record<string, unknown>;
+    pathParams: string[];
+    queryParams: string[];
+    hasRequestBody: boolean;
+    requestBodyContentType: string;
+}
+/**
+ * Build a tool catalog JSON from tool definitions.
+ * Used by dynamic discovery mode to avoid registering all tools upfront.
+ */
+export declare function buildCatalog(tools: ToolDefinition[]): CatalogEntry[];
+//# sourceMappingURL=catalog-builder.d.ts.map

package/dist/transformer/catalog-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-builder.d.ts","sourceRoot":"","sources":["../../src/transformer/catalog-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAapE"}

package/dist/transformer/catalog-builder.js

@@ -0,0 +1,57 @@
+/**
+ * Build a tool catalog JSON from tool definitions.
+ * Used by dynamic discovery mode to avoid registering all tools upfront.
+ */
+export function buildCatalog(tools) {
+    return tools.map((tool) => ({
+        name: tool.name,
+        title: tool.title,
+        description: tool.description,
+        method: tool.method,
+        path: tool.pathTemplate,
+        inputSchema: parseInputSchema(tool.inputSchemaCode),
+        pathParams: tool.pathParams,
+        queryParams: tool.queryParams,
+        hasRequestBody: tool.hasRequestBody,
+        requestBodyContentType: tool.requestBodyContentType,
+    }));
+}
+/**
+ * Parse the Zod code string into a JSON Schema-like object for the catalog.
+ * This is a best-effort conversion for display purposes.
+ */
+function parseInputSchema(zodCode) {
+    // Extract field names and types from the Zod code
+    const fields = {};
+    const fieldPattern = /(\w+):\s*z\.(\w+)/g;
+    let match;
+    while ((match = fieldPattern.exec(zodCode)) !== null) {
+        fields[match[1]] = match[2];
+    }
+    if (Object.keys(fields).length === 0) {
+        return { type: 'object', properties: {} };
+    }
+    const properties = {};
+    for (const [name, type] of Object.entries(fields)) {
+        properties[name] = { type: mapZodType(type) };
+    }
+    return { type: 'object', properties };
+}
+function mapZodType(zodType) {
+    switch (zodType) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'int':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'array':
+            return 'array';
+        case 'object':
+            return 'object';
+        default:
+            return 'string';
+    }
+}
+//# sourceMappingURL=catalog-builder.js.map

package/dist/transformer/catalog-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-builder.js","sourceRoot":"","sources":["../../src/transformer/catalog-builder.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,YAAY;QACvB,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC;QACnD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;KACpD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,kDAAkD;IAClD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,oBAAoB,CAAC;IAC1C,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK;YACR,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/transformer/client-compat.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from '../types/index.js';
+export type ClientMode = 'cursor' | 'claude' | 'openai';
+/**
+ * Apply client-specific compatibility transforms to tool definitions.
+ */
+export declare function applyClientCompat(tools: ToolDefinition[], client: ClientMode): ToolDefinition[];
+//# sourceMappingURL=client-compat.d.ts.map

package/dist/transformer/client-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-compat.d.ts","sourceRoot":"","sources":["../../src/transformer/client-compat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAaxD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,EAAE,CA2C/F"}

package/dist/transformer/client-compat.js

@@ -0,0 +1,45 @@
+import { logger } from '../utils/logger.js';
+const CLIENT_LIMITS = {
+    cursor: { maxToolNameLength: 60, maxTools: 40 },
+    claude: { maxToolNameLength: 128, maxTools: 1000 },
+    openai: { maxToolNameLength: 128, maxTools: 128 },
+};
+/**
+ * Apply client-specific compatibility transforms to tool definitions.
+ */
+export function applyClientCompat(tools, client) {
+    const limits = CLIENT_LIMITS[client];
+    let result = tools.map((t) => ({ ...t }));
+    // Truncate tool names to client limit
+    const renamed = new Map();
+    for (const tool of result) {
+        if (tool.name.length > limits.maxToolNameLength) {
+            const original = tool.name;
+            tool.name = tool.name.slice(0, limits.maxToolNameLength);
+            renamed.set(original, tool.name);
+        }
+    }
+    // Deduplicate after truncation
+    const nameCount = new Map();
+    for (const t of result) {
+        nameCount.set(t.name, (nameCount.get(t.name) ?? 0) + 1);
+    }
+    for (const tool of result) {
+        if ((nameCount.get(tool.name) ?? 0) > 1) {
+            // Append a hash suffix to make unique, staying within limit
+            const suffix = `_${tool.method}`;
+            const maxBase = limits.maxToolNameLength - suffix.length;
+            tool.name = tool.name.slice(0, maxBase) + suffix;
+        }
+    }
+    if (renamed.size > 0) {
+        logger.warn(`[${client}] Truncated ${renamed.size} tool name(s) to ${limits.maxToolNameLength} chars`);
+    }
+    // Enforce max tool count
+    if (result.length > limits.maxTools) {
+        logger.warn(`[${client}] Tool count (${result.length}) exceeds limit (${limits.maxTools}). Keeping first ${limits.maxTools}.`);
+        result = result.slice(0, limits.maxTools);
+    }
+    return result;
+}
+//# sourceMappingURL=client-compat.js.map

package/dist/transformer/client-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-compat.js","sourceRoot":"","sources":["../../src/transformer/client-compat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAS5C,MAAM,aAAa,GAAqC;IACtD,MAAM,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC/C,MAAM,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClD,MAAM,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,MAAkB;IAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C,sCAAsC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,4DAA4D;YAC5D,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;YACzD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;QACnD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CACT,IAAI,MAAM,eAAe,OAAO,CAAC,IAAI,oBAAoB,MAAM,CAAC,iBAAiB,QAAQ,CAC1F,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,IAAI,MAAM,iBAAiB,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,QAAQ,oBAAoB,MAAM,CAAC,QAAQ,GAAG,CAClH,CAAC;QACF,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/transformer/har-clusterer.d.ts

@@ -0,0 +1,10 @@
+import type { NormalizedEntry } from '../parser/har-normalizer.js';
+export interface EntryCluster {
+    signature: string;
+    method: string;
+    normalizedPath: string;
+    baseUrl: string;
+    entries: NormalizedEntry[];
+}
+export declare function clusterEntries(entries: NormalizedEntry[]): EntryCluster[];
+//# sourceMappingURL=har-clusterer.d.ts.map

package/dist/transformer/har-clusterer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-clusterer.d.ts","sourceRoot":"","sources":["../../src/transformer/har-clusterer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,CA4BzE"}

package/dist/transformer/har-clusterer.js

@@ -0,0 +1,28 @@
+export function clusterEntries(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const method = entry.entry.request.method.toUpperCase();
+        const signature = `${method} ${entry.normalizedPath}`;
+        const existing = groups.get(signature);
+        if (existing) {
+            existing.push(entry);
+        }
+        else {
+            groups.set(signature, [entry]);
+        }
+    }
+    const clusters = [];
+    for (const [signature, clusterEntries] of groups) {
+        const [method, ...pathParts] = signature.split(' ');
+        const normalizedPath = pathParts.join(' ');
+        clusters.push({
+            signature,
+            method: method.toLowerCase(),
+            normalizedPath,
+            baseUrl: clusterEntries[0].baseUrl,
+            entries: clusterEntries,
+        });
+    }
+    return clusters;
+}
+//# sourceMappingURL=har-clusterer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"har-clusterer.js","sourceRoot":"","sources":["../../src/transformer/har-clusterer.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,cAAc,CAAC,OAA0B;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,MAAM,EAAE,CAAC;QACjD,MAAM,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,cAAc;YACd,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO;YAClC,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/transformer/har-dedup.d.ts

@@ -0,0 +1,11 @@
+import type { NormalizedEntry } from '../parser/har-normalizer.js';
+/**
+ * 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 declare function deduplicateEntries(entries: NormalizedEntry[]): NormalizedEntry[];
+//# sourceMappingURL=har-dedup.d.ts.map

package/dist/transformer/har-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-dedup.d.ts","sourceRoot":"","sources":["../../src/transformer/har-dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAoChF"}