@inso_web/els-mcp 0.1.0

package/dist/observability/logger.js

@@ -0,0 +1,75 @@
+import pino from 'pino';
+const REDACT_PATHS = [
+    'req.headers.authorization',
+    'req.headers.cookie',
+    'req.headers["x-api-key"]',
+    'res.headers["set-cookie"]',
+    '*.password',
+    '*.token',
+    '*.apiKey',
+    '*.secret',
+    'ctx.elsApiKey',
+    'elsApiKey',
+];
+let _logger = null;
+export function createLogger(cfg = {}) {
+    const level = cfg.level ?? process.env.MCP_LOG_LEVEL ?? 'info';
+    const pretty = cfg.pretty ??
+        (process.env.NODE_ENV !== 'production' && process.env.MCP_LOG_PRETTY !== 'false');
+    const baseOpts = {
+        level,
+        base: {
+            service: cfg.service ?? 'els-mcp',
+            version: cfg.version ?? process.env.GIT_SHA ?? process.env.npm_package_version ?? null,
+            pod: cfg.pod ?? process.env.HOSTNAME ?? null,
+        },
+        redact: {
+            paths: REDACT_PATHS,
+            censor: '<REDACTED>',
+        },
+        timestamp: pino.stdTimeFunctions.isoTime,
+        formatters: {
+            level(label) {
+                return { level: label };
+            },
+        },
+    };
+    let dest;
+    if (pretty) {
+        try {
+            // pino-pretty подключаем через transport, чтобы не блокировать event-loop
+            return pino({
+                ...baseOpts,
+                transport: {
+                    target: 'pino-pretty',
+                    options: {
+                        destination: 2,
+                        colorize: true,
+                        translateTime: 'SYS:HH:MM:ss.l',
+                        ignore: 'pid,hostname',
+                    },
+                },
+            });
+        }
+        catch {
+            // pino-pretty не установлен — fallback на JSON в stderr
+        }
+    }
+    // Production / fallback: JSON в stderr
+    dest = pino.destination({ dest: 2, sync: false });
+    return pino(baseOpts, dest);
+}
+/** Singleton accessor. */
+export function getLogger() {
+    if (!_logger) {
+        _logger = createLogger();
+    }
+    return _logger;
+}
+export function setLogger(logger) {
+    _logger = logger;
+}
+export function withRequestContext(logger, fields) {
+    return logger.child(fields);
+}
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAiE,MAAM,MAAM,CAAC;AA6BrF,MAAM,YAAY,GAAG;IACnB,2BAA2B;IAC3B,oBAAoB;IACpB,0BAA0B;IAC1B,2BAA2B;IAC3B,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;IACV,eAAe;IACf,WAAW;CACZ,CAAC;AAEF,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE;IACjD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,CAAC;IAC/D,MAAM,MAAM,GACV,GAAG,CAAC,MAAM;QACV,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,OAAO,CAAC,CAAC;IAEpF,MAAM,QAAQ,GAAkB;QAC9B,KAAK;QACL,IAAI,EAAE;YACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;YACjC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI;YACtF,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI;SAC7C;QACD,MAAM,EAAE;YACN,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,YAAY;SACrB;QACD,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,UAAU,EAAE;YACV,KAAK,CAAC,KAAK;gBACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1B,CAAC;SACF;KACF,CAAC;IAEF,IAAI,IAAmC,CAAC;IAExC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,0EAA0E;YAC1E,OAAO,IAAI,CAAC;gBACV,GAAG,QAAQ;gBACX,SAAS,EAAE;oBACT,MAAM,EAAE,aAAa;oBACrB,OAAO,EAAE;wBACP,WAAW,EAAE,CAAC;wBACd,QAAQ,EAAE,IAAI;wBACd,aAAa,EAAE,gBAAgB;wBAC/B,MAAM,EAAE,cAAc;qBACvB;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,YAAY,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAwB;IACzE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,49 @@
+import { Registry, Counter, Histogram, Gauge } from 'prom-client';
+/**
+ * Prometheus metrics для MCP-сервера.
+ *
+ * Источник истины по именам — `todo/error-logs-service/mcp/07-observability.md`
+ * § 1. Категории:
+ *   - RED (rate / errors / duration)        — `mcp_requests_total`, `mcp_request_duration_seconds`, `mcp_errors_total`
+ *   - Cache                                  — `mcp_cache_hits_total`, `mcp_cache_misses_total`, `mcp_cache_hit_ratio`
+ *   - Upstream (ELS)                         — `mcp_els_upstream_errors_total`
+ *   - SSE / sessions                         — `mcp_sse_connections_active`
+ *   - Security                               — `mcp_redaction_applied_total`
+ *   - Billing                                — `mcp_billing_events_total`
+ *
+ * Регистр — singleton (один на процесс). Endpoint `/els/metrics` сериализует
+ * текущее состояние в Prometheus text format.
+ */
+export declare const registry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
+export declare const mcpRequestsTotal: Counter<"status" | "tool" | "cached">;
+export declare const mcpRequestDuration: Histogram<"tool">;
+export declare const mcpErrorsTotal: Counter<"code" | "tool">;
+export declare const mcpCacheHitsTotal: Counter<"tool_class">;
+export declare const mcpCacheMissesTotal: Counter<"tool_class">;
+export declare const mcpCacheHitRatio: Gauge<"tool_class">;
+export declare const mcpElsUpstreamErrorsTotal: Counter<"endpoint" | "status">;
+export declare const mcpSseConnectionsActive: Gauge<string>;
+export declare const mcpRedactionAppliedTotal: Counter<"field">;
+export declare const mcpAuthRejectionsTotal: Counter<"reason">;
+export declare const mcpPromptInjectionBlockedTotal: Counter<"rule">;
+export declare const mcpSseConnectionsActiveByApp: Gauge<"appSlug">;
+export declare const mcpSseRejectionsTotal: Counter<"reason" | "appSlug">;
+export declare const mcpBillingEventsTotal: Counter<"appSlug" | "tier">;
+export declare function recordCacheHit(toolClass: string): void;
+export declare function recordCacheMiss(toolClass: string): void;
+export declare function recordToolRequest(tool: string, status: 'ok' | 'error' | 'timeout', cached: boolean, durationSec: number): void;
+export declare function recordToolError(tool: string, code: string): void;
+export declare function recordUpstreamError(endpoint: string, status: number | string): void;
+export declare function recordRedaction(field: string): void;
+export declare function recordBillingEvent(appSlug: string, tier: string): void;
+export declare function recordAuthRejection(reason: string): void;
+export declare function recordPromptInjectionBlocked(rule: string): void;
+export declare function incSseActive(appSlug: string): void;
+export declare function decSseActive(appSlug: string): void;
+export declare function recordSseRejection(reason: string, appSlug: string): void;
+/** Сброс per-process состояния (для тестов). */
+export declare function resetMetricsForTests(): void;
+/** Сериализация в Prometheus text format. */
+export declare function getMetricsText(): Promise<string>;
+export declare function getMetricsContentType(): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,KAAK,EAEN,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,QAAQ,sDAAiB,CAAC;AAOvC,eAAO,MAAM,gBAAgB,uCAK3B,CAAC;AAEH,eAAO,MAAM,kBAAkB,mBAO7B,CAAC;AAEH,eAAO,MAAM,cAAc,0BAKzB,CAAC;AAIH,eAAO,MAAM,iBAAiB,uBAK5B,CAAC;AAEH,eAAO,MAAM,mBAAmB,uBAK9B,CAAC;AAEH,eAAO,MAAM,gBAAgB,qBAK3B,CAAC;AAIH,eAAO,MAAM,yBAAyB,gCAKpC,CAAC;AAIH,eAAO,MAAM,uBAAuB,eAIlC,CAAC;AAIH,eAAO,MAAM,wBAAwB,kBAKnC,CAAC;AAEH,eAAO,MAAM,sBAAsB,mBAKjC,CAAC;AAEH,eAAO,MAAM,8BAA8B,iBAKzC,CAAC;AAEH,eAAO,MAAM,4BAA4B,kBAKvC,CAAC;AAEH,eAAO,MAAM,qBAAqB,+BAKhC,CAAC;AAIH,eAAO,MAAM,qBAAqB,6BAKhC,CAAC;AAUH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMtD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMvD;AAQD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,EAClC,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,GAClB,IAAI,CAGN;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAED,6CAA6C;AAC7C,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/observability/metrics.js

