mcp4openapi 0.1.0

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAA6B,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAU;IAGzB,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,mBAAmB,CAAY;IAGvC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,sBAAsB,CAAU;IAGxC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,iBAAiB,CAAU;IAGnC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,aAAa,CAAU;gBAEnB,MAAM,EAAE,sBAAsB;IAwF1C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAmB9F;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAM5B;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAM9B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAOxF;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAK1D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAS/E;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAOnC;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAOvB"}

package/dist/metrics.js

@@ -0,0 +1,229 @@
+/**
+ * Prometheus Metrics Collector
+ *
+ * Why: Observability for production deployments
+ *
+ * Tracks:
+ * - HTTP requests (status, method, path)
+ * - Session lifecycle (active, created, destroyed)
+ * - MCP operations (tool calls, duration, errors)
+ * - API calls to backend (operation, status, duration)
+ */
+import { Registry, Counter, Gauge, Histogram } from 'prom-client';
+export class MetricsCollector {
+    registry;
+    enabled;
+    // HTTP metrics
+    httpRequestsTotal;
+    httpRequestDuration;
+    // Session metrics
+    sessionsActive;
+    sessionsCreatedTotal;
+    sessionsDestroyedTotal;
+    // MCP operation metrics
+    mcpToolCallsTotal;
+    mcpToolCallDuration;
+    mcpToolCallErrors;
+    // API metrics (calls to backend API)
+    apiCallsTotal;
+    apiCallDuration;
+    apiCallErrors;
+    constructor(config) {
+        this.enabled = config.enabled;
+        this.registry = new Registry();
+        const prefix = config.prefix || 'mcp_';
+        // HTTP metrics
+        this.httpRequestsTotal = new Counter({
+            name: `${prefix}http_requests_total`,
+            help: 'Total number of HTTP requests',
+            labelNames: ['method', 'path', 'status'],
+            registers: [this.registry],
+        });
+        this.httpRequestDuration = new Histogram({
+            name: `${prefix}http_request_duration_seconds`,
+            help: 'HTTP request duration in seconds',
+            labelNames: ['method', 'path', 'status'],
+            buckets: [0.001, 0.01, 0.05, 0.1, 0.5, 1, 2, 5],
+            registers: [this.registry],
+        });
+        // Session metrics
+        this.sessionsActive = new Gauge({
+            name: `${prefix}sessions_active`,
+            help: 'Number of active sessions',
+            registers: [this.registry],
+        });
+        this.sessionsCreatedTotal = new Counter({
+            name: `${prefix}sessions_created_total`,
+            help: 'Total number of sessions created',
+            registers: [this.registry],
+        });
+        this.sessionsDestroyedTotal = new Counter({
+            name: `${prefix}sessions_destroyed_total`,
+            help: 'Total number of sessions destroyed',
+            registers: [this.registry],
+        });
+        // MCP operation metrics
+        this.mcpToolCallsTotal = new Counter({
+            name: `${prefix}tool_calls_total`,
+            help: 'Total number of MCP tool calls',
+            labelNames: ['tool', 'status'],
+            registers: [this.registry],
+        });
+        this.mcpToolCallDuration = new Histogram({
+            name: `${prefix}tool_call_duration_seconds`,
+            help: 'MCP tool call duration in seconds',
+            labelNames: ['tool', 'status'],
+            buckets: [0.01, 0.05, 0.1, 0.5, 1, 2, 5, 10, 30],
+            registers: [this.registry],
+        });
+        this.mcpToolCallErrors = new Counter({
+            name: `${prefix}tool_call_errors_total`,
+            help: 'Total number of MCP tool call errors',
+            labelNames: ['tool', 'error_type'],
+            registers: [this.registry],
+        });
+        // API metrics
+        this.apiCallsTotal = new Counter({
+            name: `${prefix}api_calls_total`,
+            help: 'Total number of API calls to backend',
+            labelNames: ['operation', 'status'],
+            registers: [this.registry],
+        });
+        this.apiCallDuration = new Histogram({
+            name: `${prefix}api_call_duration_seconds`,
+            help: 'API call duration in seconds',
+            labelNames: ['operation', 'status'],
+            buckets: [0.01, 0.05, 0.1, 0.5, 1, 2, 5, 10],
+            registers: [this.registry],
+        });
+        this.apiCallErrors = new Counter({
+            name: `${prefix}api_call_errors_total`,
+            help: 'Total number of API call errors',
+            labelNames: ['operation', 'error_type'],
+            registers: [this.registry],
+        });
+    }
+    /**
+     * Record HTTP request
+     */
+    recordHttpRequest(method, path, status, durationSeconds) {
+        if (!this.enabled)
+            return;
+        this.httpRequestsTotal.inc({
+            method,
+            path: this.normalizePath(path),
+            status: status.toString(),
+        });
+        this.httpRequestDuration.observe({
+            method,
+            path: this.normalizePath(path),
+            status: status.toString(),
+        }, durationSeconds);
+    }
+    /**
+     * Record session created
+     */
+    recordSessionCreated() {
+        if (!this.enabled)
+            return;
+        this.sessionsCreatedTotal.inc();
+        this.sessionsActive.inc();
+    }
+    /**
+     * Record session destroyed
+     */
+    recordSessionDestroyed() {
+        if (!this.enabled)
+            return;
+        this.sessionsDestroyedTotal.inc();
+        this.sessionsActive.dec();
+    }
+    /**
+     * Record MCP tool call
+     */
+    recordToolCall(tool, status, durationSeconds) {
+        if (!this.enabled)
+            return;
+        this.mcpToolCallsTotal.inc({ tool, status });
+        this.mcpToolCallDuration.observe({ tool, status }, durationSeconds);
+    }
+    /**
+     * Record MCP tool call error
+     */
+    recordToolCallError(tool, errorType) {
+        if (!this.enabled)
+            return;
+        this.mcpToolCallErrors.inc({ tool, error_type: errorType });
+    }
+    /**
+     * Record API call to backend
+     */
+    recordApiCall(operation, status, durationSeconds) {
+        if (!this.enabled)
+            return;
+        const statusLabel = this.getStatusLabel(status);
+        this.apiCallsTotal.inc({ operation, status: statusLabel });
+        this.apiCallDuration.observe({ operation, status: statusLabel }, durationSeconds);
+    }
+    /**
+     * Record API call error
+     */
+    recordApiCallError(operation, errorType) {
+        if (!this.enabled)
+            return;
+        this.apiCallErrors.inc({ operation, error_type: errorType });
+    }
+    /**
+     * Get metrics in Prometheus format
+     */
+    async getMetrics() {
+        if (!this.enabled) {
+            return '# Metrics disabled\n';
+        }
+        return this.registry.metrics();
+    }
+    /**
+     * Get registry (for testing)
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Normalize path for metrics (remove dynamic segments)
+     *
+     * Why: Avoid high cardinality in metrics labels
+     *
+     * Examples:
+     * - /mcp?sessionId=abc123 -> /mcp
+     * - /metrics -> /metrics
+     * - /health -> /health
+     */
+    normalizePath(path) {
+        // Remove query string
+        const pathWithoutQuery = path.split('?')[0];
+        // Known paths
+        if (pathWithoutQuery === '/mcp' ||
+            pathWithoutQuery === '/metrics' ||
+            pathWithoutQuery === '/health') {
+            return pathWithoutQuery;
+        }
+        return pathWithoutQuery;
+    }
+    /**
+     * Get status label (2xx, 4xx, 5xx)
+     *
+     * Why: Group similar statuses to reduce cardinality
+     */
+    getStatusLabel(status) {
+        if (status >= 200 && status < 300)
+            return '2xx';
+        if (status >= 300 && status < 400)
+            return '3xx';
+        if (status >= 400 && status < 500)
+            return '4xx';
+        if (status >= 500 && status < 600)
+            return '5xx';
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOlE,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAW;IACnB,OAAO,CAAU;IAEzB,eAAe;IACP,iBAAiB,CAAU;IAC3B,mBAAmB,CAAY;IAEvC,kBAAkB;IACV,cAAc,CAAQ;IACtB,oBAAoB,CAAU;IAC9B,sBAAsB,CAAU;IAExC,wBAAwB;IAChB,iBAAiB,CAAU;IAC3B,mBAAmB,CAAY;IAC/B,iBAAiB,CAAU;IAEnC,qCAAqC;IAC7B,aAAa,CAAU;IACvB,eAAe,CAAY;IAC3B,aAAa,CAAU;IAE/B,YAAY,MAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;QAEvC,eAAe;QACf,IAAI,CAAC,iBAAiB,GAAG,IAAI,OAAO,CAAC;YACnC,IAAI,EAAE,GAAG,MAAM,qBAAqB;YACpC,IAAI,EAAE,+BAA+B;YACrC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACxC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,GAAG,IAAI,SAAS,CAAC;YACvC,IAAI,EAAE,GAAG,MAAM,+BAA+B;YAC9C,IAAI,EAAE,kCAAkC;YACxC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/C,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,kBAAkB;QAClB,IAAI,CAAC,cAAc,GAAG,IAAI,KAAK,CAAC;YAC9B,IAAI,EAAE,GAAG,MAAM,iBAAiB;YAChC,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,oBAAoB,GAAG,IAAI,OAAO,CAAC;YACtC,IAAI,EAAE,GAAG,MAAM,wBAAwB;YACvC,IAAI,EAAE,kCAAkC;YACxC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,sBAAsB,GAAG,IAAI,OAAO,CAAC;YACxC,IAAI,EAAE,GAAG,MAAM,0BAA0B;YACzC,IAAI,EAAE,oCAAoC;YAC1C,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,wBAAwB;QACxB,IAAI,CAAC,iBAAiB,GAAG,IAAI,OAAO,CAAC;YACnC,IAAI,EAAE,GAAG,MAAM,kBAAkB;YACjC,IAAI,EAAE,gCAAgC;YACtC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC9B,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,GAAG,IAAI,SAAS,CAAC;YACvC,IAAI,EAAE,GAAG,MAAM,4BAA4B;YAC3C,IAAI,EAAE,mCAAmC;YACzC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAChD,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,GAAG,IAAI,OAAO,CAAC;YACnC,IAAI,EAAE,GAAG,MAAM,wBAAwB;YACvC,IAAI,EAAE,sCAAsC;YAC5C,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC;YAClC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC;YAC/B,IAAI,EAAE,GAAG,MAAM,iBAAiB;YAChC,IAAI,EAAE,sCAAsC;YAC5C,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;YACnC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,IAAI,SAAS,CAAC;YACnC,IAAI,EAAE,GAAG,MAAM,2BAA2B;YAC1C,IAAI,EAAE,8BAA8B;YACpC,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC;YAC/B,IAAI,EAAE,GAAG,MAAM,uBAAuB;YACtC,IAAI,EAAE,iCAAiC;YACvC,UAAU,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;YACvC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc,EAAE,eAAuB;QACrF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC;YACzB,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAC9B;YACE,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B,EACD,eAAe,CAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,IAAY,EAAE,MAA2B,EAAE,eAAuB;QAC/E,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY,EAAE,SAAiB;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB,EAAE,MAAc,EAAE,eAAuB;QACtE,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAEhD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,sBAAsB,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACK,aAAa,CAAC,IAAY;QAChC,sBAAsB;QACtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,cAAc;QACd,IAAI,gBAAgB,KAAK,MAAM;YAC3B,gBAAgB,KAAK,UAAU;YAC/B,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,MAAc;QACnC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;QAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;QAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;QAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/openapi-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OpenAPI specification parser and indexer
+ *
+ * Why indexing: Large OpenAPI specs (GitLab has ~200 operations) need fast lookup.
+ * Pre-indexing by operationId and path avoids linear search on every tool call.
+ */
+import type { OperationInfo, PathInfo } from './types/openapi.js';
+export declare class OpenAPIParser {
+    private spec?;
+    private index?;
+    load(specPath: string): Promise<void>;
+    /**
+     * Build search index from OpenAPI spec
+     *
+     * Why upfront: Trading startup time for runtime performance. Index creation
+     * happens once; lookups happen on every tool call.
+     */
+    private buildIndex;
+    private extractOperationInfo;
+    private extractParameters;
+    /**
+     * Resolve $ref to parameter definition
+     *
+     * Why: GitLab spec uses shared parameter definitions (e.g., ProjectIdOrPath).
+     * Need to resolve these refs to get actual parameter details.
+     */
+    private resolveParameter;
+    private extractRequestBody;
+    private extractSchema;
+    getOperation(operationId: string): OperationInfo | undefined;
+    getPath(path: string): PathInfo | undefined;
+    getBaseUrl(): string;
+    getAllOperations(): OperationInfo[];
+}
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../src/openapi-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAgB,aAAa,EAAiB,QAAQ,EAA+B,MAAM,oBAAoB,CAAC;AAE5H,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAC,CAAqB;IAClC,OAAO,CAAC,KAAK,CAAC,CAAe;IAEvB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3C;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAkClB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,iBAAiB;IAqBzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,aAAa;IA0BrB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI3C,UAAU,IAAI,MAAM;IAKpB,gBAAgB,IAAI,aAAa,EAAE;CAGpC"}

package/dist/openapi-parser.js

@@ -0,0 +1,160 @@
+/**
+ * OpenAPI specification parser and indexer
+ *
+ * Why indexing: Large OpenAPI specs (GitLab has ~200 operations) need fast lookup.
+ * Pre-indexing by operationId and path avoids linear search on every tool call.
+ */
+import fs from 'fs/promises';
+import { parse as parseYaml } from 'yaml';
+export class OpenAPIParser {
+    spec;
+    index;
+    async load(specPath) {
+        const content = await fs.readFile(specPath, 'utf-8');
+        // Parse YAML or JSON based on extension
+        if (specPath.endsWith('.yaml') || specPath.endsWith('.yml')) {
+            this.spec = parseYaml(content);
+        }
+        else {
+            this.spec = JSON.parse(content);
+        }
+        this.buildIndex();
+    }
+    /**
+     * Build search index from OpenAPI spec
+     *
+     * Why upfront: Trading startup time for runtime performance. Index creation
+     * happens once; lookups happen on every tool call.
+     */
+    buildIndex() {
+        if (!this.spec)
+            throw new Error('Spec not loaded');
+        const operations = new Map();
+        const paths = new Map();
+        for (const [path, pathItem] of Object.entries(this.spec.paths || {})) {
+            if (!pathItem)
+                continue;
+            const pathOperations = {};
+            for (const method of ['get', 'post', 'put', 'patch', 'delete', 'head', 'options']) {
+                const operation = pathItem[method];
+                if (!operation)
+                    continue;
+                const operationInfo = this.extractOperationInfo(path, method, operation);
+                if (operationInfo.operationId) {
+                    operations.set(operationInfo.operationId, operationInfo);
+                }
+                pathOperations[method] = operationInfo;
+            }
+            paths.set(path, { path, operations: pathOperations });
+        }
+        this.index = {
+            spec: this.spec,
+            operations,
+            paths,
+        };
+    }
+    extractOperationInfo(path, method, operation) {
+        return {
+            operationId: operation.operationId || `${method}_${path}`,
+            method: method.toUpperCase(),
+            path,
+            summary: operation.summary,
+            description: operation.description,
+            parameters: this.extractParameters(operation),
+            requestBody: this.extractRequestBody(operation),
+            tags: operation.tags,
+        };
+    }
+    extractParameters(operation) {
+        if (!operation.parameters)
+            return [];
+        return operation.parameters
+            .map(p => {
+            // Resolve $ref to parameter definition
+            if ('$ref' in p) {
+                return this.resolveParameter(p.$ref);
+            }
+            return p;
+        })
+            .filter((p) => p !== null)
+            .map(param => ({
+            name: param.name,
+            in: param.in,
+            required: param.required ?? false,
+            schema: this.extractSchema(param.schema),
+            description: param.description,
+        }));
+    }
+    /**
+     * Resolve $ref to parameter definition
+     *
+     * Why: GitLab spec uses shared parameter definitions (e.g., ProjectIdOrPath).
+     * Need to resolve these refs to get actual parameter details.
+     */
+    resolveParameter(ref) {
+        if (!this.spec)
+            return null;
+        // Extract ref path: #/components/parameters/ProjectIdOrPath => ProjectIdOrPath
+        const refName = ref.split('/').pop();
+        if (!refName)
+            return null;
+        const param = this.spec.components?.parameters?.[refName];
+        if (!param || '$ref' in param)
+            return null;
+        return param;
+    }
+    extractRequestBody(operation) {
+        if (!operation.requestBody || '$ref' in operation.requestBody)
+            return undefined;
+        const body = operation.requestBody;
+        const content = {};
+        for (const [mediaType, mediaTypeObj] of Object.entries(body.content || {})) {
+            if (mediaTypeObj.schema) {
+                content[mediaType] = {
+                    schema: this.extractSchema(mediaTypeObj.schema),
+                };
+            }
+        }
+        return {
+            required: body.required ?? false,
+            content,
+        };
+    }
+    extractSchema(schema) {
+        if (!schema)
+            return {};
+        if ('$ref' in schema)
+            return { type: 'object' }; // Simplified: don't resolve refs
+        const result = {
+            type: schema.type,
+            format: schema.format,
+            enum: schema.enum,
+            default: schema.default,
+        };
+        if (schema.type === 'array' && schema.items && !('$ref' in schema.items)) {
+            result.items = this.extractSchema(schema.items);
+        }
+        if (schema.type === 'object' && schema.properties) {
+            result.properties = {};
+            for (const [key, propSchema] of Object.entries(schema.properties)) {
+                result.properties[key] = this.extractSchema(propSchema);
+            }
+            result.required = schema.required;
+        }
+        return result;
+    }
+    getOperation(operationId) {
+        return this.index?.operations.get(operationId);
+    }
+    getPath(path) {
+        return this.index?.paths.get(path);
+    }
+    getBaseUrl() {
+        const servers = this.spec?.servers;
+        return servers?.[0]?.url || '';
+    }
+    getAllOperations() {
+        return Array.from(this.index?.operations.values() || []);
+    }
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/openapi-parser.js.map

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

package/dist/profile-loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Profile configuration loader and validator
+ *
+ * Why validation: Profile config comes from user files. Invalid config would
+ * cause runtime errors. Validate upfront with clear error messages.
+ */
+import type { Profile } from './types/profile.js';
+export declare class ProfileLoader {
+    load(profilePath: string): Promise<Profile>;
+    /**
+     * Validate semantic rules beyond schema
+     *
+     * Why separate: Some rules can't be expressed in JSON Schema (e.g.,
+     * "if composite=true then steps must exist"). Fail fast with clear messages.
+     */
+    private validateLogic;
+    /**
+     * Create a minimal default profile from OpenAPI spec
+     *
+     * Why: Allows running server without profile for quick exploration.
+     * Generates simple pass-through tools for all operations.
+     */
+    static createDefaultProfile(profileName: string): Profile;
+}
+//# sourceMappingURL=profile-loader.d.ts.map

package/dist/profile-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-loader.d.ts","sourceRoot":"","sources":["../src/profile-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoFlD,qBAAa,aAAa;IAClB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYjD;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAsCrB;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAQ1D"}

package/dist/profile-loader.js

@@ -0,0 +1,134 @@
+/**
+ * Profile configuration loader and validator
+ *
+ * Why validation: Profile config comes from user files. Invalid config would
+ * cause runtime errors. Validate upfront with clear error messages.
+ */
+import fs from 'fs/promises';
+import { z } from 'zod';
+// Zod schemas for runtime validation
+const ParameterDefSchema = z.object({
+    type: z.enum(['string', 'integer', 'number', 'boolean', 'array', 'object']),
+    description: z.string(),
+    required: z.boolean().optional(),
+    required_for: z.array(z.string()).optional(),
+    enum: z.array(z.string()).optional(),
+    items: z.object({ type: z.string() }).optional(),
+    default: z.unknown().optional(),
+    example: z.unknown().optional(),
+});
+const ArrayFormatSchema = z.enum(['brackets', 'indices', 'repeat', 'comma']);
+const CompositeStepSchema = z.object({
+    call: z.string(),
+    store_as: z.string(),
+});
+const ToolDefSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    operations: z.record(z.string()).optional(),
+    composite: z.boolean().optional(),
+    steps: z.array(CompositeStepSchema).optional(),
+    partial_results: z.boolean().optional(),
+    parameters: z.record(ParameterDefSchema),
+    metadata_params: z.array(z.string()).optional(),
+    response_fields: z.record(z.array(z.string())).optional(),
+});
+const AuthInterceptorSchema = z.object({
+    type: z.enum(['bearer', 'query', 'custom-header']),
+    header_name: z.string().optional(),
+    query_param: z.string().optional(),
+    value_from_env: z.string(),
+}).refine((data) => {
+    if (data.type === 'query' && !data.query_param) {
+        return false;
+    }
+    if (data.type === 'custom-header' && !data.header_name) {
+        return false;
+    }
+    return true;
+}, {
+    message: 'query type requires query_param, custom-header requires header_name',
+});
+const BaseUrlConfigSchema = z.object({
+    value_from_env: z.string(),
+    default: z.string().optional(),
+});
+const RateLimitConfigSchema = z.object({
+    max_requests_per_minute: z.number().positive(),
+});
+const RetryConfigSchema = z.object({
+    max_attempts: z.number().int().positive(),
+    backoff_ms: z.array(z.number().positive()),
+    retry_on_status: z.array(z.number().int()),
+});
+const InterceptorConfigSchema = z.object({
+    auth: AuthInterceptorSchema.optional(),
+    base_url: BaseUrlConfigSchema.optional(),
+    rate_limit: RateLimitConfigSchema.optional(),
+    retry: RetryConfigSchema.optional(),
+    array_format: ArrayFormatSchema.optional(),
+});
+const ProfileSchema = z.object({
+    profile_name: z.string(),
+    description: z.string().optional(),
+    tools: z.array(ToolDefSchema),
+    interceptors: InterceptorConfigSchema.optional(),
+    parameter_aliases: z.record(z.array(z.string())).optional(),
+});
+export class ProfileLoader {
+    async load(profilePath) {
+        const content = await fs.readFile(profilePath, 'utf-8');
+        const json = JSON.parse(content);
+        // Validate with Zod - throws detailed error if invalid
+        const profile = ProfileSchema.parse(json);
+        this.validateLogic(profile);
+        return profile;
+    }
+    /**
+     * Validate semantic rules beyond schema
+     *
+     * Why separate: Some rules can't be expressed in JSON Schema (e.g.,
+     * "if composite=true then steps must exist"). Fail fast with clear messages.
+     */
+    validateLogic(profile) {
+        for (const tool of profile.tools) {
+            // Composite tools must have steps
+            if (tool.composite && (!tool.steps || tool.steps.length === 0)) {
+                throw new Error(`Tool '${tool.name}' is marked as composite but has no steps`);
+            }
+            // Non-composite tools must have operations
+            if (!tool.composite && !tool.operations) {
+                throw new Error(`Tool '${tool.name}' must have either 'operations' or be marked as 'composite' with 'steps'`);
+            }
+            // Validate required_for references existing enum values
+            for (const [paramName, paramDef] of Object.entries(tool.parameters)) {
+                if (paramDef.required_for) {
+                    const actionParam = tool.parameters['action'];
+                    if (!actionParam?.enum) {
+                        throw new Error(`Parameter '${paramName}' in tool '${tool.name}' has 'required_for' but 'action' parameter has no enum`);
+                    }
+                    for (const action of paramDef.required_for) {
+                        if (!actionParam.enum.includes(action)) {
+                            throw new Error(`Parameter '${paramName}' requires action '${action}' but it's not in action enum: ${actionParam.enum.join(', ')}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Create a minimal default profile from OpenAPI spec
+     *
+     * Why: Allows running server without profile for quick exploration.
+     * Generates simple pass-through tools for all operations.
+     */
+    static createDefaultProfile(profileName) {
+        return {
+            profile_name: profileName,
+            description: 'Auto-generated default profile',
+            tools: [],
+            interceptors: {},
+        };
+    }
+}
+//# sourceMappingURL=profile-loader.js.map

package/dist/profile-loader.js.map

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

package/dist/schema-validator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Request body schema validator
+ *
+ * Why: Catch invalid requests before sending to API. Better error messages for users.
+ * Validates against OpenAPI schema definitions.
+ */
+import type { SchemaInfo, OperationInfo } from './types/openapi.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    schema: SchemaInfo;
+    value: unknown;
+}
+export declare class SchemaValidator {
+    /**
+     * Validate request body against OpenAPI schema
+     *
+     * Why: Prevents sending malformed requests. OpenAPI schema is the source of truth.
+     */
+    validateRequestBody(operation: OperationInfo, body: Record<string, unknown>): ValidationResult;
+    /**
+     * Recursively validate data against schema
+     */
+    private validateAgainstSchema;
+    private isEmail;
+    private isUri;
+}
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../src/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,mBAAmB,CACjB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB;IAgBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4G7B,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,KAAK;CAQd"}