@inso_web/els-mcp 0.1.0

package/dist/lib/responseFormat.d.ts

@@ -0,0 +1,14 @@
+import type { ErrorLog, ErrorLogCompact, ErrorLogSummary, ResponseFormat } from '../types.js';
+export interface ApplyResponseFormatResult<T> {
+    items: T[];
+    truncated: boolean;
+}
+export declare function applyResponseFormat(items: ErrorLog[], format: ResponseFormat): ApplyResponseFormatResult<ErrorLog | ErrorLogCompact | ErrorLogSummary>;
+/**
+ * Сокращает поля одного ErrorLog (для get_log_details при compact-format).
+ */
+export declare function applyResponseFormatSingle(row: ErrorLog, format: 'compact' | 'full'): {
+    log: ErrorLog | ErrorLogCompact;
+    truncated: boolean;
+};
+//# sourceMappingURL=responseFormat.d.ts.map

package/dist/lib/responseFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseFormat.d.ts","sourceRoot":"","sources":["../../src/lib/responseFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAiBrB,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,cAAc,GACrB,yBAAyB,CAAC,QAAQ,GAAG,eAAe,GAAG,eAAe,CAAC,CAsCzE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,SAAS,GAAG,MAAM,GACzB;IAAE,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAgBzD"}

package/dist/lib/responseFormat.js

@@ -0,0 +1,74 @@
+/**
+ * Применяет `response_format` к массиву ErrorLog items.
+ *
+ * - `compact` (default): убирает `stack`, `componentStack`, `userAgent`,
+ *   обрезает `message` до 200 символов. Подходит для LLM-context-safe browse.
+ * - `full`: возвращает items как есть.
+ * - `summary`: только traceId/message/level/lastSeen/count.
+ *
+ * Также возвращает флаг `truncated` — true, если хотя бы один message был обрезан
+ * (используется в `_meta.truncated`).
+ */
+const MESSAGE_MAX_COMPACT = 200;
+const MESSAGE_MAX_SUMMARY = 200;
+export function applyResponseFormat(items, format) {
+    if (format === 'full') {
+        return { items, truncated: false };
+    }
+    if (format === 'summary') {
+        let truncated = false;
+        const result = items.map((row) => {
+            const msg = row.message ?? '';
+            const sliced = msg.length > MESSAGE_MAX_SUMMARY ? msg.slice(0, MESSAGE_MAX_SUMMARY) : msg;
+            if (sliced.length < msg.length)
+                truncated = true;
+            return {
+                traceId: row.traceId,
+                message: sliced,
+                level: row.level,
+                lastSeen: row.receivedAt,
+            };
+        });
+        return { items: result, truncated };
+    }
+    // compact (default)
+    let truncated = false;
+    const result = items.map((row) => {
+        const msg = row.message ?? '';
+        const sliced = msg.length > MESSAGE_MAX_COMPACT ? msg.slice(0, MESSAGE_MAX_COMPACT) : msg;
+        if (sliced.length < msg.length)
+            truncated = true;
+        return {
+            traceId: row.traceId,
+            level: row.level,
+            message: sliced,
+            serviceName: row.serviceName || null,
+            url: row.url ?? null,
+            fingerprint: row.fingerprint ?? null,
+            receivedAt: row.receivedAt,
+        };
+    });
+    return { items: result, truncated };
+}
+/**
+ * Сокращает поля одного ErrorLog (для get_log_details при compact-format).
+ */
+export function applyResponseFormatSingle(row, format) {
+    if (format === 'full')
+        return { log: row, truncated: false };
+    const msg = row.message ?? '';
+    const sliced = msg.length > MESSAGE_MAX_COMPACT ? msg.slice(0, MESSAGE_MAX_COMPACT) : msg;
+    return {
+        log: {
+            traceId: row.traceId,
+            level: row.level,
+            message: sliced,
+            serviceName: row.serviceName || null,
+            url: row.url ?? null,
+            fingerprint: row.fingerprint ?? null,
+            receivedAt: row.receivedAt,
+        },
+        truncated: sliced.length < msg.length,
+    };
+}
+//# sourceMappingURL=responseFormat.js.map