@@ -0,0 +1,184 @@
+import { Registry, Counter, Histogram, Gauge, collectDefaultMetrics, } from 'prom-client';
+/**
+ * Prometheus metrics для MCP-сервера.
+ *
+ * Источник истины по именам — `todo/error-logs-service/mcp/07-observability.md`
+ * § 1. Категории:
+ *   - RED (rate / errors / duration)        — `mcp_requests_total`, `mcp_request_duration_seconds`, `mcp_errors_total`
+ *   - Cache                                  — `mcp_cache_hits_total`, `mcp_cache_misses_total`, `mcp_cache_hit_ratio`
+ *   - Upstream (ELS)                         — `mcp_els_upstream_errors_total`
+ *   - SSE / sessions                         — `mcp_sse_connections_active`
+ *   - Security                               — `mcp_redaction_applied_total`
+ *   - Billing                                — `mcp_billing_events_total`
+ *
+ * Регистр — singleton (один на процесс). Endpoint `/els/metrics` сериализует
+ * текущее состояние в Prometheus text format.
+ */
+export const registry = new Registry();
+// Default метрики (process_cpu, nodejs_eventloop_lag, etc) — собираются автоматически.
+collectDefaultMetrics({ register: registry, prefix: 'mcp_' });
+// ─── RED (rate / errors / duration) ───────────────────────────────────────
+export const mcpRequestsTotal = new Counter({
+    name: 'mcp_requests_total',
+    help: 'Total tool-call requests',
+    labelNames: ['tool', 'status', 'cached'],
+    registers: [registry],
+});
+export const mcpRequestDuration = new Histogram({
+    name: 'mcp_request_duration_seconds',
+    help: 'Tool-call duration histogram',
+    labelNames: ['tool'],
+    // 12 buckets per spec § 1.1 (07-observability.md)
+    buckets: [0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2, 5, 10, 20, 30],
+    registers: [registry],
+});
+export const mcpErrorsTotal = new Counter({
+    name: 'mcp_errors_total',
+    help: 'Total tool-call errors by code',
+    labelNames: ['tool', 'code'],
+    registers: [registry],
+});
+// ─── Cache ───────────────────────────────────────────────────────────────
+export const mcpCacheHitsTotal = new Counter({
+    name: 'mcp_cache_hits_total',
+    help: 'Cache hits per tool-class',
+    labelNames: ['tool_class'],
+    registers: [registry],
+});
+export const mcpCacheMissesTotal = new Counter({
+    name: 'mcp_cache_misses_total',
+    help: 'Cache misses per tool-class',
+    labelNames: ['tool_class'],
+    registers: [registry],
+});
+export const mcpCacheHitRatio = new Gauge({
+    name: 'mcp_cache_hit_ratio',
+    help: 'Cache hit ratio per tool-class (manually updated every 10s)',
+    labelNames: ['tool_class'],
+    registers: [registry],
+});
+// ─── Upstream (ELS) ──────────────────────────────────────────────────────
+export const mcpElsUpstreamErrorsTotal = new Counter({
+    name: 'mcp_els_upstream_errors_total',
+    help: 'Total upstream ELS errors (HTTP status >= 400)',
+    labelNames: ['endpoint', 'status'],
+    registers: [registry],
+});
+// ─── SSE / sessions ──────────────────────────────────────────────────────
+export const mcpSseConnectionsActive = new Gauge({
+    name: 'mcp_sse_connections_active',
+    help: 'Active SSE connections (for HPA)',
+    registers: [registry],
+});
+// ─── Security ────────────────────────────────────────────────────────────
+export const mcpRedactionAppliedTotal = new Counter({
+    name: 'mcp_redaction_applied_total',
+    help: 'Number of times redaction was applied per field',
+    labelNames: ['field'],
+    registers: [registry],
+});
+export const mcpAuthRejectionsTotal = new Counter({
+    name: 'mcp_auth_rejections_total',
+    help: 'Total auth rejections by reason',
+    labelNames: ['reason'],
+    registers: [registry],
+});
+export const mcpPromptInjectionBlockedTotal = new Counter({
+    name: 'mcp_prompt_injection_blocked_total',
+    help: 'Times suspicious content was detected and (potentially) blocked, by rule',
+    labelNames: ['rule'],
+    registers: [registry],
+});
+export const mcpSseConnectionsActiveByApp = new Gauge({
+    name: 'mcp_sse_connections_active_by_app',
+    help: 'Active SSE/MCP sessions per appSlug (per-tenant cap enforcement)',
+    labelNames: ['appSlug'],
+    registers: [registry],
+});
+export const mcpSseRejectionsTotal = new Counter({
+    name: 'mcp_sse_rejections_total',
+    help: 'SSE/MCP session-create rejections by reason (concurrency, tier...)',
+    labelNames: ['reason', 'appSlug'],
+    registers: [registry],
+});
+// ─── Billing ─────────────────────────────────────────────────────────────
+export const mcpBillingEventsTotal = new Counter({
+    name: 'mcp_billing_events_total',
+    help: 'Per-tool counter for billing (appSlug, tier)',
+    labelNames: ['appSlug', 'tier'],
+    registers: [registry],
+});
+// ─── Helpers (используются из cache wrapper и tools) ─────────────────────
+/**
+ * Внутренние счётчики per tool-class — для расчёта `mcp_cache_hit_ratio`
+ * без блокировки на recording rules Prometheus.
+ */
+const cacheStats = {};
+export function recordCacheHit(toolClass) {
+    mcpCacheHitsTotal.inc({ tool_class: toolClass });
+    const s = cacheStats[toolClass] ?? { hits: 0, misses: 0 };
+    s.hits += 1;
+    cacheStats[toolClass] = s;
+    updateHitRatio(toolClass, s);
+}
+export function recordCacheMiss(toolClass) {
+    mcpCacheMissesTotal.inc({ tool_class: toolClass });
+    const s = cacheStats[toolClass] ?? { hits: 0, misses: 0 };
+    s.misses += 1;
+    cacheStats[toolClass] = s;
+    updateHitRatio(toolClass, s);
+}
+function updateHitRatio(toolClass, s) {
+    const total = s.hits + s.misses;
+    if (total === 0)
+        return;
+    mcpCacheHitRatio.set({ tool_class: toolClass }, s.hits / total);
+}
+export function recordToolRequest(tool, status, cached, durationSec) {
+    mcpRequestsTotal.inc({ tool, status, cached: String(cached) });
+    mcpRequestDuration.observe({ tool }, durationSec);
+}
+export function recordToolError(tool, code) {
+    mcpErrorsTotal.inc({ tool, code });
+}
+export function recordUpstreamError(endpoint, status) {
+    mcpElsUpstreamErrorsTotal.inc({ endpoint, status: String(status) });
+}
+export function recordRedaction(field) {
+    mcpRedactionAppliedTotal.inc({ field });
+}
+export function recordBillingEvent(appSlug, tier) {
+    mcpBillingEventsTotal.inc({ appSlug, tier });
+}
+export function recordAuthRejection(reason) {
+    mcpAuthRejectionsTotal.inc({ reason });
+}
+export function recordPromptInjectionBlocked(rule) {
+    mcpPromptInjectionBlockedTotal.inc({ rule });
+}
+export function incSseActive(appSlug) {
+    mcpSseConnectionsActiveByApp.inc({ appSlug });
+    mcpSseConnectionsActive.inc();
+}
+export function decSseActive(appSlug) {
+    mcpSseConnectionsActiveByApp.dec({ appSlug });
+    mcpSseConnectionsActive.dec();
+}
+export function recordSseRejection(reason, appSlug) {
+    mcpSseRejectionsTotal.inc({ reason, appSlug });
+}
+/** Сброс per-process состояния (для тестов). */
+export function resetMetricsForTests() {
+    registry.resetMetrics();
+    for (const k of Object.keys(cacheStats)) {
+        delete cacheStats[k];
+    }
+}
+/** Сериализация в Prometheus text format. */
+export async function getMetricsText() {
+    return registry.metrics();
+}
+export function getMetricsContentType() {
+    return registry.contentType;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/observability/tracing.d.ts

@@ -0,0 +1,28 @@
+import type { Logger } from 'pino';
+/**
+ * OpenTelemetry SDK setup (опциональный).
+ *
+ * Включается через `OTEL_EXPORTER_OTLP_ENDPOINT`. Если переменная не задана —
+ * tracing полностью disabled, no-op, нет оверхеда.
+ *
+ * Auto-instrumentation:
+ *   - HTTP / undici (upstream ELS calls)
+ *   - Express (Phase 3)
+ *   - ioredis (cache GET / SETEX)
+ *
+ * Custom spans:
+ *   - `mcp.tool.{name}` — оборачивает каждый tool handler (вручную в Phase 3).
+ *
+ * Lazy import: `@opentelemetry/sdk-node` — тяжёлая зависимость (~30MB), грузим
+ * только если endpoint задан. Это снижает cold-start время stdio-режима.
+ */
+export interface TracingHandle {
+    /** Завершить SDK (call before process exit). */
+    shutdown: () => Promise<void>;
+    /** Запущен ли SDK. */
+    enabled: boolean;
+}
+export declare function setupTracing(opts?: {
+    log?: Logger;
+}): Promise<TracingHandle>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/observability/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAOD,wBAAsB,YAAY,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA+DtF"}

package/dist/observability/tracing.js

@@ -0,0 +1,56 @@
+const NOOP = {
+    shutdown: async () => { },
+    enabled: false,
+};
+export async function setupTracing(opts = {}) {
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint) {
+        opts.log?.debug?.('OTel disabled (OTEL_EXPORTER_OTLP_ENDPOINT not set)');
+        return NOOP;
+    }
+    try {
+        const [{ NodeSDK }, autoInst, otlp, resourceModule] = await Promise.all([
+            import('@opentelemetry/sdk-node'),
+            import('@opentelemetry/auto-instrumentations-node'),
+            import('@opentelemetry/exporter-trace-otlp-proto'),
+            import('@opentelemetry/resources'),
+        ]);
+        const sdkAny = NodeSDK;
+        // Resource API в @opentelemetry/resources может экспортироваться по-разному
+        // (Resource как класс или resourceFromAttributes-функция в новых версиях).
+        const resAny = resourceModule;
+        const attrs = {
+            'service.name': 'els-mcp',
+            'service.version': process.env.GIT_SHA ?? '0.1.0-alpha.0',
+            'deployment.environment': process.env.NODE_ENV ?? 'development',
+        };
+        const resource = resAny.resourceFromAttributes
+            ? resAny.resourceFromAttributes(attrs)
+            : resAny.Resource
+                ? new resAny.Resource(attrs)
+                : undefined;
+        const sdk = new sdkAny({
+            ...(resource ? { resource } : {}),
+            traceExporter: new otlp.OTLPTraceExporter({ url: endpoint }),
+            instrumentations: [autoInst.getNodeAutoInstrumentations()],
+        });
+        sdk.start();
+        opts.log?.info?.({ endpoint }, 'OpenTelemetry tracing started');
+        return {
+            enabled: true,
+            shutdown: async () => {
+                try {
+                    await sdk.shutdown();
+                }
+                catch (err) {
+                    opts.log?.warn?.({ err: err.message }, 'OTel shutdown failed');
+                }
+            },
+        };
+    }
+    catch (err) {
+        opts.log?.warn?.({ err: err.message }, 'OTel setup failed; continuing without tracing');
+        return NOOP;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/observability/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AA2BA,MAAM,IAAI,GAAkB;IAC1B,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACxB,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB,EAAE;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,qDAAqD,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtE,MAAM,CAAC,yBAAyB,CAAC;YACjC,MAAM,CAAC,2CAA2C,CAAC;YACnD,MAAM,CAAC,0CAA0C,CAAC;YAClD,MAAM,CAAC,0BAA0B,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,OAGd,CAAC;QAEF,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,MAAM,GAAG,cAGd,CAAC;QACF,MAAM,KAAK,GAAG;YACZ,cAAc,EAAE,SAAS;YACzB,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe;YACzD,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;SAChE,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,sBAAsB;YAC5C,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,KAAK,CAAC;YACtC,CAAC,CAAC,MAAM,CAAC,QAAQ;gBACf,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC5B,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;YACrB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,aAAa,EAAE,IAAI,IAAI,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;YAC5D,gBAAgB,EAAE,CAAC,QAAQ,CAAC,2BAA2B,EAAE,CAAC;SAC3D,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,+BAA+B,CAAC,CAAC;QAEhE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,IAAI,CAAC;oBACH,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACvB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CACd,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,EAC/B,+CAA+C,CAChD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Logger } from 'pino';
+/**
+ * Phase 2 MCP-prompts: предопределённые шаблоны разговоров для типовых
+ * сценариев SRE / release engineer.
+ *
+ * Каждый prompt:
+ *   - имеет argsSchema (Zod raw shape — SDK генерит JSON Schema автоматически);
+ *   - возвращает один user-message с rendered template;
+ *   - инструктирует LLM, какие именно tools вызвать (tool-chain).
+ *
+ * Темплейты — multi-line строки на русском, рендеринг через простую
+ * `${value}`-подстановку (без mustache — не хотим тащить зависимость).
+ */
+export interface RegisterPromptsOptions {
+    log?: Logger;
+}
+export declare const ALL_PROMPT_NAMES: readonly ["triage-recent-errors", "find-regression-since-deploy", "explain-error-cluster", "weekly-error-report"];
+export declare function registerPrompts(server: McpServer, opts?: RegisterPromptsOptions): string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,gBAAgB,mHAKnB,CAAC;AAaX,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,EAAE,CA4N9F"}