@mcpmake/core 0.2.0

package/dist/transformer/operation-filter.js

@@ -0,0 +1,53 @@
+/**
+ * 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 function filterOperations(operations, options) {
+    let result = operations;
+    if (options.include?.length) {
+        result = result.filter((op) => options.include.some((pattern) => matchesOperation(op, pattern)));
+    }
+    if (options.exclude?.length) {
+        result = result.filter((op) => !options.exclude.some((pattern) => matchesOperation(op, pattern)));
+    }
+    return result;
+}
+function matchesOperation(op, pattern) {
+    const lowerPattern = pattern.toLowerCase();
+    // Check tag match
+    if (op.tags.some((t) => t.toLowerCase() === lowerPattern))
+        return true;
+    // Check path match with simple glob support
+    if (matchGlob(op.path.toLowerCase(), lowerPattern))
+        return true;
+    // Check operationId match
+    if (op.operationId.toLowerCase().includes(lowerPattern))
+        return true;
+    return false;
+}
+function matchGlob(str, pattern) {
+    // Simple glob matching without regex to avoid ReDoS.
+    // Split pattern by '*' and check that all parts appear in order.
+    const parts = pattern.split('*');
+    let pos = 0;
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (part === '')
+            continue;
+        const idx = str.indexOf(part, pos);
+        if (idx === -1)
+            return false;
+        // First segment must match at start, last at end
+        if (i === 0 && idx !== 0)
+            return false;
+        pos = idx + part.length;
+    }
+    // If pattern doesn't end with *, the string must end at pos
+    if (!pattern.endsWith('*') && pos !== str.length)
+        return false;
+    return true;
+}
+//# sourceMappingURL=operation-filter.js.map

package/dist/transformer/operation-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-filter.js","sourceRoot":"","sources":["../../src/transformer/operation-filter.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAiC,EACjC,OAAsB;IAEtB,IAAI,MAAM,GAAG,UAAU,CAAC;IAExB,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC5B,OAAO,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAuB,EAAE,OAAe;IAChE,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,kBAAkB;IAClB,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvE,4CAA4C;IAC5C,IAAI,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhE,0BAA0B;IAC1B,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAErE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,OAAe;IAC7C,qDAAqD;IACrD,iEAAiE;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAE1B,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7B,iDAAiD;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE/D,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { OperationDescriptor } from '../types/index.js';
+import type { ResourceDefinition, PromptDefinition } from '../types/index.js';
+/**
+ * Generate MCP resources from GET operations.
+ * - List endpoints (no path params) → static resources
+ * - Detail endpoints (with path params) → URI template resources
+ */
+export declare function buildResources(operations: OperationDescriptor[]): ResourceDefinition[];
+/**
+ * Generate MCP prompts — one per tag as a "workflow" prompt.
+ */
+export declare function buildPrompts(operations: OperationDescriptor[]): PromptDefinition[];
+//# sourceMappingURL=resource-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-builder.d.ts","sourceRoot":"","sources":["../../src/transformer/resource-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ9E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CAyDtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,gBAAgB,EAAE,CAyBlF"}

package/dist/transformer/resource-builder.js