package/dist/lib/responseFormat.js.map

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

package/dist/middleware/withMiddleware.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Phase 5 tool-handler middleware:
+ *   1. Quota check (`checkQuota`) перед основным запросом.
+ *   2. Audit log + usage tracker (fire-and-forget) после.
+ *   3. Redaction items в response (если ENV redactionEnabled = true).
+ *
+ * Не вносит изменений в существующие tool handlers — оборачивает их в
+ * registry. Это позволяет Phase 2 параллельно дописывать новые tools, не
+ * боясь merge conflicts.
+ *
+ * См. todo/error-logs-service/mcp/06-security.md §2.4, §3, 08-billing-integration.md §2.
+ */
+import type { Logger } from 'pino';
+import type { ToolResult } from '../types.js';
+import { type RedactionConfig } from '../redaction/index.js';
+import { type AuditService } from '../audit/service.js';
+import { type UsageTracker } from '../billing/tracker.js';
+import type { Tier, QuotaDecision } from '../billing/limits.js';
+export interface ToolContext {
+    /** Текущий app (из API-key / OAuth claim / config.defaultAppId). */
+    appId: string;
+    /** Prefix API-key (8 chars). */
+    keyId: string;
+    /** Tier для quota-check. */
+    tier: Tier;
+    /** Optional logger. */
+    log?: Logger;
+    /** Optional request meta для audit (ip/userAgent/sessionId). */
+    ip?: string | null;
+    userAgent?: string | null;
+    sessionId?: string | null;
+}
+export interface MiddlewareDeps {
+    audit?: AuditService;
+    usage?: UsageTracker;
+    redactionConfig?: RedactionConfig;
+    /** В Phase 5 опциональный — quota берётся из usage tracker. */
+    quotaCheck?: (ctx: ToolContext) => Promise<QuotaDecision>;
+}
+type AnyArgs = Record<string, unknown>;
+type Handler<TArgs extends AnyArgs, TClient> = (args: TArgs, client: TClient) => Promise<ToolResult>;
+/**
+ * Оборачивает существующий tool handler.
+ *
+ * Семантика:
+ *   - Если `quotaCheck`-result `allowed=false` → возвращаем ToolError('TIER_QUOTA_EXCEEDED').
+ *   - При `overage=true` (grace) добавляем `_meta.overage=true` к ответу.
+ *   - После handler-вызова прогоняем items / log через redaction.
+ *   - Audit + usage пишутся fire-and-forget (void).
+ */
+export declare function withMiddleware<TArgs extends AnyArgs, TClient>(toolName: string, handler: Handler<TArgs, TClient>, getContext: (args: TArgs, client: TClient) => ToolContext, deps?: MiddlewareDeps): Handler<TArgs, TClient>;
+export {};
+//# sourceMappingURL=withMiddleware.d.ts.map

package/dist/middleware/withMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withMiddleware.d.ts","sourceRoot":"","sources":["../../src/middleware/withMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3D;AAED,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,KAAK,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAErG;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAAE,OAAO,EAC3D,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAChC,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,KAAK,WAAW,EACzD,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAqHzB"}

package/dist/middleware/withMiddleware.js

