mcp4openapi 0.1.0

package/dist/src/testing/test-types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Type definitions for test data
+ *
+ * Why: Avoid 'as any' casts in tests, improve type safety
+ */
+export interface Badge {
+    id: number;
+    name: string;
+    link_url: string;
+    image_url: string;
+    rendered_link_url?: string;
+    rendered_image_url?: string;
+}
+export interface Branch {
+    name: string;
+    default: boolean;
+    protected: boolean;
+    can_push?: boolean;
+    developers_can_push?: boolean;
+    developers_can_merge?: boolean;
+}
+export interface AccessRequest {
+    id: number;
+    username: string;
+    name: string;
+    state: string;
+    created_at: string;
+    requested_at: string;
+    access_level?: number;
+}
+export interface Job {
+    id: number;
+    status: string;
+    stage: string;
+    name: string;
+    ref: string;
+    created_at: string;
+    started_at?: string;
+    finished_at?: string;
+    duration?: number;
+    user?: {
+        id: number;
+        name: string;
+        username: string;
+    };
+}
+export interface MergeRequest {
+    id: number;
+    iid: number;
+    title: string;
+    description?: string;
+    state: string;
+    web_url: string;
+    author: {
+        id: number;
+        name: string;
+        username: string;
+    };
+    source_branch: string;
+    target_branch: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CompositeResult {
+    data: Record<string, unknown>;
+    completed_steps: number;
+    total_steps: number;
+    errors?: Array<{
+        step: string;
+        error: string;
+    }>;
+}
+export type McpToolResult = Badge[] | Badge | Branch[] | Branch | AccessRequest[] | AccessRequest | Job[] | Job | MergeRequest[] | MergeRequest | CompositeResult | {
+    status: string;
+};
+//# sourceMappingURL=test-types.d.ts.map

package/dist/src/testing/test-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-types.d.ts","sourceRoot":"","sources":["../../../src/testing/test-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,aAAa,GACrB,KAAK,EAAE,GACP,KAAK,GACL,MAAM,EAAE,GACR,MAAM,GACN,aAAa,EAAE,GACf,aAAa,GACb,GAAG,EAAE,GACL,GAAG,GACH,YAAY,EAAE,GACd,YAAY,GACZ,eAAe,GACf;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/src/testing/test-types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for test data
+ *
+ * Why: Avoid 'as any' casts in tests, improve type safety
+ */
+export {};
+//# sourceMappingURL=test-types.js.map

package/dist/src/testing/test-types.js.map

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

package/dist/src/tool-generator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MCP tool generator from profile definitions
+ *
+ * Why: Translates profile config into MCP SDK tool definitions. Handles both
+ * simple (single operation) and composite (multi-step) tools.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolDefinition } from './types/profile.js';
+import type { OpenAPIParser } from './openapi-parser.js';
+export declare class ToolGenerator {
+    private parser;
+    constructor(parser: OpenAPIParser);
+    /**
+     * Generate MCP tool from profile definition
+     */
+    generateTool(toolDef: ToolDefinition): Tool;
+    /**
+     * Generate JSON Schema for tool parameters
+     *
+     * Why JSON Schema: MCP SDK expects JSON Schema for parameter validation.
+     * LLM uses schema to understand what parameters are needed.
+     */
+    private generateInputSchema;
+    /**
+     * Convert parameter definition to JSON Schema
+     */
+    private parameterToJsonSchema;
+    /**
+     * Validate tool arguments against parameter definitions
+     *
+     * Why manual validation: Checks conditional requirements (required_for)
+     * which JSON Schema can't express directly.
+     */
+    validateArguments(toolDef: ToolDefinition, args: Record<string, unknown>): void;
+    /**
+     * Map tool action to OpenAPI operation ID
+     *
+     * Why: Single tool with 'action' parameter maps to multiple operations.
+     * Example: manage_badges + action=create => postApiV4ProjectsIdBadges
+     */
+    mapActionToOperation(toolDef: ToolDefinition, args: Record<string, unknown>): string | undefined;
+}
+//# sourceMappingURL=tool-generator.d.ts.map

