@inso_web/els-mcp 0.1.0

package/dist/tools/versionRegression.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { ToolError } from '../lib/errors.js';
+/**
+ * Tool: version_regression
+ * Mapping: GET /analytics/version-timeline → analytics.routes.ts:373
+ * Upstream Zod: VersionTimelineSchema (from, to, +фасет-фильтры, +appVersion).
+ *
+ * Сравнивает 2 версии: новые fingerprint'ы в candidateVersion vs baselineVersion,
+ * и исчезнувшие. Upstream сам определяет версии — мы пробрасываем как
+ * `appVersion=baseline,candidate` фильтр (csv) + опционально windowDays через
+ * from/to.
+ */
+const DEFAULT_WINDOW_DAYS = 7;
+export const versionRegressionInputShape = {
+    baselineVersion: z.string().min(1).max(64),
+    candidateVersion: z.string().min(1).max(64),
+    serviceName: z.string().max(255).optional(),
+    windowDays: z.number().int().min(1).max(30).default(DEFAULT_WINDOW_DAYS),
+};
+export const versionRegressionToolDef = {
+    name: 'version_regression',
+    title: 'New / disappeared fingerprints between versions',
+    description: 'Compare two appVersion releases: which fingerprints are NEW in the candidate version vs baseline, which DISAPPEARED. Use after a deploy.',
+    inputShape: versionRegressionInputShape,
+};
+function isoDaysAgo(days) {
+    return new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+}
+export async function handleVersionRegression(args, client) {
+    try {
+        const params = {
+            from: isoDaysAgo(args.windowDays),
+            to: new Date().toISOString(),
+            appVersion: `${args.baselineVersion},${args.candidateVersion}`,
+            serviceName: args.serviceName,
+        };
+        const { data, elsRequestId } = await client.versionRegression(params);
+        const body = (data ?? {});
+        // Upstream может вернуть несколько форм; нормализуем.
+        const baseline = body.baseline ?? {
+            version: args.baselineVersion,
+            errors: 0,
+            uniqueFingerprints: 0,
+        };
+        const candidate = body.candidate ?? {
+            version: args.candidateVersion,
+            errors: 0,
+            uniqueFingerprints: 0,
+        };
+        const newFingerprints = Array.isArray(body.newFingerprints) ? body.newFingerprints : [];
+        const disappeared = Array.isArray(body.disappeared) ? body.disappeared : [];
+        const meta = {
+            elsRequestId,
+            cached: false,
+            ttlSec: 120,
+            redactionApplied: false,
+        };
+        return {
+            structuredContent: {
+                baseline,
+                candidate,
+                newFingerprints,
+                disappeared,
+                _meta: meta,
+            },
+            content: [
+                {
+                    type: 'text',
+                    text: `Regression check ${args.baselineVersion} → ${args.candidateVersion}: ${newFingerprints.length} new, ${disappeared.length} disappeared.`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            return err.toToolResult();
+        throw err;
+    }
+}
+//# sourceMappingURL=versionRegression.js.map

package/dist/tools/versionRegression.js.map

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

package/dist/transports/http-server.d.ts

@@ -0,0 +1,25 @@
+import type { Server } from 'node:http';
+import type { Logger } from 'pino';
+import type { Config } from '../config.js';
+import { HttpTransportManager } from './http.js';
+import { RedisService } from '../cache/redis.js';
+/**
+ * Запускает HTTP transport: создаёт Express app, начинает listen на
+ * configured port. Возвращает handle с close()-методом для graceful shutdown.
+ *
+ * Phase 6 wire-up:
+ *   - Redis (если cacheEnabled && redisUrl) — для CachedElsClient + readyz + DCR rl
+ *   - Audit/Usage trackers — для withMiddleware
+ *   - Middleware deps пробрасываются в HttpTransportManager
+ */
+export interface HttpServerHandle {
+    server: Server;
+    manager: HttpTransportManager;
+    redis: RedisService | null;
+    close(): Promise<void>;
+}
+export declare function startHttpServer(opts: {
+    config: Config;
+    log: Logger;
+}): Promise<HttpServerHandle>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/transports/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/transports/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjD;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuF5B"}

package/dist/transports/http-server.js

@@ -0,0 +1,84 @@
+import { createHttpApp } from '../http/app.js';
+import { ElsClient } from '../elsClient.js';
+import { HttpTransportManager } from './http.js';
+import { RedisService } from '../cache/redis.js';
+import { createAuditService, setAuditServiceForTests, } from '../audit/service.js';
+import { createUsageTracker, setUsageTrackerForTests, } from '../billing/tracker.js';
+export async function startHttpServer(opts) {
+    const { config, log } = opts;
+    // Probe-client для /readyz — использует master/ELS_API_KEY если задан.
+    let probeClient;
+    if (config.elsApiKey) {
+        probeClient = new ElsClient({
+            baseUrl: config.elsBaseUrl,
+            apiKey: config.elsApiKey,
+            timeoutMs: 5000,
+            log,
+        });
+    }
+    // Phase 6: Redis для cache layer + readyz + DCR rate-limit.
+    let redis = null;
+    if (config.cacheEnabled && config.redisUrl) {
+        redis = new RedisService({ url: config.redisUrl, log });
+    }
+    // Phase 6: audit + usage. Singletons заменяются на real instances.
+    const audit = createAuditService({
+        ...(config.mcpDatabaseUrl ? { databaseUrl: config.mcpDatabaseUrl } : {}),
+        log,
+    });
+    setAuditServiceForTests(audit);
+    const usage = createUsageTracker({
+        ...(config.mcpDatabaseUrl ? { databaseUrl: config.mcpDatabaseUrl } : {}),
+        log,
+    });
+    setUsageTrackerForTests(usage);
+    const middlewareDeps = {
+        audit,
+        usage,
+        redactionConfig: {
+            enabled: config.redactionEnabled,
+            ...(config.redactionFields.length > 0
+                ? { fields: new Set(config.redactionFields) }
+                : {}),
+        },
+    };
+    const manager = new HttpTransportManager({
+        config,
+        log,
+        redis,
+        middlewareDeps,
+    });
+    const { app } = createHttpApp({
+        config,
+        log,
+        transportManager: manager,
+        ...(probeClient ? { probeElsClient: probeClient } : {}),
+        redis,
+        middlewareDeps,
+    });
+    const server = await new Promise((resolve, reject) => {
+        const s = app.listen(config.httpPort, () => resolve(s));
+        s.on('error', reject);
+    });
+    log.info({
+        port: config.httpPort,
+        publicUrl: config.publicUrl,
+        cacheEnabled: config.cacheEnabled && !!redis,
+        metricsEnabled: config.metricsEnabled,
+    }, 'HTTP transport listening');
+    return {
+        server,
+        manager,
+        redis,
+        async close() {
+            log.info('Shutting down HTTP transport');
+            await new Promise((resolve) => server.close(() => resolve()));
+            await manager.close();
+            if (probeClient)
+                await probeClient.close();
+            if (redis)
+                await redis.close();
+        },
+    };
+}
+//# sourceMappingURL=http-server.js.map

package/dist/transports/http-server.js.map

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

package/dist/transports/http.d.ts

@@ -0,0 +1,71 @@
+import type { Request, Response } from 'express';
+import type { Logger } from 'pino';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Config } from '../config.js';
+import { ElsClient } from '../elsClient.js';
+import type { RequestContext } from '../http/types.js';
+import { type RedisService } from '../cache/index.js';
+import { type Tier } from '../billing/limits.js';
+import type { MiddlewareDeps } from '../middleware/withMiddleware.js';
+export interface SessionRecord {
+    sessionId: string;
+    transport: StreamableHTTPServerTransport;
+    server: McpServer;
+    client: ElsClient;
+    /** Контекст последнего запроса (snapshot — для observability). */
+    lastContext?: RequestContext;
+    createdAt: number;
+    lastTouchedAt: number;
+    /** AppSlug сессии (для concurrency-limit и SSE-метрик). */
+    appSlug: string;
+}
+export interface HttpTransportManagerOptions {
+    config: Config;
+    log: Logger;
+    /** TTL idle-сессии, мс. Default 30 минут. */
+    sessionTtlMs?: number;
+    /** Disable internal cleanup timer (для тестов). */
+    noCleanup?: boolean;
+    /**
+     * Phase 6: Redis для cache layer. Если задан и cacheEnabled — каждая сессия
+     * получает CachedElsClient. Иначе — прямой ElsClient.
+     */
+    redis?: RedisService | null;
+    /** Phase 6: middleware deps (audit / usage / redaction). */
+    middlewareDeps?: MiddlewareDeps;
+    /** Tier resolver — приходит из LK (Phase 7+). По умолчанию config.defaultTier. */
+    tierResolver?: (ctx: RequestContext) => Tier;
+}
+export declare class HttpTransportManager {
+    private readonly sessions;
+    /** Per-app счётчик active sessions (для concurrency-limit). */
+    private readonly perAppCount;
+    private readonly ttlMs;
+    private readonly cleanupTimer;
+    private readonly config;
+    private readonly log;
+    private readonly redis;
+    private readonly cachePolicies;
+    private readonly middlewareDeps;
+    private readonly tierResolver;
+    constructor(opts: HttpTransportManagerOptions);
+    /** Closes all sessions and stops cleanup. Безопасно вызывать многократно. */
+    close(): Promise<void>;
+    /**
+     * Express handler для `POST /mcp`. Решает, создавать ли новую сессию
+     * (если нет `Mcp-Session-Id` И тело — initialize) или использовать
+     * существующую.
+     */
+    handleRequest(req: Request, res: Response): Promise<void>;
+    private createSession;
+    private incrPerApp;
+    private decrPerApp;
+    /** Для тестов: текущее число sessions per app. */
+    perAppSize(appSlug: string): number;
+    private touch;
+    private gcExpired;
+    /** Для тестов / observability. */
+    size(): number;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAoBnF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,kEAAkE;IAClE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kFAAkF;IAClF,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CAC9C;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAEjD,IAAI,EAAE,2BAA2B;IAiB7C,6EAA6E;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAyEjD,aAAa;IAiH3B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IASlB,kDAAkD;IAClD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,SAAS;IAuBjB,kCAAkC;IAClC,IAAI,IAAI,MAAM;CAGf"}

package/dist/transports/http.js

@@ -0,0 +1,315 @@
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createMcpServer } from '../server.js';
+import { ElsClient } from '../elsClient.js';
+import { CachedElsClient, CacheService, resolvePolicies, } from '../cache/index.js';
+import { decSseActive, incSseActive, recordSseRejection, } from '../observability/metrics.js';
+import { TIER_LIMITS } from '../billing/limits.js';
+/**
+ * Streamable HTTP transport (Phase 3, in-memory sessions).
+ *
+ * Каждый клиент создаёт сессию через первый `initialize`-запрос. После этого
+ * `Mcp-Session-Id` header связывает запросы с конкретной парой
+ * (McpServer + StreamableHTTPServerTransport).
+ *
+ * Sessions хранятся в Map (in-memory). TTL — 30 минут idle. На каждый запрос
+ * сессия "touch'ается" (продлевается). В Phase 4 будет Redis (см. 02-transports.md §4.3).
+ *
+ * Resumability через `Last-Event-ID` поддерживается SDK 1.x — нам ничего
+ * специально делать не нужно (но `EventStore` пока не подключаем —
+ * `streaming: true` tools'ов в Phase 3 нет, все 8 tools — non-streaming).
+ */
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 минут
+const CLEANUP_INTERVAL_MS = 60 * 1000; // 1 минута
+export class HttpTransportManager {
+    sessions = new Map();
+    /** Per-app счётчик active sessions (для concurrency-limit). */
+    perAppCount = new Map();
+    ttlMs;
+    cleanupTimer = null;
+    config;
+    log;
+    redis;
+    cachePolicies;
+    middlewareDeps;
+    tierResolver;
+    constructor(opts) {
+        this.config = opts.config;
+        this.log = opts.log;
+        this.ttlMs = opts.sessionTtlMs ?? DEFAULT_TTL_MS;
+        this.redis = opts.redis ?? null;
+        this.cachePolicies = resolvePolicies(opts.config.cacheTtlOverrides);
+        this.middlewareDeps = opts.middlewareDeps ?? {};
+        this.tierResolver =
+            opts.tierResolver ?? (() => opts.config.defaultTier);
+        if (!opts.noCleanup) {
+            this.cleanupTimer = setInterval(() => this.gcExpired(), CLEANUP_INTERVAL_MS);
+            // Don't block process exit on this timer.
+            this.cleanupTimer.unref?.();
+        }
+    }
+    /** Closes all sessions and stops cleanup. Безопасно вызывать многократно. */
+    async close() {
+        if (this.cleanupTimer)
+            clearInterval(this.cleanupTimer);
+        const sessions = Array.from(this.sessions.values());
+        this.sessions.clear();
+        this.perAppCount.clear();
+        for (const rec of sessions) {
+            try {
+                await rec.transport.close();
+            }
+            catch (err) {
+                this.log.warn({ err: errMsg(err), sessionId: rec.sessionId }, 'transport.close failed');
+            }
+            try {
+                await rec.server.close();
+            }
+            catch (err) {
+                this.log.warn({ err: errMsg(err), sessionId: rec.sessionId }, 'server.close failed');
+            }
+            try {
+                await rec.client.close();
+            }
+            catch (err) {
+                this.log.warn({ err: errMsg(err), sessionId: rec.sessionId }, 'client.close failed');
+            }
+            try {
+                decSseActive(rec.appSlug || 'unknown');
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    /**
+     * Express handler для `POST /mcp`. Решает, создавать ли новую сессию
+     * (если нет `Mcp-Session-Id` И тело — initialize) или использовать
+     * существующую.
+     */
+    async handleRequest(req, res) {
+        const ctx = req.context;
+        if (!ctx) {
+            // Auth middleware должен был отработать раньше — fail-safe.
+            res.status(401).json({ error: 'unauthorized' });
+            return;
+        }
+        const incomingSid = pickSessionIdHeader(req);
+        const body = req.body;
+        const isInit = isInitializeRequest(body);
+        let rec;
+        if (incomingSid) {
+            rec = this.sessions.get(incomingSid);
+            if (!rec) {
+                // 404 как в SDK semantics: клиенту нужно reinit
+                res.status(404).json({ error: 'session_not_found', sessionId: incomingSid });
+                return;
+            }
+            this.touch(rec);
+        }
+        else if (isInit) {
+            // Phase 6: concurrency limit per tier+appSlug.
+            const tier = this.tierResolver(ctx);
+            const appSlug = ctx.appSlug || 'unknown';
+            const limit = TIER_LIMITS[tier]?.concurrentSse ?? Number.POSITIVE_INFINITY;
+            const current = this.perAppCount.get(appSlug) ?? 0;
+            if (current >= limit) {
+                recordSseRejection('concurrency_exceeded', appSlug);
+                this.log.warn({ appSlug, tier, current, limit, requestId: ctx.requestId }, 'SSE session-create rejected: concurrency limit exceeded');
+                res.setHeader('X-RateLimit-Concurrent-Exceeded', 'true');
+                res.setHeader('X-RateLimit-Concurrent-Limit', String(limit));
+                res.status(429).json({
+                    error: 'concurrency_limit_exceeded',
+                    error_description: `Maximum ${limit} concurrent SSE sessions for tier ${tier}`,
+                    tier,
+                    limit,
+                });
+                return;
+            }
+            rec = await this.createSession(ctx);
+        }
+        else {
+            // нет сессии и не initialize → 400
+            res.status(400).json({
+                error: 'missing_session_id',
+                error_description: 'Mcp-Session-Id header required for non-initialize requests',
+            });
+            return;
+        }
+        // Обновим snapshot контекста на каждом запросе (полезно для логов).
+        rec.lastContext = ctx;
+        try {
+            await rec.transport.handleRequest(req, res, body);
+        }
+        catch (err) {
+            this.log.error({ err: errMsg(err), sessionId: rec.sessionId, requestId: ctx.requestId }, 'StreamableHTTP transport.handleRequest threw');
+            if (!res.headersSent) {
+                res.status(500).json({ error: 'internal', requestId: ctx.requestId });
+            }
+        }
+    }
+    // ─── private ──────────────────────────────────────────────────────────
+    async createSession(ctx) {
+        const sessionId = randomUUID();
+        // Каждая сессия получает свой ElsClient: для ELS-key path передаём
+        // ключ запроса, для OIDC — используем глобальный (master) ELS_API_KEY
+        // если задан (TODO Phase 4: per-tenant credentials через LK).
+        const apiKey = ctx.authMethod === 'els-key' && ctx.elsApiKey
+            ? ctx.elsApiKey
+            : this.config.elsApiKey;
+        const baseClient = new ElsClient({
+            baseUrl: this.config.elsBaseUrl,
+            apiKey,
+            timeoutMs: this.config.upstreamTimeoutMs,
+            log: this.log,
+        });
+        // Phase 6: если включён cache и Redis доступен — оборачиваем в CachedElsClient.
+        // Сам CachedElsClient gracefully fallback'ит на baseClient при недоступном Redis.
+        let toolClient = baseClient;
+        if (this.config.cacheEnabled && this.redis) {
+            const cacheService = new CacheService({ redis: this.redis, log: this.log });
+            const cached = new CachedElsClient(baseClient, cacheService, this.cachePolicies, this.log);
+            // CachedElsClient повторяет сигнатуру ElsClient — приводим к этому типу
+            // для совместимости с registerTools / handlers (которые знают только ElsClient).
+            toolClient = cached;
+        }
+        // Phase 6: contextProvider — каждый tool-call получает актуальный ctx
+        // (с appSlug / keyId / tier / ip / userAgent / sessionId).
+        const session = {
+            lastCtx: ctx,
+            sessionId,
+        };
+        const contextProvider = () => {
+            const cur = session.lastCtx;
+            const tier = this.tierResolver(cur);
+            return {
+                appId: cur.appSlug || this.config.defaultAppId,
+                keyId: cur.keyId,
+                tier,
+                log: this.log,
+                ip: cur.ip || null,
+                userAgent: cur.userAgent || null,
+                sessionId: cur.sessionId ?? session.sessionId,
+            };
+        };
+        const { server } = createMcpServer({
+            config: { ...this.config, elsApiKey: apiKey },
+            log: this.log,
+            client: toolClient,
+            contextProvider,
+            middleware: this.middlewareDeps,
+        });
+        const appSlug = ctx.appSlug || 'unknown';
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => sessionId,
+            onsessionclosed: (sid) => {
+                this.log.info({ sessionId: sid, appSlug }, 'MCP session closed (DELETE)');
+                const rec = this.sessions.get(sid);
+                if (rec) {
+                    this.sessions.delete(sid);
+                    this.decrPerApp(rec.appSlug);
+                    try {
+                        decSseActive(rec.appSlug || 'unknown');
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+            },
+        });
+        await server.connect(transport);
+        const rec = {
+            sessionId,
+            transport,
+            server,
+            client: baseClient, // close() освобождает undici pool
+            lastContext: ctx,
+            createdAt: Date.now(),
+            lastTouchedAt: Date.now(),
+            appSlug,
+        };
+        this.sessions.set(sessionId, rec);
+        this.incrPerApp(appSlug);
+        try {
+            incSseActive(appSlug);
+        }
+        catch {
+            // ignore
+        }
+        this.log.info({
+            sessionId,
+            authMethod: ctx.authMethod,
+            keyId: ctx.keyId,
+            appSlug,
+            cacheEnabled: this.config.cacheEnabled && !!this.redis,
+        }, 'MCP session created');
+        return rec;
+    }
+    incrPerApp(appSlug) {
+        this.perAppCount.set(appSlug, (this.perAppCount.get(appSlug) ?? 0) + 1);
+    }
+    decrPerApp(appSlug) {
+        const cur = this.perAppCount.get(appSlug) ?? 0;
+        if (cur <= 1) {
+            this.perAppCount.delete(appSlug);
+        }
+        else {
+            this.perAppCount.set(appSlug, cur - 1);
+        }
+    }
+    /** Для тестов: текущее число sessions per app. */
+    perAppSize(appSlug) {
+        return this.perAppCount.get(appSlug) ?? 0;
+    }
+    touch(rec) {
+        rec.lastTouchedAt = Date.now();
+    }
+    gcExpired() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [sid, rec] of this.sessions) {
+            if (now - rec.lastTouchedAt > this.ttlMs) {
+                this.sessions.delete(sid);
+                this.decrPerApp(rec.appSlug);
+                try {
+                    decSseActive(rec.appSlug || 'unknown');
+                }
+                catch {
+                    // ignore
+                }
+                rec.transport.close().catch(() => undefined);
+                rec.server.close().catch(() => undefined);
+                rec.client.close().catch(() => undefined);
+                removed += 1;
+            }
+        }
+        if (removed > 0) {
+            this.log.info({ removed, alive: this.sessions.size }, 'MCP session GC ran');
+        }
+    }
+    /** Для тестов / observability. */
+    size() {
+        return this.sessions.size;
+    }
+}
+function pickSessionIdHeader(req) {
+    const v = req.headers['mcp-session-id'];
+    if (typeof v === 'string' && v.length > 0)
+        return v;
+    return undefined;
+}
+function isInitializeRequest(body) {
+    if (!body)
+        return false;
+    if (Array.isArray(body)) {
+        return body.some((m) => isInitializeRequest(m));
+    }
+    if (typeof body !== 'object')
+        return false;
+    const obj = body;
+    return obj.method === 'initialize';
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

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

package/dist/transports/stdio.d.ts

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Создаёт и подключает stdio-транспорт к MCP-серверу.
+ *
+ * Это default-транспорт для локальных LLM-клиентов (Claude Desktop,
+ * mcp-inspector). HTTP transport — Phase 3.
+ *
+ * Важно: при работе в stdio все stdout-байты должны быть валидным JSON-RPC.
+ * Pino должен писать в stderr (см. server.ts).
+ */
+export declare function connectStdio(server: McpServer): Promise<StdioServerTransport>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/transports/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAInF"}

package/dist/transports/stdio.js

@@ -0,0 +1,16 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+/**
+ * Создаёт и подключает stdio-транспорт к MCP-серверу.
+ *
+ * Это default-транспорт для локальных LLM-клиентов (Claude Desktop,
+ * mcp-inspector). HTTP transport — Phase 3.
+ *
+ * Важно: при работе в stdio все stdout-байты должны быть валидным JSON-RPC.
+ * Pino должен писать в stderr (см. server.ts).
+ */
+export async function connectStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    return transport;
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAiB;IAClD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC"}