@@ -0,0 +1,190 @@
+/**
+ * Phase 5 tool-handler middleware:
+ *   1. Quota check (`checkQuota`) перед основным запросом.
+ *   2. Audit log + usage tracker (fire-and-forget) после.
+ *   3. Redaction items в response (если ENV redactionEnabled = true).
+ *
+ * Не вносит изменений в существующие tool handlers — оборачивает их в
+ * registry. Это позволяет Phase 2 параллельно дописывать новые tools, не
+ * боясь merge conflicts.
+ *
+ * См. todo/error-logs-service/mcp/06-security.md §2.4, §3, 08-billing-integration.md §2.
+ */
+import { ToolError } from '../lib/errors.js';
+import { redactErrorLogs, redactValue } from '../redaction/index.js';
+import { getAuditService } from '../audit/service.js';
+import { getUsageTracker } from '../billing/tracker.js';
+/**
+ * Оборачивает существующий tool handler.
+ *
+ * Семантика:
+ *   - Если `quotaCheck`-result `allowed=false` → возвращаем ToolError('TIER_QUOTA_EXCEEDED').
+ *   - При `overage=true` (grace) добавляем `_meta.overage=true` к ответу.
+ *   - После handler-вызова прогоняем items / log через redaction.
+ *   - Audit + usage пишутся fire-and-forget (void).
+ */
+export function withMiddleware(toolName, handler, getContext, deps = {}) {
+    return async (args, client) => {
+        const ctx = getContext(args, client);
+        const log = ctx.log;
+        const start = Date.now();
+        const audit = deps.audit ?? getAuditService();
+        const usage = deps.usage ?? getUsageTracker();
+        // 1. Quota
+        let quota = null;
+        try {
+            quota = deps.quotaCheck
+                ? await deps.quotaCheck(ctx)
+                : await usage.checkQuota(ctx.appId, ctx.tier);
+        }
+        catch (err) {
+            log?.warn?.({ err }, 'Quota check failed; allowing request');
+        }
+        if (quota && !quota.allowed) {
+            const latencyMs = Date.now() - start;
+            void audit.recordToolCall({
+                appId: ctx.appId,
+                keyId: ctx.keyId,
+                tool: toolName,
+                args: redactValue(args).value,
+                resultBytes: 0,
+                latencyMs,
+                cacheHit: false,
+                ...(ctx.ip !== undefined ? { ip: ctx.ip } : {}),
+                ...(ctx.userAgent !== undefined ? { userAgent: ctx.userAgent } : {}),
+                ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}),
+                statusCode: 429,
+                error: 'TIER_QUOTA_EXCEEDED',
+            });
+            const err = new ToolError('TIER_QUOTA_EXCEEDED', `Daily request quota exceeded for ${ctx.tier} tier. Try again after ${quota.retryAfter ?? 0}s.`, {
+                ...(quota.retryAfter !== undefined ? { retryAfter: quota.retryAfter } : {}),
+                suggestedAction: 'Wait for the daily reset or upgrade your tier.',
+                meta: { tier: ctx.tier, remaining: 0 },
+            });
+            return err.toToolResult();
+        }
+        // 2. Run handler
+        let result;
+        let statusCode = 200;
+        let errorMessage = null;
+        try {
+            result = await handler(args, client);
+            if (result.isError) {
+                statusCode = 500;
+                const meta = (result._meta ?? {});
+                const code = typeof meta.code === 'string' ? meta.code : 'INTERNAL';
+                errorMessage = code;
+            }
+        }
+        catch (err) {
+            statusCode = 500;
+            errorMessage = err instanceof Error ? err.message : String(err);
+            const latencyMs = Date.now() - start;
+            void audit.recordToolCall({
+                appId: ctx.appId,
+                keyId: ctx.keyId,
+                tool: toolName,
+                args: redactValue(args).value,
+                resultBytes: 0,
+                latencyMs,
+                cacheHit: false,
+                ...(ctx.ip !== undefined ? { ip: ctx.ip } : {}),
+                ...(ctx.userAgent !== undefined ? { userAgent: ctx.userAgent } : {}),
+                ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}),
+                statusCode,
+                error: errorMessage,
+            });
+            throw err;
+        }
+        // 3. Redaction
+        const redacted = applyRedactionToResult(result, deps.redactionConfig);
+        // Add quota meta if grace zone
+        if (quota?.overage) {
+            const meta = (redacted._meta ?? {});
+            redacted._meta = { ...meta, overage: true, tier: ctx.tier };
+        }
+        // 4. Audit + usage (fire-and-forget)
+        const latencyMs = Date.now() - start;
+        const resultBytes = estimateBytes(redacted);
+        void audit.recordToolCall({
+            appId: ctx.appId,
+            keyId: ctx.keyId,
+            tool: toolName,
+            args: redactValue(args).value,
+            resultBytes,
+            latencyMs,
+            cacheHit: !!(redacted.structuredContent?._meta && redacted.structuredContent._meta.cached === true),
+            ...(ctx.ip !== undefined ? { ip: ctx.ip } : {}),
+            ...(ctx.userAgent !== undefined ? { userAgent: ctx.userAgent } : {}),
+            ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}),
+            statusCode,
+            error: errorMessage,
+        });
+        void usage.trackUsage({
+            appId: ctx.appId,
+            tool: toolName,
+            bytesOut: resultBytes,
+        });
+        return redacted;
+    };
+}
+/**
+ * Применяет redaction к items / log внутри ToolResult.structuredContent.
+ *
+ * Эвристика:
+ *   - Если есть `items: array` — прогоняем через `redactErrorLogs`.
+ *   - Если есть `log: object` — прогоняем `redactErrorLog`-аналог.
+ *   - Помечаем `_meta.redactionApplied = true` если что-то отредактировано.
+ */
+function applyRedactionToResult(result, cfg) {
+    const sc = result.structuredContent;
+    if (!sc)
+        return result;
+    const newSc = { ...sc };
+    let redactionAppliedAny = false;
+    if (Array.isArray(newSc.items)) {
+        const items = newSc.items;
+        const { items: redactedItems, stats } = redactErrorLogs(items, cfg ? { config: cfg } : {});
+        newSc.items = redactedItems;
+        if (stats.fieldsHit.length > 0 || stats.suspiciousContentBlocked) {
+            redactionAppliedAny = true;
+        }
+        if (stats.suspiciousContentBlocked) {
+            const meta = (newSc._meta ?? {});
+            newSc._meta = {
+                ...meta,
+                suspiciousContentBlocked: true,
+                suspiciousRule: stats.suspiciousRule,
+            };
+        }
+    }
+    if (newSc.log && typeof newSc.log === 'object' && !Array.isArray(newSc.log)) {
+        const { items: redactedItems, stats } = redactErrorLogs([newSc.log], cfg ? { config: cfg } : {});
+        newSc.log = redactedItems[0];
+        if (stats.fieldsHit.length > 0 || stats.suspiciousContentBlocked) {
+            redactionAppliedAny = true;
+        }
+        if (stats.suspiciousContentBlocked) {
+            const meta = (newSc._meta ?? {});
+            newSc._meta = {
+                ...meta,
+                suspiciousContentBlocked: true,
+                suspiciousRule: stats.suspiciousRule,
+            };
+        }
+    }
+    if (redactionAppliedAny) {
+        const meta = (newSc._meta ?? {});
+        newSc._meta = { ...meta, redactionApplied: true };
+    }
+    return { ...result, structuredContent: newSc };
+}
+function estimateBytes(result) {
+    try {
+        return Buffer.byteLength(JSON.stringify(result), 'utf8');
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=withMiddleware.js.map

package/dist/middleware/withMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withMiddleware.js","sourceRoot":"","sources":["../../src/middleware/withMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAwB,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAqB,MAAM,uBAAuB,CAAC;AA6B3E;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAAgC,EAChC,UAAyD,EACzD,OAAuB,EAAE;IAEzB,OAAO,KAAK,EAAE,IAAW,EAAE,MAAe,EAAuB,EAAE;QACjE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;QAE9C,WAAW;QACX,IAAI,KAAK,GAAyB,IAAI,CAAC;QACvC,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,UAAU;gBACrB,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAC5B,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,sCAAsC,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACrC,KAAK,KAAK,CAAC,cAAc,CAAC;gBACxB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAgC;gBACxD,WAAW,EAAE,CAAC;gBACd,SAAS;gBACT,QAAQ,EAAE,KAAK;gBACf,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,UAAU,EAAE,GAAG;gBACf,KAAK,EAAE,qBAAqB;aAC7B,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,SAAS,CACvB,qBAAqB,EACrB,oCAAoC,GAAG,CAAC,IAAI,0BAA0B,KAAK,CAAC,UAAU,IAAI,CAAC,IAAI,EAC/F;gBACE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,eAAe,EAAE,gDAAgD;gBACjE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;aACvC,CACF,CAAC;YACF,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAkB,CAAC;QACvB,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,YAAY,GAAkB,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,UAAU,GAAG,GAAG,CAAC;gBACjB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;gBAC7D,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;gBACpE,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAG,GAAG,CAAC;YACjB,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACrC,KAAK,KAAK,CAAC,cAAc,CAAC;gBACxB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAgC;gBACxD,WAAW,EAAE,CAAC;gBACd,SAAS;gBACT,QAAQ,EAAE,KAAK;gBACf,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,UAAU;gBACV,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;YACH,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,eAAe;QACf,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAEtE,+BAA+B;QAC/B,IAAI,KAAK,EAAE,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;YAC/D,QAAQ,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9D,CAAC;QAED,qCAAqC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACrC,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE5C,KAAK,KAAK,CAAC,cAAc,CAAC;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAgC;YACxD,WAAW;YACX,SAAS;YACT,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,IAAK,QAAQ,CAAC,iBAAiB,CAAC,KAAiC,CAAC,MAAM,KAAK,IAAI,CAAC;YAChI,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,UAAU;YACV,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QAEH,KAAK,KAAK,CAAC,UAAU,CAAC;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,MAAkB,EAAE,GAAqB;IACvE,MAAM,EAAE,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAEvB,MAAM,KAAK,GAA4B,EAAE,GAAG,EAAE,EAAE,CAAC;IACjD,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAuC,CAAC;QAC5D,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC;QAC5B,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjE,mBAAmB,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;YAC5D,KAAK,CAAC,KAAK,GAAG;gBACZ,GAAG,IAAI;gBACP,wBAAwB,EAAE,IAAI;gBAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,eAAe,CACrD,CAAC,KAAK,CAAC,GAA8B,CAAC,EACtC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3B,CAAC;QACF,KAAK,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjE,mBAAmB,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;YAC5D,KAAK,CAAC,KAAK,GAAG;gBACZ,GAAG,IAAI;gBACP,wBAAwB,EAAE,IAAI;gBAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;QAC5D,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,MAAkB;IACvC,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/observability/health.d.ts

@@ -0,0 +1,51 @@
+import type { Logger } from 'pino';
+import type { RedisService } from '../cache/redis.js';
+import type { ElsClient } from '../elsClient.js';
+/**
+ * Health checks для k8s liveness/readiness probes.
+ *
+ * - `liveness` — всегда 200 OK, если процесс жив (EventLoop не deadlock'нут).
+ *   Используется k8s `livenessProbe` для рестарта pod'а.
+ *
+ * - `readiness` — 200 если ВСЕ зависимости healthy:
+ *     * Redis: `PING` → `PONG`
+ *     * ELS upstream: HEAD/GET `/health` (или просто `/`)
+ *   503 если хотя бы одна failed. Используется k8s `readinessProbe`
+ *   (исключение pod'а из service endpoints).
+ *
+ * Phase 3 (HTTP transport) подцепит эти функции в Express routes
+ * `/els/healthz` и `/els/readyz` через DI.
+ */
+export interface LivenessResult {
+    status: 'ok';
+    uptimeSec: number;
+    version: string;
+}
+export interface ReadinessResult {
+    status: 'ready' | 'not_ready';
+    checks: {
+        redis: {
+            ok: boolean;
+            latencyMs?: number;
+            error?: string;
+        };
+        upstream: {
+            ok: boolean;
+            latencyMs?: number;
+            error?: string;
+            status?: number;
+        };
+    };
+}
+export declare function checkLiveness(): LivenessResult;
+export interface ReadinessDeps {
+    redis?: RedisService | null;
+    elsClient?: ElsClient | null;
+    /** Override endpoint для probe; иначе используется heuristic /health. */
+    elsHealthPath?: string;
+    log?: Logger;
+    /** Timeout per check, ms. */
+    timeoutMs?: number;
+}
+export declare function checkReadiness(deps?: ReadinessDeps): Promise<ReadinessResult>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/observability/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IAC9B,MAAM,EAAE;QACN,KAAK,EAAE;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3D,QAAQ,EAAE;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChF,CAAC;CACH;AAID,wBAAgB,aAAa,IAAI,cAAc,CAM9C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBvF"}

package/dist/observability/health.js

@@ -0,0 +1,77 @@
+const SERVICE_VERSION = process.env.GIT_SHA ?? process.env.npm_package_version ?? '0.1.0-alpha.0';
+export function checkLiveness() {
+    return {
+        status: 'ok',
+        uptimeSec: Math.round(process.uptime()),
+        version: SERVICE_VERSION,
+    };
+}
+export async function checkReadiness(deps = {}) {
+    const timeoutMs = deps.timeoutMs ?? 3000;
+    const [redisCheck, upstreamCheck] = await Promise.all([
+        deps.redis ? withTimeout(checkRedis(deps.redis), timeoutMs) : Promise.resolve({ ok: true }),
+        deps.elsClient
+            ? withTimeout(checkUpstream(deps.elsClient, deps.elsHealthPath), timeoutMs)
+            : Promise.resolve({ ok: true }),
+    ]);
+    const ready = redisCheck.ok && upstreamCheck.ok;
+    return {
+        status: ready ? 'ready' : 'not_ready',
+        checks: {
+            redis: redisCheck,
+            upstream: upstreamCheck,
+        },
+    };
+}
+async function checkRedis(redis) {
+    // Redis "недоступен" — это допустимое degraded состояние: cache miss всегда.
+    // Поэтому для readyz считаем "ok" если либо Redis pingается, либо disabled.
+    // Если был сконфигурирован, но не отвечает → not ready (force k8s degrade).
+    const start = Date.now();
+    try {
+        const ok = await redis.ping();
+        const latencyMs = Date.now() - start;
+        if (!ok) {
+            return { ok: false, latencyMs, error: 'ping failed' };
+        }
+        return { ok: true, latencyMs };
+    }
+    catch (err) {
+        return { ok: false, error: err.message };
+    }
+}
+async function checkUpstream(client, pathHint) {
+    // ELS известен через client'а. Не у всех методов есть health-check;
+    // делаем "lightweight probe" — пробуем listApps() с очень коротким timeout.
+    // Если 401/403 — endpoint reachable, но key недостаточно для list_apps; всё равно ok.
+    // Если 5xx или connection refused — not ready.
+    void pathHint;
+    const start = Date.now();
+    try {
+        await client.listApps();
+        return { ok: true, latencyMs: Date.now() - start };
+    }
+    catch (err) {
+        const e = err;
+        const status = e?.meta?.status;
+        // INSUFFICIENT_SCOPE (403) / NOT_FOUND (404) — ELS reachable, это ok.
+        if (e?.code === 'INSUFFICIENT_SCOPE' ||
+            e?.code === 'NOT_FOUND' ||
+            e?.code === 'INVALID_ARGS') {
+            return { ok: true, latencyMs: Date.now() - start, ...(status !== undefined ? { status } : {}) };
+        }
+        return {
+            ok: false,
+            latencyMs: Date.now() - start,
+            error: e?.message ?? 'unknown',
+            ...(status !== undefined ? { status } : {}),
+        };
+    }
+}
+function withTimeout(p, ms) {
+    return Promise.race([
+        p,
+        new Promise((resolve) => setTimeout(() => resolve({ ok: false, error: 'timeout' }), ms)),
+    ]);
+}
+//# sourceMappingURL=health.js.map

package/dist/observability/health.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,8 @@
+export { registry, mcpRequestsTotal, mcpRequestDuration, mcpErrorsTotal, mcpCacheHitsTotal, mcpCacheMissesTotal, mcpCacheHitRatio, mcpElsUpstreamErrorsTotal, mcpSseConnectionsActive, mcpRedactionAppliedTotal, mcpBillingEventsTotal, recordCacheHit, recordCacheMiss, recordToolRequest, recordToolError, recordUpstreamError, recordRedaction, recordBillingEvent, resetMetricsForTests, getMetricsText, getMetricsContentType, } from './metrics.js';
+export { createLogger, getLogger, setLogger, withRequestContext } from './logger.js';
+export type { LoggerConfig, RequestLogFields } from './logger.js';
+export { setupTracing } from './tracing.js';
+export type { TracingHandle } from './tracing.js';
+export { checkLiveness, checkReadiness } from './health.js';
+export type { LivenessResult, ReadinessResult, ReadinessDeps } from './health.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,5 @@
+export { registry, mcpRequestsTotal, mcpRequestDuration, mcpErrorsTotal, mcpCacheHitsTotal, mcpCacheMissesTotal, mcpCacheHitRatio, mcpElsUpstreamErrorsTotal, mcpSseConnectionsActive, mcpRedactionAppliedTotal, mcpBillingEventsTotal, recordCacheHit, recordCacheMiss, recordToolRequest, recordToolError, recordUpstreamError, recordRedaction, recordBillingEvent, resetMetricsForTests, getMetricsText, getMetricsContentType, } from './metrics.js';
+export { createLogger, getLogger, setLogger, withRequestContext } from './logger.js';
+export { setupTracing } from './tracing.js';
+export { checkLiveness, checkReadiness } from './health.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/observability/logger.d.ts

@@ -0,0 +1,45 @@
+import { type Logger } from 'pino';
+/**
+ * Structured logger (pino, JSON output).
+ *
+ * Принципы:
+ *   - stdout зарезервирован под JSON-RPC (stdio transport) → все pino-логи
+ *     идут в stderr.
+ *   - Format: JSON по умолчанию. Pretty-print в dev (`NODE_ENV=development`,
+ *     если установлен pino-pretty).
+ *   - Redaction: secrets автоматически замещаются на `<REDACTED>` (см. § 2.4
+ *     спеки `07-observability.md`).
+ *   - Base fields: service, version, pod (HOSTNAME).
+ *
+ * Per-request child logger создаётся в HTTP middleware (Phase 3) через
+ * `logger.child({ requestId, sessionId, appSlug, tool })`.
+ */
+export interface LoggerConfig {
+    level?: string;
+    service?: string;
+    /** Используется в `base.version`. */
+    version?: string;
+    /** Используется в `base.pod` (для k8s identification). */
+    pod?: string;
+    /** Pretty-print для dev. */
+    pretty?: boolean;
+}
+export declare function createLogger(cfg?: LoggerConfig): Logger;
+/** Singleton accessor. */
+export declare function getLogger(): Logger;
+export declare function setLogger(logger: Logger): void;
+/**
+ * Per-request child logger. Поля:
+ *   - requestId, sessionId, appSlug, keyPrefix, tool — для корреляции.
+ */
+export interface RequestLogFields {
+    requestId?: string;
+    sessionId?: string;
+    appSlug?: string | null;
+    keyPrefix?: string;
+    tool?: string;
+    cached?: boolean;
+    latencyMs?: number;
+}
+export declare function withRequestContext(logger: Logger, fields: RequestLogFields): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,MAAM,EAA8C,MAAM,MAAM,CAAC;AAErF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiBD,wBAAgB,YAAY,CAAC,GAAG,GAAE,YAAiB,GAAG,MAAM,CAkD3D;AAED,0BAA0B;AAC1B,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAEnF"}