package/dist/src/tool-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-generator.d.ts","sourceRoot":"","sources":["../../src/tool-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAU3C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IA4B/E;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS;CAwBjG"}

package/dist/src/tool-generator.js

@@ -0,0 +1,123 @@
+/**
+ * MCP tool generator from profile definitions
+ *
+ * Why: Translates profile config into MCP SDK tool definitions. Handles both
+ * simple (single operation) and composite (multi-step) tools.
+ */
+export class ToolGenerator {
+    parser;
+    constructor(parser) {
+        this.parser = parser;
+    }
+    /**
+     * Generate MCP tool from profile definition
+     */
+    generateTool(toolDef) {
+        const inputSchema = this.generateInputSchema(toolDef);
+        return {
+            name: toolDef.name,
+            description: toolDef.description,
+            inputSchema,
+        };
+    }
+    /**
+     * Generate JSON Schema for tool parameters
+     *
+     * Why JSON Schema: MCP SDK expects JSON Schema for parameter validation.
+     * LLM uses schema to understand what parameters are needed.
+     */
+    generateInputSchema(toolDef) {
+        const properties = {};
+        const required = [];
+        for (const [name, param] of Object.entries(toolDef.parameters)) {
+            properties[name] = this.parameterToJsonSchema(param);
+            // Add to required if unconditionally required
+            if (param.required) {
+                required.push(name);
+            }
+            // Add conditional requirement hints in description
+            if (param.required_for && param.required_for.length > 0) {
+                const existing = properties[name].description || '';
+                properties[name].description = existing +
+                    ` Required when action is: ${param.required_for.join(', ')}.`;
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    /**
+     * Convert parameter definition to JSON Schema
+     */
+    parameterToJsonSchema(param) {
+        const schema = {
+            type: param.type,
+            description: param.description,
+        };
+        if (param.enum) {
+            schema.enum = param.enum;
+        }
+        if (param.default !== undefined) {
+            schema.default = param.default;
+        }
+        if (param.type === 'array' && param.items) {
+            schema.items = { type: param.items.type };
+        }
+        return schema;
+    }
+    /**
+     * Validate tool arguments against parameter definitions
+     *
+     * Why manual validation: Checks conditional requirements (required_for)
+     * which JSON Schema can't express directly.
+     */
+    validateArguments(toolDef, args) {
+        for (const [name, param] of Object.entries(toolDef.parameters)) {
+            const value = args[name];
+            // Check unconditional required
+            if (param.required && value === undefined) {
+                throw new Error(`Missing required parameter: ${name}`);
+            }
+            // Check conditional required
+            if (param.required_for && param.required_for.length > 0) {
+                const action = args['action'];
+                if (action && param.required_for.includes(action) && value === undefined) {
+                    throw new Error(`Parameter '${name}' is required for action '${action}'`);
+                }
+            }
+            // Validate enum
+            if (value !== undefined && param.enum && !param.enum.includes(String(value))) {
+                throw new Error(`Invalid value for ${name}. Must be one of: ${param.enum.join(', ')}`);
+            }
+        }
+    }
+    /**
+     * Map tool action to OpenAPI operation ID
+     *
+     * Why: Single tool with 'action' parameter maps to multiple operations.
+     * Example: manage_badges + action=create => postApiV4ProjectsIdBadges
+     */
+    mapActionToOperation(toolDef, args) {
+        if (!toolDef.operations)
+            return undefined;
+        const action = args['action'];
+        if (!action) {
+            // If single operation, use it directly
+            const operations = Object.values(toolDef.operations);
+            return operations.length === 1 ? operations[0] : undefined;
+        }
+        // For resource_type discrimination (e.g., project vs group)
+        const resourceType = args['resource_type'];
+        if (resourceType) {
+            // Try resource-specific operation first
+            const key = `${action}_${resourceType}`;
+            if (toolDef.operations[key]) {
+                return toolDef.operations[key];
+            }
+        }
+        return toolDef.operations[action];
+    }
+}
+//# sourceMappingURL=tool-generator.js.map

package/dist/src/tool-generator.js.map

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

package/dist/src/types/http-transport.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Type definitions for HTTP transport
+ *
+ * Based on MCP Specification 2025-03-26
+ * https://modelcontextprotocol.io/specification/2025-03-26/basic/transports
+ */
+import type { Request as ExpressRequest, Response } from 'express';
+export interface SessionData {
+    id: string;
+    createdAt: number;
+    lastActivityAt: number;
+    sseStreams: Map<string, SSEStreamState>;
+    authToken?: string;
+}
+export interface SSEStreamState {
+    streamId: string;
+    lastEventId: number;
+    messageQueue: QueuedMessage[];
+    active: boolean;
+    response: Response;
+}
+export interface QueuedMessage {
+    eventId: number;
+    data: unknown;
+    timestamp: number;
+}
+export interface HttpTransportConfig {
+    host: string;
+    port: number;
+    sessionTimeoutMs: number;
+    heartbeatEnabled: boolean;
+    heartbeatIntervalMs: number;
+    metricsEnabled: boolean;
+    metricsPath: string;
+    allowedOrigins?: string[];
+    rateLimitEnabled?: boolean;
+    rateLimitWindowMs?: number;
+    rateLimitMaxRequests?: number;
+    rateLimitMetricsMax?: number;
+    maxTokenLength?: number;
+}
+export interface McpRequest extends ExpressRequest {
+    sessionId?: string;
+}
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/src/types/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../../src/types/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/types/http-transport.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for HTTP transport
+ *
+ * Based on MCP Specification 2025-03-26
+ * https://modelcontextprotocol.io/specification/2025-03-26/basic/transports
+ */
+export {};
+//# sourceMappingURL=http-transport.js.map

package/dist/src/types/http-transport.js.map

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

package/dist/src/types/openapi.d.ts

@@ -0,0 +1,50 @@
+/**
+ * OpenAPI operational types
+ *
+ * Why simplified: We only need subset of OpenAPI spec for our use case
+ * (operation lookup, parameter extraction, request building). Full OpenAPI
+ * types from openapi-types are too verbose for runtime usage.
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+export interface OpenAPIIndex {
+    spec: OpenAPIV3.Document;
+    operations: Map<string, OperationInfo>;
+    paths: Map<string, PathInfo>;
+}
+export interface OperationInfo {
+    operationId: string;
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    parameters: ParameterInfo[];
+    requestBody?: RequestBodyInfo;
+    tags?: string[];
+}
+export interface PathInfo {
+    path: string;
+    operations: Record<string, OperationInfo>;
+}
+export interface ParameterInfo {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required: boolean;
+    schema: SchemaInfo;
+    description?: string;
+}
+export interface RequestBodyInfo {
+    required: boolean;
+    content: Record<string, {
+        schema: SchemaInfo;
+    }>;
+}
+export interface SchemaInfo {
+    type?: string;
+    format?: string;
+    enum?: unknown[];
+    items?: SchemaInfo;
+    properties?: Record<string, SchemaInfo>;
+    required?: string[];
+    default?: unknown;
+}
+//# sourceMappingURL=openapi.d.ts.map

package/dist/src/types/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/types/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/src/types/openapi.js

@@ -0,0 +1,9 @@
+/**
+ * OpenAPI operational types
+ *
+ * Why simplified: We only need subset of OpenAPI spec for our use case
+ * (operation lookup, parameter extraction, request building). Full OpenAPI
+ * types from openapi-types are too verbose for runtime usage.
+ */
+export {};
+//# sourceMappingURL=openapi.js.map

package/dist/src/types/openapi.js.map

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

package/dist/src/types/profile.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Profile configuration types
+ *
+ * Why these types: Profiles define which MCP tools are exposed and how they map
+ * to OpenAPI operations. This enables same server to serve different use cases
+ * (admin vs developer vs readonly) without code changes.
+ */
+export interface Profile {
+    profile_name: string;
+    description?: string;
+    tools: ToolDefinition[];
+    interceptors?: InterceptorConfig;
+    parameter_aliases?: Record<string, string[]>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    operations?: Record<string, string> | {
+        [key: string]: string;
+    };
+    composite?: boolean;
+    steps?: CompositeStep[];
+    partial_results?: boolean;
+    parameters: Record<string, ParameterDefinition>;
+    metadata_params?: string[];
+    response_fields?: Record<string, string[]>;
+}
+export interface ParameterDefinition {
+    type: 'string' | 'integer' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+    required_for?: string[];
+    enum?: string[];
+    items?: {
+        type: string;
+    };
+    default?: unknown;
+    example?: unknown;
+}
+export interface CompositeStep {
+    call: string;
+    store_as: string;
+    depends_on?: string[];
+}
+export interface InterceptorConfig {
+    auth?: AuthInterceptor;
+    base_url?: BaseUrlConfig;
+    rate_limit?: RateLimitConfig;
+    retry?: RetryConfig;
+    array_format?: 'brackets' | 'indices' | 'repeat' | 'comma';
+}
+/**
+ * Auth interceptor configuration
+ *
+ * - bearer: Standard HTTP Bearer token (Authorization: Bearer <token>)
+ * - query: API key in query string (?api_key=<token>)
+ * - custom-header: Custom header name (e.g., X-API-Key: <token>)
+ */
+export interface AuthInterceptor {
+    type: 'bearer' | 'query' | 'custom-header';
+    header_name?: string;
+    query_param?: string;
+    value_from_env: string;
+}
+export interface BaseUrlConfig {
+    value_from_env: string;
+    default?: string;
+}
+export interface RateLimitConfig {
+    max_requests_per_minute: number;
+    overrides?: Record<string, {
+        max_requests_per_minute: number;
+    }>;
+}
+export interface RetryConfig {
+    max_attempts: number;
+    backoff_ms: number[];
+    retry_on_status: number[];
+}
+//# sourceMappingURL=profile.d.ts.map

package/dist/src/types/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/types/profile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAGpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAGhE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAGhD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,uBAAuB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B"}

package/dist/src/types/profile.js

@@ -0,0 +1,9 @@
+/**
+ * Profile configuration types
+ *
+ * Why these types: Profiles define which MCP tools are exposed and how they map
+ * to OpenAPI operations. This enables same server to serve different use cases
+ * (admin vs developer vs readonly) without code changes.
+ */
+export {};
+//# sourceMappingURL=profile.js.map

package/dist/src/types/profile.js.map

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

package/dist/src/validation-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validation utilities for common data types
+ *
+ * Why: Provides reusable validation functions for email, URI, and other formats
+ * Centralizes validation logic and ensures consistency across the application
+ */
+/**
+ * Validates if a string is a valid email address
+ */
+export declare function isEmail(value: string): boolean;
+/**
+ * Validates if a string is a valid URI
+ */
+export declare function isUri(value: string): boolean;
+//# sourceMappingURL=validation-utils.d.ts.map

package/dist/src/validation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../src/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5C"}

package/dist/src/validation-utils.js

@@ -0,0 +1,25 @@
+/**
+ * Validation utilities for common data types
+ *
+ * Why: Provides reusable validation functions for email, URI, and other formats
+ * Centralizes validation logic and ensures consistency across the application
+ */
+/**
+ * Validates if a string is a valid email address
+ */
+export function isEmail(value) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+/**
+ * Validates if a string is a valid URI
+ */
+export function isUri(value) {
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validation-utils.js.map

package/dist/src/validation-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.js","sourceRoot":"","sources":["../../src/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}