@@ -0,0 +1,87 @@
+import { escapeTemplateLiteral, escapeStringLiteral, sanitizeIdentifier, } from '../utils/sanitize.js';
+import { toToolName } from './naming.js';
+/**
+ * Generate MCP resources from GET operations.
+ * - List endpoints (no path params) → static resources
+ * - Detail endpoints (with path params) → URI template resources
+ */
+export function buildResources(operations) {
+    const resources = [];
+    for (const op of operations) {
+        // Operations dropped from the tool surface (x-mcp-emit: skip) must not leak
+        // back in as resources — mirror buildAllTools' skip handling.
+        if (op.mcpExtensions?.emit === 'skip')
+            continue;
+        if (op.method !== 'get')
+            continue;
+        const name = toToolName(op.operationId);
+        const description = escapeTemplateLiteral(op.summary ?? `${op.method.toUpperCase()} ${op.path}`);
+        if (!op.path.includes('{')) {
+            // Static resource — list endpoint
+            resources.push({
+                name,
+                uri: `api://${name}`,
+                path: op.path,
+                description,
+            });
+        }
+        else {
+            // Template resource — detail endpoint with path params
+            const pathParams = op.parameters.filter((p) => p.in === 'path').map((p) => p.name);
+            const uriTemplate = `api://${name}/${pathParams.map((p) => `{${p}}`).join('/')}`;
+            // Pre-compute URL body to avoid Handlebars/curly-brace conflicts.
+            // Resource handler receives (uri: URL, extra) — extract params from uri.pathname.
+            const urlLines = [];
+            urlLines.push(`      const pathParts = uri.pathname.split('/').filter(Boolean);`);
+            urlLines.push(`      let url = \`\${config.baseUrl}${escapeStringLiteral(op.path)}\`;`);
+            // Replace path params using positional extraction from the URI
+            const pathSegments = op.path.split('/').filter(Boolean);
+            for (let i = 0; i < pathSegments.length; i++) {
+                const seg = pathSegments[i];
+                if (seg.startsWith('{') && seg.endsWith('}')) {
+                    const safe = sanitizeIdentifier(seg.slice(1, -1));
+                    urlLines.push(`      if (pathParts[${i}]) url = url.replace('${escapeStringLiteral(seg)}', encodeURIComponent(pathParts[${i}]));`);
+                }
+            }
+            resources.push({
+                name,
+                uri: uriTemplate,
+                path: op.path,
+                description,
+                isTemplate: true,
+                templateParams: pathParams,
+                urlBody: urlLines.join('\n'),
+            });
+        }
+    }
+    return resources;
+}
+/**
+ * Generate MCP prompts — one per tag as a "workflow" prompt.
+ */
+export function buildPrompts(operations) {
+    const tagGroups = new Map();
+    for (const op of operations) {
+        if (op.mcpExtensions?.emit === 'skip')
+            continue;
+        const tag = op.tags[0] ?? 'default';
+        const existing = tagGroups.get(tag);
+        if (existing)
+            existing.push(op);
+        else
+            tagGroups.set(tag, [op]);
+    }
+    const prompts = [];
+    for (const [tag, ops] of tagGroups) {
+        const toolList = ops
+            .map((op) => `- ${toToolName(op.operationId)}: ${op.summary ?? op.path}`)
+            .join('\\n');
+        prompts.push({
+            name: `${tag}_workflow`,
+            description: escapeTemplateLiteral(`Work with ${tag} — available operations`),
+            template: escapeTemplateLiteral(`You have the following ${tag} tools available:\\n${toolList}\\n\\nWhat would you like to do?`),
+        });
+    }
+    return prompts;
+}
+//# sourceMappingURL=resource-builder.js.map

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

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

package/dist/transformer/schema-merger.d.ts

@@ -0,0 +1,15 @@
+import type { JsonSchema } from '../types/index.js';
+/**
+ * Merge multiple JSON schemas into one that covers all observed fields.
+ * Uses a union approach: if a field appears in any sample, it's included
+ * (marked optional if not present in all samples).
+ */
+export declare function mergeSchemas(schemas: JsonSchema[]): JsonSchema;
+/**
+ * Merge request body schemas from multiple HAR entries in a cluster.
+ */
+export declare function mergeRequestBodySchemas(bodies: Array<{
+    text: string;
+    mimeType: string;
+}>): JsonSchema | undefined;
+//# sourceMappingURL=schema-merger.d.ts.map

package/dist/transformer/schema-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-merger.d.ts","sourceRoot":"","sources":["../../src/transformer/schema-merger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CA2C9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,UAAU,GAAG,SAAS,CAcxB"}

package/dist/transformer/schema-merger.js

