@inso_web/els-mcp 0.1.0

package/dist/cache/cachedElsClient.js

@@ -0,0 +1,167 @@
+import { CACHE_POLICIES, paramsHash, tenantKey } from './policies.js';
+/**
+ * Кэширующая обёртка над `ElsClient`.
+ *
+ * Дизайн — **composition over inheritance**:
+ *   - сохраняет 100% совместимую сигнатуру с ElsClient;
+ *   - не модифицирует ElsClient (additive only);
+ *   - `ctx` принимается опционально (по умолчанию — fallback context от config).
+ *
+ * Если cache недоступен (Redis down или disabled) — все методы прозрачно
+ * прокидываются в underlying `ElsClient`.
+ *
+ * Все cache keys построены через `tenantKey()` (см. `policies.ts`), что
+ * гарантирует tenant-isolation (cross-tenant leak guard).
+ *
+ * Какие методы кэшируем (см. `05-high-load.md` § 2.1):
+ *
+ *   | Method               | Class            | TTL    |
+ *   |----------------------|------------------|--------|
+ *   | getLogDetails        | log_details      | 1h     |
+ *   | searchLogs           | search_recent    | 15s    |
+ *   | topErrorMessages     | top_messages     | 2m     |
+ *   | errorHistogram       | histogram        | 1m     |
+ *   | trafficStats         | traffic_long     | 5m     |
+ *   | listApps             | list_apps        | 30s    |
+ *   | heatmap              | heatmap          | 5m     |
+ *   | errorStats           | stats_breakdown  | 2m     |
+ *   | groupedErrors        | grouped_errors   | 2m     |
+ *   | baseline             | baseline         | 5m     |
+ *   | versionRegression    | version_timeline | 5m     |
+ *
+ * Что НЕ кэшируем (см. § 2.4):
+ *   - `queryLogsJql`         — высокая кардинальность ключей, hit ratio < 5%.
+ *   - `findCorrelatedErrors` — корреляция меняется при ingest.
+ *   - `findSimilarErrors`    — агрегаты "за последний час" — слишком волатильны.
+ */
+export class CachedElsClient {
+    inner;
+    cache;
+    policies;
+    _log;
+    constructor(inner, cache, policies = { ...CACHE_POLICIES }, _log) {
+        this.inner = inner;
+        this.cache = cache;
+        this.policies = policies;
+        this._log = _log;
+    }
+    /** Доступ к raw client (нужен для методов без кэша). */
+    get raw() {
+        return this.inner;
+    }
+    async close() {
+        await this.inner.close();
+    }
+    // ─── Cached methods ─────────────────────────────────────────────────────
+    async getLogDetails(traceId, ctx) {
+        const key = this.buildKey('log_details', ctx, [traceId]);
+        const ttl = this.policies.log_details;
+        if (!key)
+            return this.inner.getLogDetails(traceId);
+        const { value } = await this.cache.cached(key, ttl, () => this.inner.getLogDetails(traceId), { toolClass: 'log_details' });
+        return value;
+    }
+    async searchLogs(params, ctx) {
+        const key = this.buildKey('search_recent', ctx, [paramsHash(params)]);
+        const ttl = this.policies.search_recent;
+        if (!key)
+            return this.inner.searchLogs(params);
+        const { value } = await this.cache.cached(key, ttl, () => this.inner.searchLogs(params), { toolClass: 'search_recent' });
+        return value;
+    }
+    async topErrorMessages(params, ctx) {
+        const key = this.buildKey('top_messages', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.topErrorMessages(params);
+        const { value } = await this.cache.cached(key, this.policies.top_messages, () => this.inner.topErrorMessages(params), { toolClass: 'top_messages' });
+        return value;
+    }
+    async errorHistogram(params, ctx) {
+        const key = this.buildKey('histogram', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.errorHistogram(params);
+        const { value } = await this.cache.cached(key, this.policies.histogram, () => this.inner.errorHistogram(params), { toolClass: 'histogram' });
+        return value;
+    }
+    async trafficStats(params, ctx) {
+        const key = this.buildKey('traffic_long', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.trafficStats(params);
+        const { value } = await this.cache.cached(key, this.policies.traffic_long, () => this.inner.trafficStats(params), { toolClass: 'traffic_long' });
+        return value;
+    }
+    async listApps(ctx) {
+        // listApps — единственный case, где key может быть только по keyPrefix
+        // (master-key вообще без appSlug). Передаём пустой scope-tenant fallback.
+        const key = this.buildKey('list_apps', ctx, ['v1']);
+        if (!key)
+            return this.inner.listApps();
+        const { value } = await this.cache.cached(key, this.policies.list_apps, () => this.inner.listApps(), { toolClass: 'list_apps' });
+        return value;
+    }
+    async heatmap(params, ctx) {
+        const key = this.buildKey('heatmap', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.heatmap(params);
+        const { value } = await this.cache.cached(key, this.policies.heatmap, () => this.inner.heatmap(params), { toolClass: 'heatmap' });
+        return value;
+    }
+    async errorStats(params, ctx) {
+        const key = this.buildKey('stats_breakdown', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.errorStats(params);
+        const { value } = await this.cache.cached(key, this.policies.stats_breakdown, () => this.inner.errorStats(params), { toolClass: 'stats_breakdown' });
+        return value;
+    }
+    async groupedErrors(params, ctx) {
+        const key = this.buildKey('grouped_errors', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.groupedErrors(params);
+        const { value } = await this.cache.cached(key, this.policies.grouped_errors, () => this.inner.groupedErrors(params), { toolClass: 'grouped_errors' });
+        return value;
+    }
+    async baseline(params, ctx) {
+        const key = this.buildKey('baseline', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.baseline(params);
+        const { value } = await this.cache.cached(key, this.policies.baseline, () => this.inner.baseline(params), { toolClass: 'baseline' });
+        return value;
+    }
+    async versionRegression(params, ctx) {
+        const key = this.buildKey('version_timeline', ctx, [paramsHash(params)]);
+        if (!key)
+            return this.inner.versionRegression(params);
+        const { value } = await this.cache.cached(key, this.policies.version_timeline, () => this.inner.versionRegression(params), { toolClass: 'version_timeline' });
+        return value;
+    }
+    // ─── Pass-through (не кэшируем) ────────────────────────────────────────
+    async findSimilarErrors(...args) {
+        return this.inner.findSimilarErrors(...args);
+    }
+    async findCorrelatedErrors(...args) {
+        return this.inner.findCorrelatedErrors(...args);
+    }
+    async queryLogsJql(...args) {
+        return this.inner.queryLogsJql(...args);
+    }
+    async impact(...args) {
+        return this.inner.impact(...args);
+    }
+    // ─── helpers ────────────────────────────────────────────────────────────
+    /**
+     * Строит cache key с tenant-isolation. Возвращает null если контекст не даёт
+     * tenant идентификатор — caller обязан в этом случае идти в bypass-path.
+     */
+    buildKey(scope, ctx, parts) {
+        const appSlug = ctx?.appSlug ?? null;
+        const keyPrefix = ctx?.keyPrefix;
+        try {
+            return tenantKey(scope, appSlug, parts, keyPrefix);
+        }
+        catch {
+            // Без tenant guard'а — отключаем кэш для этого вызова.
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=cachedElsClient.js.map

package/dist/cache/cachedElsClient.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,10 @@
+export { CACHE_POLICIES, paramsHash, tenantKey, resolvePolicies } from './policies.js';
+export type { CacheClass, CachePolicyOverrides } from './policies.js';
+export { CacheService, cached } from './wrapper.js';
+export type { CacheServiceDeps, CacheOptions } from './wrapper.js';
+export { CachedElsClient } from './cachedElsClient.js';
+export { RedisService, getRedisService, setRedisServiceForTests, resetRedisSingleton, } from './redis.js';
+export type { RedisServiceOptions } from './redis.js';
+export type { RequestContext } from './types.js';
+export { deriveContextFromKey } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,6 @@
+export { CACHE_POLICIES, paramsHash, tenantKey, resolvePolicies } from './policies.js';
+export { CacheService, cached } from './wrapper.js';
+export { CachedElsClient } from './cachedElsClient.js';
+export { RedisService, getRedisService, setRedisServiceForTests, resetRedisSingleton, } from './redis.js';
+export { deriveContextFromKey } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cache/policies.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Cache TTL policies per "tool class".
+ *
+ * Источник: `todo/error-logs-service/mcp/05-high-load.md` § 2.1.
+ *
+ * Class имена используются:
+ *   - как `tool_class` label в Prometheus метриках (`mcp_cache_hit_ratio`);
+ *   - как первая часть Redis key namespace (`mcp:cache:{class}:...`).
+ *
+ * Изменения дефолтов делайте здесь, не в `cachedElsClient.ts` — chair pattern.
+ *
+ * Значения можно override через ENV `MCP_CACHE_TTL_OVERRIDE_{CLASS}=secs`
+ * (см. `src/config.ts`).
+ */
+export declare const CACHE_POLICIES: {
+    readonly log_details: 3600;
+    readonly traffic_long: 300;
+    readonly traffic_short: 60;
+    readonly top_messages: 120;
+    readonly stats_breakdown: 120;
+    readonly search_recent: 15;
+    readonly list_apps: 30;
+    readonly heatmap: 300;
+    readonly histogram: 60;
+    readonly baseline: 300;
+    readonly version_timeline: 300;
+    readonly grouped_errors: 120;
+};
+export type CacheClass = keyof typeof CACHE_POLICIES;
+export interface CachePolicyOverrides {
+    [k: string]: number | undefined;
+}
+/**
+ * Объединяет дефолтные политики с user overrides из конфига.
+ */
+export declare function resolvePolicies(overrides?: CachePolicyOverrides): Record<CacheClass, number>;
+/**
+ * Стабильный sha256 hash от объекта параметров (отсортированные ключи).
+ *
+ * НЕ криптографически стойкий — это просто детерминированный fingerprint.
+ * Используется для построения cache key (paramsHash).
+ *
+ * Возвращает base64url-encoded 16 chars.
+ */
+export declare function paramsHash(params: Record<string, unknown>): string;
+/**
+ * Tenant-isolated cache key builder.
+ *
+ * **Обязательная** проверка: в key всегда присутствует tenant-идентификатор
+ * (`appSlug` или `keyPrefix`). Иначе — `Error`.
+ *
+ * Формат:
+ *   `mcp:cache:{scope}:{tenant}:{...parts}`
+ *
+ * Это **единственный** разрешённый путь создания cache key в проекте.
+ *
+ * @throws Error если tenant=null AND keyPrefix=empty (cross-tenant leak guard)
+ */
+export declare function tenantKey(scope: string, appSlug: string | null, parts: Array<string | number>, fallbackKeyPrefix?: string): string;
+//# sourceMappingURL=policies.d.ts.map

package/dist/cache/policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../src/cache/policies.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAajB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,cAAc,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,oBAAyB,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAQhG;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAIlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC7B,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAoBR"}

package/dist/cache/policies.js

@@ -0,0 +1,90 @@
+import { createHash } from 'node:crypto';
+/**
+ * Cache TTL policies per "tool class".
+ *
+ * Источник: `todo/error-logs-service/mcp/05-high-load.md` § 2.1.
+ *
+ * Class имена используются:
+ *   - как `tool_class` label в Prometheus метриках (`mcp_cache_hit_ratio`);
+ *   - как первая часть Redis key namespace (`mcp:cache:{class}:...`).
+ *
+ * Изменения дефолтов делайте здесь, не в `cachedElsClient.ts` — chair pattern.
+ *
+ * Значения можно override через ENV `MCP_CACHE_TTL_OVERRIDE_{CLASS}=secs`
+ * (см. `src/config.ts`).
+ */
+export const CACHE_POLICIES = {
+    log_details: 3600,
+    traffic_long: 300,
+    traffic_short: 60,
+    top_messages: 120,
+    stats_breakdown: 120,
+    search_recent: 15,
+    list_apps: 30,
+    heatmap: 300,
+    histogram: 60,
+    baseline: 300,
+    version_timeline: 300,
+    grouped_errors: 120,
+};
+/**
+ * Объединяет дефолтные политики с user overrides из конфига.
+ */
+export function resolvePolicies(overrides = {}) {
+    const result = { ...CACHE_POLICIES };
+    for (const [k, v] of Object.entries(overrides)) {
+        if (typeof v === 'number' && Number.isFinite(v) && v >= 0 && k in result) {
+            result[k] = v;
+        }
+    }
+    return result;
+}
+/**
+ * Стабильный sha256 hash от объекта параметров (отсортированные ключи).
+ *
+ * НЕ криптографически стойкий — это просто детерминированный fingerprint.
+ * Используется для построения cache key (paramsHash).
+ *
+ * Возвращает base64url-encoded 16 chars.
+ */
+export function paramsHash(params) {
+    const keys = Object.keys(params).sort();
+    const canon = JSON.stringify(params, keys);
+    return createHash('sha256').update(canon).digest('base64url').slice(0, 16);
+}
+/**
+ * Tenant-isolated cache key builder.
+ *
+ * **Обязательная** проверка: в key всегда присутствует tenant-идентификатор
+ * (`appSlug` или `keyPrefix`). Иначе — `Error`.
+ *
+ * Формат:
+ *   `mcp:cache:{scope}:{tenant}:{...parts}`
+ *
+ * Это **единственный** разрешённый путь создания cache key в проекте.
+ *
+ * @throws Error если tenant=null AND keyPrefix=empty (cross-tenant leak guard)
+ */
+export function tenantKey(scope, appSlug, parts, fallbackKeyPrefix) {
+    // Защита от пустого scope
+    if (!scope || /[:\s]/.test(scope)) {
+        throw new Error(`Invalid cache scope: "${scope}"`);
+    }
+    const tenant = (appSlug && appSlug.trim().length > 0 && appSlug) ||
+        (fallbackKeyPrefix && fallbackKeyPrefix.trim().length > 0 && `k:${fallbackKeyPrefix}`) ||
+        null;
+    if (!tenant) {
+        // Tenant-isolation violation — это критический баг, см. § 2.1 spec.
+        throw new Error('tenantKey() called without appSlug AND without keyPrefix — refusing to build cross-tenant cache key');
+    }
+    const safeParts = parts.map((p) => sanitizeKeyPart(String(p)));
+    return `mcp:cache:${scope}:${tenant}:${safeParts.join(':')}`;
+}
+/**
+ * Удаляет небезопасные для Redis key символы (whitespace, разделители).
+ * Заменяет на '_'. Для traceId / hash — операция no-op.
+ */
+function sanitizeKeyPart(s) {
+    return s.replace(/[\s:{}\[\]]/g, '_').slice(0, 256);
+}
+//# sourceMappingURL=policies.js.map

package/dist/cache/policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.js","sourceRoot":"","sources":["../../src/cache/policies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,GAAG;IACjB,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,GAAG;IACb,gBAAgB,EAAE,GAAG;IACrB,cAAc,EAAE,GAAG;CACX,CAAC;AAQX;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAkC,EAAE;IAClE,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAgC,CAAC;IACnE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;YACzE,MAAM,CAAC,CAAe,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAA+B;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,OAAsB,EACtB,KAA6B,EAC7B,iBAA0B;IAE1B,0BAA0B;IAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,MAAM,GACV,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC;QACjD,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACtF,IAAI,CAAC;IAEP,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,oEAAoE;QACpE,MAAM,IAAI,KAAK,CACb,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,aAAa,KAAK,IAAI,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/cache/redis.d.ts

@@ -0,0 +1,52 @@
+import type { Redis } from 'ioredis';
+import type { Logger } from 'pino';
+/**
+ * Redis singleton-обёртка.
+ *
+ * Принципы:
+ *   - Один процесс — один Redis client (singleton).
+ *   - Reconnect strategy: exponential backoff до 10s.
+ *   - Graceful degradation: если Redis недоступен, все методы кэша становятся
+ *     no-op (cache miss → loader fallback). Это решается в `wrapper.ts` —
+ *     здесь только expose флаг `available`.
+ *   - `lazyConnect: true` — соединение поднимается асинхронно, не блокирует startup.
+ */
+export interface RedisServiceOptions {
+    url: string;
+    log?: Logger;
+    /** Принудительно использовать готовый client (для тестов с ioredis-mock). */
+    client?: Redis;
+    /** Disable cache entirely (graceful no-op). */
+    disabled?: boolean;
+}
+export declare class RedisService {
+    private readonly client;
+    private readonly log;
+    private connected;
+    private readonly disabled;
+    constructor(opts: RedisServiceOptions);
+    private attachListeners;
+    /** True если Redis недоступен или disabled. */
+    get unavailable(): boolean;
+    get raw(): Redis | null;
+    /**
+     * Безопасный GET, возвращает null при любых ошибках/недоступности.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Безопасный SETEX. Возвращает true если записали, false при ошибке.
+     */
+    setex(key: string, ttlSec: number, value: string): Promise<boolean>;
+    /** Health-check (ping → PONG). Возвращает true если ответил. */
+    ping(): Promise<boolean>;
+    close(): Promise<void>;
+}
+/**
+ * Получить (или создать) singleton экземпляр.
+ *
+ * В тестах используем `setRedisServiceForTests(...)`.
+ */
+export declare function getRedisService(opts?: RedisServiceOptions): RedisService;
+export declare function setRedisServiceForTests(service: RedisService | null): void;
+export declare function resetRedisSingleton(): void;
+//# sourceMappingURL=redis.d.ts.map

package/dist/cache/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/cache/redis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,SAAS,CAAC;AAKnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,IAAI,EAAE,mBAAmB;IAqCrC,OAAO,CAAC,eAAe;IAgBvB,+CAA+C;IAC/C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,GAAG,IAAI,KAAK,GAAG,IAAI,CAEtB;IAED;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU9C;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzE,gEAAgE;IAC1D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAQxE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/cache/redis.js

@@ -0,0 +1,134 @@
+import IORedisModule from 'ioredis';
+// ioredis с verbatimModuleSyntax=false и NodeNext: класс находится в default экспорте.
+// `IORedisModule` в зависимости от bundler может быть либо классом, либо { default: class }.
+const IORedis = IORedisModule.default ?? IORedisModule;
+export class RedisService {
+    client;
+    log;
+    connected = false;
+    disabled;
+    constructor(opts) {
+        this.log = opts.log;
+        this.disabled = opts.disabled === true;
+        if (this.disabled) {
+            this.client = null;
+            this.log?.info?.('Redis cache disabled via config');
+            return;
+        }
+        if (opts.client) {
+            this.client = opts.client;
+            this.connected = true;
+            this.attachListeners();
+            return;
+        }
+        const ioOpts = {
+            lazyConnect: true,
+            maxRetriesPerRequest: 2,
+            enableOfflineQueue: false,
+            retryStrategy: (times) => Math.min(times * 200, 10_000),
+        };
+        const client = new IORedis(opts.url, ioOpts);
+        this.client = client;
+        this.attachListeners();
+        // Lazy connect — стартуем коннект в фоне, не валим startup
+        client.connect().catch((err) => {
+            this.log?.warn?.({ err: err?.message }, 'Redis initial connect failed; cache will be no-op until reconnected');
+        });
+    }
+    attachListeners() {
+        if (!this.client)
+            return;
+        this.client.on('ready', () => {
+            this.connected = true;
+            this.log?.info?.('Redis connected');
+        });
+        this.client.on('end', () => {
+            this.connected = false;
+            this.log?.warn?.('Redis connection ended');
+        });
+        this.client.on('error', (err) => {
+            this.connected = false;
+            this.log?.warn?.({ err: err.message }, 'Redis error');
+        });
+    }
+    /** True если Redis недоступен или disabled. */
+    get unavailable() {
+        return this.disabled || !this.client || !this.connected;
+    }
+    get raw() {
+        return this.client;
+    }
+    /**
+     * Безопасный GET, возвращает null при любых ошибках/недоступности.
+     */
+    async get(key) {
+        if (this.unavailable || !this.client)
+            return null;
+        try {
+            return await this.client.get(key);
+        }
+        catch (err) {
+            this.log?.warn?.({ err: err.message, key }, 'Redis GET failed');
+            return null;
+        }
+    }
+    /**
+     * Безопасный SETEX. Возвращает true если записали, false при ошибке.
+     */
+    async setex(key, ttlSec, value) {
+        if (this.unavailable || !this.client)
+            return false;
+        try {
+            await this.client.setex(key, ttlSec, value);
+            return true;
+        }
+        catch (err) {
+            this.log?.warn?.({ err: err.message, key }, 'Redis SETEX failed');
+            return false;
+        }
+    }
+    /** Health-check (ping → PONG). Возвращает true если ответил. */
+    async ping() {
+        if (this.disabled || !this.client)
+            return false;
+        try {
+            const res = await this.client.ping();
+            return res === 'PONG';
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        if (!this.client)
+            return;
+        try {
+            await this.client.quit();
+        }
+        catch {
+            this.client.disconnect();
+        }
+    }
+}
+let singleton = null;
+/**
+ * Получить (или создать) singleton экземпляр.
+ *
+ * В тестах используем `setRedisServiceForTests(...)`.
+ */
+export function getRedisService(opts) {
+    if (!singleton) {
+        if (!opts) {
+            throw new Error('getRedisService(): первый вызов требует opts');
+        }
+        singleton = new RedisService(opts);
+    }
+    return singleton;
+}
+export function setRedisServiceForTests(service) {
+    singleton = service;
+}
+export function resetRedisSingleton() {
+    singleton = null;
+}
+//# sourceMappingURL=redis.js.map

package/dist/cache/redis.js.map

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

package/dist/cache/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Общие типы для cache-слоя.
+ *
+ * Phase 4: вводим `RequestContext` — DTO, который Phase 3 (HTTP transport)
+ * прокидывает в каждый tool handler и (через декорированный) ElsClient.
+ * Содержит tenant-идентификаторы (appSlug / keyPrefix) — это **обязательное**
+ * условие tenant-isolation в cache key (см. `05-high-load.md` § 2).
+ *
+ * До интеграции с Phase 3 контекст можно собрать "вручную" из ELS_API_KEY
+ * (см. helper `deriveContextFromKey`) — fallback для stdio-режима, где
+ * один процесс = один tenant.
+ */
+export interface RequestContext {
+    /** Slug приложения (если известен). Может быть null для master-key. */
+    appSlug: string | null;
+    /** Первые 16 символов ELS API-ключа — для key-isolation между разными ключами одного app. */
+    keyPrefix: string;
+    /** Уникальный id запроса (для логов и трейсов). */
+    requestId?: string;
+    /** id MCP-сессии (Phase 3). */
+    sessionId?: string;
+    /** Имя tool'а (для метрик / логов). */
+    tool?: string;
+}
+/**
+ * Хелпер: builds a fallback context из API-key, когда нет HTTP layer.
+ * keyPrefix = sha256(apiKey).slice(0,16), appSlug = null.
+ *
+ * Используется stdio-транспортом и тестами.
+ */
+export declare function deriveContextFromKey(apiKey: string, appSlug?: string | null): RequestContext;
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,IAAW,GAAG,cAAc,CAYlG"}

package/dist/cache/types.js

@@ -0,0 +1,32 @@
+/**
+ * Общие типы для cache-слоя.
+ *
+ * Phase 4: вводим `RequestContext` — DTO, который Phase 3 (HTTP transport)
+ * прокидывает в каждый tool handler и (через декорированный) ElsClient.
+ * Содержит tenant-идентификаторы (appSlug / keyPrefix) — это **обязательное**
+ * условие tenant-isolation в cache key (см. `05-high-load.md` § 2).
+ *
+ * До интеграции с Phase 3 контекст можно собрать "вручную" из ELS_API_KEY
+ * (см. helper `deriveContextFromKey`) — fallback для stdio-режима, где
+ * один процесс = один tenant.
+ */
+/**
+ * Хелпер: builds a fallback context из API-key, когда нет HTTP layer.
+ * keyPrefix = sha256(apiKey).slice(0,16), appSlug = null.
+ *
+ * Используется stdio-транспортом и тестами.
+ */
+export function deriveContextFromKey(apiKey, appSlug = null) {
+    // Берём не сам ключ, а его хэш-префикс, чтобы не светить материал в логах/key'ах.
+    // crypto доступен в Node 20+ как глобальный объект.
+    const enc = new TextEncoder().encode(apiKey);
+    let h = 5381;
+    for (const b of enc) {
+        h = ((h << 5) + h + b) >>> 0;
+    }
+    return {
+        appSlug,
+        keyPrefix: h.toString(16).padStart(8, '0'),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,UAAyB,IAAI;IAChF,kFAAkF;IAClF,oDAAoD;IACpD,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO;QACL,OAAO;QACP,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;KAC3C,CAAC;AACJ,CAAC"}