@@ -0,0 +1,66 @@
+import { inferJsonSchema } from './har-schema-inferrer.js';
+/**
+ * Merge multiple JSON schemas into one that covers all observed fields.
+ * Uses a union approach: if a field appears in any sample, it's included
+ * (marked optional if not present in all samples).
+ */
+export function mergeSchemas(schemas) {
+    if (schemas.length === 0)
+        return { type: 'object' };
+    if (schemas.length === 1)
+        return schemas[0];
+    // Only merge object schemas
+    if (!schemas.every((s) => s.type === 'object'))
+        return schemas[0];
+    const allProperties = new Map();
+    const requiredCounts = new Map();
+    for (const schema of schemas) {
+        const props = (schema.properties ?? {});
+        const required = new Set(schema.required ?? []);
+        for (const [key, propSchema] of Object.entries(props)) {
+            const existing = allProperties.get(key);
+            if (existing)
+                existing.push(propSchema);
+            else
+                allProperties.set(key, [propSchema]);
+            if (required.has(key)) {
+                requiredCounts.set(key, (requiredCounts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    const mergedProperties = {};
+    const mergedRequired = [];
+    for (const [key, propSchemas] of allProperties) {
+        // Use the most common type
+        mergedProperties[key] = propSchemas[0];
+        // Only required if present in ALL samples
+        if ((requiredCounts.get(key) ?? 0) === schemas.length) {
+            mergedRequired.push(key);
+        }
+    }
+    return {
+        type: 'object',
+        properties: mergedProperties,
+        ...(mergedRequired.length > 0 ? { required: mergedRequired } : {}),
+    };
+}
+/**
+ * Merge request body schemas from multiple HAR entries in a cluster.
+ */
+export function mergeRequestBodySchemas(bodies) {
+    const schemas = [];
+    for (const body of bodies) {
+        if (!body.text || !body.mimeType.includes('json'))
+            continue;
+        try {
+            schemas.push(inferJsonSchema(JSON.parse(body.text)));
+        }
+        catch {
+            continue;
+        }
+    }
+    if (schemas.length === 0)
+        return undefined;
+    return mergeSchemas(schemas);
+}
+//# sourceMappingURL=schema-merger.js.map

package/dist/transformer/schema-merger.js.map

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

package/dist/transformer/stainless-config.d.ts

@@ -0,0 +1,75 @@
+export type StainlessMethodValue = string | {
+    endpoint?: string;
+    operationId?: string;
+    operation_id?: string;
+    method?: string;
+    path?: string;
+    mcp?: boolean | {
+        enabled?: boolean;
+    };
+    skip?: boolean;
+    paginated?: unknown;
+    [k: string]: unknown;
+};
+export interface StainlessResource {
+    methods?: Record<string, StainlessMethodValue>;
+    subresources?: Record<string, StainlessResource>;
+    models?: Record<string, string>;
+    [k: string]: unknown;
+}
+export interface StainlessOpt {
+    type?: string;
+    /** Custom env-var name the SDK/MCP reads the secret from (e.g. `ACME_API_KEY`). */
+    read_env?: string;
+    auth?: {
+        security_scheme?: string;
+        role?: string;
+    };
+    [k: string]: unknown;
+}
+export interface StainlessMcpServer {
+    /** Stainless's current default: a 2-tool code-execution + docs-search server. */
+    code?: boolean;
+    code_execution?: boolean;
+    tools?: string | string[];
+    docs_search?: boolean;
+    [k: string]: unknown;
+}
+export interface StainlessConfig {
+    'config-version'?: number;
+    organization?: string;
+    /** Path to the referenced OpenAPI document. */
+    openapi?: string | {
+        path?: string;
+        spec?: string;
+    };
+    spec?: string;
+    /** Named base URLs: { production: "https://...", sandbox: "https://..." }. */
+    environments?: Record<string, string>;
+    client_settings?: {
+        opts?: Record<string, StainlessOpt>;
+        [k: string]: unknown;
+    };
+    security?: unknown;
+    resources?: Record<string, StainlessResource>;
+    settings?: {
+        /** Auto-unwrap a nested response envelope. `true` => `data`, or a prop name. */
+        unwrap_response?: boolean | string;
+        [k: string]: unknown;
+    };
+    targets?: Record<string, unknown>;
+    mcp_server?: StainlessMcpServer;
+    [k: string]: unknown;
+}
+/**
+ * Parse a `stainless.yml` (YAML, with a JSON fallback). Throws a clear error on
+ * malformed input or a non-object document.
+ */
+export declare function parseStainlessConfig(raw: string): StainlessConfig;
+/**
+ * Resolve the OpenAPI spec the Stainless config points at, relative to the
+ * config file's directory. An explicit `override` (the CLI `--spec` flag) wins.
+ * Returns `undefined` when neither the config nor the override names a spec.
+ */
+export declare function resolveSpecPath(config: StainlessConfig, configPath: string, override?: string): string | undefined;
+//# sourceMappingURL=stainless-config.d.ts.map

package/dist/transformer/stainless-config.d.ts.map

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

package/dist/transformer/stainless-config.js

@@ -0,0 +1,59 @@
+/**
+ * Parsing + typing for a Stainless `stainless.yml` (openapi-stainless) config.
+ *
+ * Stainless was acquired by Anthropic (~May 2026) and its hosted MCP generator
+ * is winding down. This module reads the build config a Stainless user already
+ * has so `mcpmake from stainless` can reproduce the equivalent — owned, editable
+ * — MCP server. We only model the keys that affect the MCP tool surface or that
+ * the importer translates; everything else is ignored (forward-compatible).
+ */
+import { resolve, dirname, isAbsolute } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Parse a `stainless.yml` (YAML, with a JSON fallback). Throws a clear error on
+ * malformed input or a non-object document.
+ */
+export function parseStainlessConfig(raw) {
+    let doc;
+    try {
+        doc = parseYaml(raw);
+    }
+    catch {
+        // `yaml` accepts JSON too, but fall back explicitly for robustness.
+        try {
+            doc = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Could not parse Stainless config: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (!doc || typeof doc !== 'object' || Array.isArray(doc)) {
+        throw new Error('Stainless config must be a YAML/JSON object.');
+    }
+    return doc;
+}
+/**
+ * Resolve the OpenAPI spec the Stainless config points at, relative to the
+ * config file's directory. An explicit `override` (the CLI `--spec` flag) wins.
+ * Returns `undefined` when neither the config nor the override names a spec.
+ */
+export function resolveSpecPath(config, configPath, override) {
+    if (override)
+        return override;
+    let ref;
+    if (typeof config.openapi === 'string') {
+        ref = config.openapi;
+    }
+    else if (config.openapi && typeof config.openapi === 'object') {
+        ref = config.openapi.path ?? config.openapi.spec;
+    }
+    ref = ref ?? config.spec;
+    if (!ref)
+        return undefined;
+    // Leave URLs and absolute paths untouched; resolve relative paths against the
+    // config file's directory (the conventional Stainless layout).
+    if (/^https?:\/\//i.test(ref) || isAbsolute(ref))
+        return ref;
+    return resolve(dirname(configPath), ref);
+}
+//# sourceMappingURL=stainless-config.js.map

package/dist/transformer/stainless-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stainless-config.js","sourceRoot":"","sources":["../../src/transformer/stainless-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAoE1C;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAsB,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAuB,EACvB,UAAkB,EAClB,QAAiB;IAEjB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,GAAuB,CAAC;IAC5B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChE,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,CAAC;IACD,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,8EAA8E;IAC9E,+DAA+D;IAC/D,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7D,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC"}

package/dist/transformer/stainless-translator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Translate a parsed Stainless config into mcpmake's overlay model by mutating
+ * the in-memory OpenAPI document, then return the structural knobs the command
+ * threads into generation (base URL / environments / auth override) plus a
+ * human-readable migration report.
+ *
+ * The mutation strategy is deliberate: mcpmake already honours `x-mcp-*`
+ * operation extensions (see `parser/operation-extractor.ts`), so injecting them
+ * onto the spec before extraction is the lowest-risk way to reproduce Stainless
+ * behaviour without a parallel override pipeline. Everything here is pure data —
+ * the only side effect is setting string-valued `x-mcp-*` keys on operations.
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+import type { StainlessConfig } from './stainless-config.js';
+export interface AuthOverride {
+    /** Pin the generated server to this OpenAPI security scheme (vs. emitting all). */
+    schemeName?: string;
+    /** Read the credential from this env var instead of mcpmake's default name. */
+    envVarName?: string;
+}
+export interface StainlessTranslation {
+    /** Map of `METHOD /path` → derived tool name, for the report and tests. */
+    toolNames: Record<string, string>;
+    /** Named base URLs to seed into the generated `MCP_ENVIRONMENTS`. */
+    environments?: Record<string, string>;
+    /** The environment selected by default (e.g. `production`). */
+    defaultEnvironment?: string;
+    /** Base URL chosen from the default environment (overrides the spec's). */
+    baseUrl?: string;
+    authOverride?: AuthOverride;
+    /** `METHOD /path` keys whose response was given an unwrap `jq` filter. */
+    unwrapped: string[];
+    /** `METHOD /path` keys dropped from the MCP tool surface. */
+    skipped: string[];
+    /** Stainless's 2-tool code-execution default was detected. */
+    codeMode: boolean;
+    docsSearch: boolean;
+    warnings: string[];
+    report: string[];
+}
+/**
+ * Mutates `api` in place (adding `x-mcp-*` extensions) and returns the derived
+ * generation knobs + migration report.
+ */
+export declare function translateStainless(config: StainlessConfig, api: OpenAPIV3.Document): StainlessTranslation;
+/**
+ * Reproduce Stainless's resource-tree tool naming: the SDK call
+ * `<resource>.<method>` becomes the tool `<method>_<singular resource chain>`,
+ * child-first — e.g. `cards.issuing.create` → `create_issuing_card`.
+ */
+export declare function toolNameFromTree(methodName: string, chain: string[]): string;
+export declare function singularize(word: string): string;
+/**
+ * Coerce a Stainless `read_env` value into a valid POSIX-style env-var name so
+ * it is safe to emit as `process.env.<name>` / `os.environ.get("<name>")` in the
+ * generated code. (Real read_env values already look like `ACME_API_KEY`; this
+ * just guarantees an odd one can't produce invalid source.) Returns undefined
+ * when nothing usable remains.
+ */
+export declare function sanitizeEnvVarName(raw: string): string | undefined;
+//# sourceMappingURL=stainless-translator.d.ts.map

package/dist/transformer/stainless-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stainless-translator.d.ts","sourceRoot":"","sources":["../../src/transformer/stainless-translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,SAAS,CAAC,QAAQ,GACtB,oBAAoB,CAwLtB;AA+HD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAK5E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AA6DD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE"}