@inso_web/els-mcp 0.1.0

package/dist/http/routes/health.js

@@ -0,0 +1,73 @@
+import { Router } from 'express';
+import os from 'node:os';
+import { checkLiveness, checkReadiness, } from '../../observability/health.js';
+export function createHealthRouter(opts = {}) {
+    const router = Router();
+    router.get('/health', insoHealthHandler()); // INSO Uptime contract
+    router.get('/healthz', livenessHandler()); // legacy
+    router.get('/ready', readinessHandler(opts)); // INSO Uptime contract
+    router.get('/readyz', readinessHandler(opts)); // legacy
+    return router;
+}
+function livenessHandler() {
+    return function handler(_req, res) {
+        const liv = checkLiveness();
+        res.status(200).json({ status: liv.status, uptimeSec: liv.uptimeSec, version: liv.version });
+    };
+}
+/**
+ * INSO Uptime contract — формат идентичный другим микросервисам платформы
+ * (см. error-logs-service/src/routes/health.routes.ts). LK health-monitor
+ * парсит поле `version` (`BUILD_VERSION` из CI build timestamp).
+ */
+function insoHealthHandler() {
+    return function handler(_req, res) {
+        const liv = checkLiveness();
+        res.status(200).json({
+            status: liv.status,
+            uptime: liv.uptimeSec,
+            hostname: os.hostname(),
+            version: process.env.BUILD_VERSION || liv.version,
+        });
+    };
+}
+function readinessHandler(opts) {
+    return async function handler(_req, res) {
+        // checks: { els: 'ok' | 'fail' | 'skip', redis: ... }
+        // Используем Phase 4 checkReadiness с тем же контрактом.
+        const checks = {};
+        let allOk = true;
+        if (opts.elsClient || opts.redis) {
+            const result = await checkReadiness({
+                ...(opts.elsClient ? { elsClient: opts.elsClient } : {}),
+                ...(opts.redis ? { redis: opts.redis } : {}),
+                ...(opts.log ? { log: opts.log } : {}),
+                timeoutMs: 2000,
+            });
+            checks.els = opts.elsClient ? (result.checks.upstream.ok ? 'ok' : 'fail') : 'skip';
+            checks.redis = opts.redis ? (result.checks.redis.ok ? 'ok' : 'fail') : 'skip';
+            if (result.status !== 'ready')
+                allOk = false;
+        }
+        else {
+            checks.els = 'skip';
+            checks.redis = 'skip';
+        }
+        for (const probe of opts.probes ?? []) {
+            try {
+                await probe.check();
+                checks[probe.name] = 'ok';
+            }
+            catch (err) {
+                opts.log?.warn?.({ err: errMsg(err), probe: probe.name }, 'readyz: probe failed');
+                checks[probe.name] = 'fail';
+                allOk = false;
+            }
+        }
+        res.status(allOk ? 200 : 503).json({ status: allOk ? 'ok' : 'degraded', checks });
+    };
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=health.js.map

package/dist/http/routes/health.js.map

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

package/dist/http/routes/metrics.d.ts

@@ -0,0 +1,18 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type ReadinessDeps } from '../../observability/health.js';
+/**
+ * Lightweight HTTP handlers для Express-like транспорта (Phase 3).
+ *
+ * Каждый handler — `(req, res) => Promise<void>` (совместимо с Node http
+ * и Express `(req, res, next?)`). Phase 3 их подцепит:
+ *
+ *   app.get('/els/metrics', metricsHandler);
+ *   app.get('/els/healthz', healthzHandler);
+ *   app.get('/els/readyz',  readyzHandler(deps));
+ *
+ * Phase 4 предоставляет реализацию; Phase 3 — wiring.
+ */
+export declare function metricsHandler(_req: IncomingMessage, res: ServerResponse): Promise<void>;
+export declare function healthzHandler(_req: IncomingMessage, res: ServerResponse): void;
+export declare function readyzHandler(deps: ReadinessDeps): (_req: IncomingMessage, res: ServerResponse) => Promise<void>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/http/routes/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/http/routes/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAElG;;;;;;;;;;;GAWG;AAEH,wBAAsB,cAAc,CAClC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAK/E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,IACjC,MAAM,eAAe,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC,CAMzE"}

package/dist/http/routes/metrics.js

@@ -0,0 +1,42 @@
+import { getMetricsContentType, getMetricsText } from '../../observability/metrics.js';
+import { checkLiveness, checkReadiness } from '../../observability/health.js';
+/**
+ * Lightweight HTTP handlers для Express-like транспорта (Phase 3).
+ *
+ * Каждый handler — `(req, res) => Promise<void>` (совместимо с Node http
+ * и Express `(req, res, next?)`). Phase 3 их подцепит:
+ *
+ *   app.get('/els/metrics', metricsHandler);
+ *   app.get('/els/healthz', healthzHandler);
+ *   app.get('/els/readyz',  readyzHandler(deps));
+ *
+ * Phase 4 предоставляет реализацию; Phase 3 — wiring.
+ */
+export async function metricsHandler(_req, res) {
+    try {
+        const body = await getMetricsText();
+        res.statusCode = 200;
+        res.setHeader('content-type', getMetricsContentType());
+        res.end(body);
+    }
+    catch (err) {
+        res.statusCode = 500;
+        res.setHeader('content-type', 'text/plain; charset=utf-8');
+        res.end(`# metrics error: ${err.message}\n`);
+    }
+}
+export function healthzHandler(_req, res) {
+    const body = checkLiveness();
+    res.statusCode = 200;
+    res.setHeader('content-type', 'application/json');
+    res.end(JSON.stringify(body));
+}
+export function readyzHandler(deps) {
+    return async (_req, res) => {
+        const result = await checkReadiness(deps);
+        res.statusCode = result.status === 'ready' ? 200 : 503;
+        res.setHeader('content-type', 'application/json');
+        res.end(JSON.stringify(result));
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/http/routes/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/http/routes/metrics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAsB,MAAM,+BAA+B,CAAC;AAElG;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAqB,EACrB,GAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;QACpC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,oBAAqB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAqB,EAAE,GAAmB;IACvE,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;IACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,OAAO,KAAK,EAAE,IAAqB,EAAE,GAAmB,EAAiB,EAAE;QACzE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACvD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}

package/dist/http/routes/wellKnown.d.ts

@@ -0,0 +1,15 @@
+import { Router } from 'express';
+import type { Config } from '../../config.js';
+/**
+ * Well-known discovery endpoints:
+ *   - `/.well-known/oauth-protected-resource` (RFC 9728)
+ *   - `/.well-known/mcp` (MCP-specific discovery)
+ *
+ * Оба статичны (зависят только от config), отдаются без auth.
+ */
+export interface CreateWellKnownOptions {
+    config: Config;
+    toolNames: string[];
+}
+export declare function createWellKnownRouter(opts: CreateWellKnownOptions): Router;
+//# sourceMappingURL=wellKnown.d.ts.map

package/dist/http/routes/wellKnown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wellKnown.d.ts","sourceRoot":"","sources":["../../../src/http/routes/wellKnown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAuB,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;GAMG;AAEH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAK1E"}

package/dist/http/routes/wellKnown.js

@@ -0,0 +1,43 @@
+import { Router } from 'express';
+export function createWellKnownRouter(opts) {
+    const router = Router();
+    router.get('/oauth-protected-resource', protectedResource(opts.config));
+    router.get('/mcp', mcpDiscovery(opts.config, opts.toolNames));
+    return router;
+}
+function protectedResource(config) {
+    // Trailing slash для `resource` — стандартное представление "tenant boundary"
+    // в RFC 9728. Должно совпадать с тем, что отдаётся в WWW-Authenticate.
+    const resource = `${config.publicUrl}/`;
+    const body = {
+        resource,
+        authorization_servers: [config.oidcIssuer],
+        scopes_supported: ['errors:mcp-read'],
+        bearer_methods_supported: ['header'],
+    };
+    return function handler(_req, res) {
+        res.setHeader('Cache-Control', 'public, max-age=300');
+        res.status(200).json(body);
+    };
+}
+function mcpDiscovery(config, toolNames) {
+    const body = {
+        protocolVersion: '2025-03-26',
+        transports: ['streamable-http'],
+        tools: toolNames,
+        auth: {
+            type: 'oauth2',
+            authorizationServer: config.oidcIssuer,
+            resource: `${config.publicUrl}/`,
+        },
+        endpoints: {
+            mcp: `${config.publicUrl}/mcp`,
+        },
+        documentation: `${config.publicUrl}/docs`,
+    };
+    return function handler(_req, res) {
+        res.setHeader('Cache-Control', 'public, max-age=300');
+        res.status(200).json(body);
+    };
+}
+//# sourceMappingURL=wellKnown.js.map

package/dist/http/routes/wellKnown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wellKnown.js","sourceRoot":"","sources":["../../../src/http/routes/wellKnown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAuB,MAAM,SAAS,CAAC;AAgBtD,MAAM,UAAU,qBAAqB,CAAC,IAA4B;IAChE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc;IACvC,8EAA8E;IAC9E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,qBAAqB,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;QAC1C,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;QACrC,wBAAwB,EAAE,CAAC,QAAQ,CAAC;KACrC,CAAC;IACF,OAAO,SAAS,OAAO,CAAC,IAAI,EAAE,GAAG;QAC/B,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,SAAmB;IACvD,MAAM,IAAI,GAAG;QACX,eAAe,EAAE,YAAY;QAC7B,UAAU,EAAE,CAAC,iBAAiB,CAAC;QAC/B,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,mBAAmB,EAAE,MAAM,CAAC,UAAU;YACtC,QAAQ,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG;SACjC;QACD,SAAS,EAAE;YACT,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,MAAM;SAC/B;QACD,aAAa,EAAE,GAAG,MAAM,CAAC,SAAS,OAAO;KAC1C,CAAC;IACF,OAAO,SAAS,OAAO,CAAC,IAAI,EAAE,GAAG;QAC/B,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/dist/http/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Типы для HTTP-транспорта.
+ *
+ * `RequestContext` собирается в auth middleware и потом доступен в
+ * Express handler'ах через `req.context`. Декларация augmentation модуля
+ * `express-serve-static-core` лежит ниже — она добавляет `context` к Request.
+ */
+export type AuthMethod = 'els-key' | 'oidc';
+export interface RequestContext {
+    /** Способ аутентификации, по которому пользователь прошёл. */
+    authMethod: AuthMethod;
+    /** Только для `els-key`: оригинальный Bearer-ключ для проксирования в ELS. */
+    elsApiKey?: string;
+    /** Только для `oidc`: `sub` claim из JWT. */
+    oidcSub?: string;
+    /** Только для `oidc`: scope claim (raw array). */
+    scopes?: string[];
+    /**
+     * Slug приложения, к которому привязан этот запрос. Для `els-key` пока
+     * `unknown` (на Phase 3 не дёргаем ELS resolver); для `oidc` — берётся
+     * из MCP_OIDC_DEMO_APP_SLUG (TODO Phase 4: реальный LK resolver).
+     */
+    appSlug: string;
+    /** Короткий identifier для логов: первые 8 chars ELS-key или OIDC sub. */
+    keyId: string;
+    ip: string;
+    userAgent: string;
+    /** MCP `Mcp-Session-Id` header (если есть). */
+    sessionId?: string;
+    /** request-id middleware: уникален per-запрос. */
+    requestId: string;
+}
+declare module 'express-serve-static-core' {
+    interface Request {
+        context?: RequestContext;
+        /** Per-request child logger (pino). Заполняется в requestId middleware. */
+        log?: import('pino').Logger;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,UAAU,EAAE,UAAU,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,OAAO,QAAQ,2BAA2B,CAAC;IACzC,UAAU,OAAO;QACf,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,2EAA2E;QAC3E,GAAG,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC;KAC7B;CACF"}

package/dist/http/types.js

@@ -0,0 +1,9 @@
+/**
+ * Типы для HTTP-транспорта.
+ *
+ * `RequestContext` собирается в auth middleware и потом доступен в
+ * Express handler'ах через `req.context`. Декларация augmentation модуля
+ * `express-serve-static-core` лежит ниже — она добавляет `context` к Request.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/http/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/http/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/instrumentation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Phase 6: OpenTelemetry instrumentation entry-point.
+ *
+ * Этот файл должен импортироваться **первым** в `cli.ts` (до любых других
+ * модулей, которые делают `import` HTTP/Redis-клиентов). OTel SDK
+ * патчит prototype'ы зависимостей при старте — это работает корректно
+ * только если он стартовал ДО создания этих instance'ов.
+ *
+ * Если `OTEL_EXPORTER_OTLP_ENDPOINT` не задан — функция возвращает no-op
+ * handle (tracing disabled, нулевой overhead).
+ *
+ * Идея взята из `observability/tracing.ts` (Phase 4), но вынесена отдельно,
+ * чтобы был чёткий "earliest possible" entry-point.
+ */
+import { type TracingHandle } from './observability/tracing.js';
+/**
+ * Инициализирует OTel SDK, если задан endpoint.
+ * Безопасно вызывать несколько раз — повторные вызовы — no-op.
+ */
+export declare function initInstrumentation(): Promise<TracingHandle>;
+export declare function getInstrumentationHandle(): TracingHandle | null;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI9E;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CAYlE;AAED,wBAAgB,wBAAwB,IAAI,aAAa,GAAG,IAAI,CAE/D"}

package/dist/instrumentation.js

@@ -0,0 +1,38 @@
+/**
+ * Phase 6: OpenTelemetry instrumentation entry-point.
+ *
+ * Этот файл должен импортироваться **первым** в `cli.ts` (до любых других
+ * модулей, которые делают `import` HTTP/Redis-клиентов). OTel SDK
+ * патчит prototype'ы зависимостей при старте — это работает корректно
+ * только если он стартовал ДО создания этих instance'ов.
+ *
+ * Если `OTEL_EXPORTER_OTLP_ENDPOINT` не задан — функция возвращает no-op
+ * handle (tracing disabled, нулевой overhead).
+ *
+ * Идея взята из `observability/tracing.ts` (Phase 4), но вынесена отдельно,
+ * чтобы был чёткий "earliest possible" entry-point.
+ */
+import { setupTracing } from './observability/tracing.js';
+let handle = null;
+/**
+ * Инициализирует OTel SDK, если задан endpoint.
+ * Безопасно вызывать несколько раз — повторные вызовы — no-op.
+ */
+export async function initInstrumentation() {
+    if (handle)
+        return handle;
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint) {
+        handle = {
+            enabled: false,
+            shutdown: async () => { },
+        };
+        return handle;
+    }
+    handle = await setupTracing();
+    return handle;
+}
+export function getInstrumentationHandle() {
+    return handle;
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,4BAA4B,CAAC;AAE9E,IAAI,MAAM,GAAyB,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG;YACP,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACzB,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/cursor.d.ts

@@ -0,0 +1,22 @@
+import type { CursorPayload } from '../types.js';
+export declare function hashFilters(filters: unknown): string;
+/**
+ * Кодирует cursor для следующей страницы.
+ *
+ * @param anchor — последний item текущей страницы (или null если страница пуста).
+ * @param filters — объект текущих фильтров для подсчёта hash.
+ * @param nextPage — Phase 1: следующий номер страницы для offset-pagination.
+ * @param limit — page size.
+ */
+export declare function encodeCursor(anchor: {
+    receivedAt: string;
+    id: string;
+} | null, filters: unknown, nextPage: number, limit: number): string;
+/**
+ * Декодирует cursor и валидирует filters-hash.
+ *
+ * Возвращает payload. Бросает ToolError('INVALID_ARGS') если cursor невалиден
+ * или фильтры между страницами изменились.
+ */
+export declare function decodeCursor(cursor: string, currentFilters: unknown): CursorPayload;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/lib/cursor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAqCjD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACjD,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,aAAa,CAoCnF"}

package/dist/lib/cursor.js

@@ -0,0 +1,95 @@
+import { createHash } from 'node:crypto';
+import { ToolError } from './errors.js';
+/**
+ * Seek-cursor utilities.
+ *
+ * Phase 1 — transitional: cursor wraps offset/page (т.к. ELS пока offset-based).
+ * Реальный seek-by-(receivedAt, id) появится в Phase 4 после изменения ELS.
+ * До этого момента:
+ *   - `encodeCursor` берёт последний item страницы как anchor, и сохраняет
+ *     page/limit для offset-pagination upstream;
+ *   - `decodeCursor` разворачивает обратно и проверяет filtersHash,
+ *     чтобы клиент не мог тащить cursor между разными filter-наборами.
+ *
+ * Контракт `filtersHash`: SHA-256 канонического JSON (отсортированные ключи)
+ * первых 16 hex-символов. Это компромисс между «защитой» и «коротким cursor'ом».
+ */
+const CURSOR_VERSION = 1;
+/**
+ * Канонический JSON-сериализатор: ключи сортируются, undefined и пустые
+ * массивы выкидываются (чтобы `{ a: undefined }` и `{}` давали одинаковый hash).
+ */
+function canonicalJson(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        const compact = value.filter((v) => v !== undefined);
+        return '[' + compact.map(canonicalJson).join(',') + ']';
+    }
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined && !(Array.isArray(v) && v.length === 0))
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return '{' + entries.map(([k, v]) => JSON.stringify(k) + ':' + canonicalJson(v)).join(',') + '}';
+}
+export function hashFilters(filters) {
+    return createHash('sha256').update(canonicalJson(filters)).digest('hex').slice(0, 16);
+}
+/**
+ * Кодирует cursor для следующей страницы.
+ *
+ * @param anchor — последний item текущей страницы (или null если страница пуста).
+ * @param filters — объект текущих фильтров для подсчёта hash.
+ * @param nextPage — Phase 1: следующий номер страницы для offset-pagination.
+ * @param limit — page size.
+ */
+export function encodeCursor(anchor, filters, nextPage, limit) {
+    const payload = {
+        anchorReceivedAt: anchor?.receivedAt ?? new Date(0).toISOString(),
+        anchorId: anchor?.id ?? '',
+        filtersHash: hashFilters(filters),
+        v: CURSOR_VERSION,
+        page: nextPage,
+        limit,
+    };
+    const json = JSON.stringify(payload);
+    return Buffer.from(json, 'utf8').toString('base64url');
+}
+/**
+ * Декодирует cursor и валидирует filters-hash.
+ *
+ * Возвращает payload. Бросает ToolError('INVALID_ARGS') если cursor невалиден
+ * или фильтры между страницами изменились.
+ */
+export function decodeCursor(cursor, currentFilters) {
+    let payload;
+    try {
+        const json = Buffer.from(cursor, 'base64url').toString('utf8');
+        payload = JSON.parse(json);
+    }
+    catch (err) {
+        throw new ToolError('INVALID_ARGS', 'Malformed cursor (not valid base64url JSON)', {
+            cause: err,
+        });
+    }
+    if (!payload || typeof payload !== 'object') {
+        throw new ToolError('INVALID_ARGS', 'Cursor payload is not an object');
+    }
+    const p = payload;
+    if (p.v !== CURSOR_VERSION) {
+        throw new ToolError('INVALID_ARGS', `Unsupported cursor version: ${String(p.v)}`);
+    }
+    if (typeof p.anchorReceivedAt !== 'string' || typeof p.anchorId !== 'string') {
+        throw new ToolError('INVALID_ARGS', 'Cursor missing anchor fields');
+    }
+    if (typeof p.filtersHash !== 'string') {
+        throw new ToolError('INVALID_ARGS', 'Cursor missing filtersHash');
+    }
+    const expected = hashFilters(currentFilters);
+    if (p.filtersHash !== expected) {
+        throw new ToolError('INVALID_ARGS', 'Filters changed between pages. Restart pagination without cursor.', { suggestedAction: 'Pass cursor=null and re-fetch the first page.' });
+    }
+    return p;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/lib/cursor.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Унифицированный класс ошибок для всех ELS-запросов и tool handler'ов.
+ *
+ * Мапится 1-в-1 в MCP-стандартный error shape:
+ *   { isError: true, content: [{ type: 'text', text: <msg> }],
+ *     _meta: { code, retryAfter?, suggestedAction? } }
+ *
+ * Коды (соответствуют todo/error-logs-service/mcp/03-tools-catalog.md §0.2):
+ *   - RATE_LIMITED         — 429 от ELS
+ *   - UPSTREAM_UNAVAILABLE — 5xx от ELS (после retry)
+ *   - INVALID_ARGS         — 400 от ELS, либо локальная валидация
+ *   - NOT_FOUND            — 404 (отсутствует traceId, app и т.д.)
+ *   - INSUFFICIENT_SCOPE   — 403 от ELS
+ *   - QUOTA_EXCEEDED       — для AI-tools в будущем
+ *   - INTERNAL             — fallback для непредвиденных ситуаций
+ */
+export type ToolErrorCode = 'RATE_LIMITED' | 'UPSTREAM_UNAVAILABLE' | 'INVALID_ARGS' | 'NOT_FOUND' | 'INSUFFICIENT_SCOPE' | 'QUOTA_EXCEEDED' | 'TIER_QUOTA_EXCEEDED' | 'INTERNAL';
+export declare class ToolError extends Error {
+    readonly code: ToolErrorCode;
+    readonly retryAfter?: number;
+    readonly suggestedAction?: string;
+    readonly meta?: Record<string, unknown>;
+    constructor(code: ToolErrorCode, message: string, options?: {
+        retryAfter?: number;
+        suggestedAction?: string;
+        meta?: Record<string, unknown>;
+        cause?: unknown;
+    });
+    /**
+     * Сериализация в MCP-tool error response.
+     */
+    toToolResult(): {
+        isError: true;
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+        structuredContent: Record<string, unknown>;
+        _meta: Record<string, unknown>;
+    };
+}
+/**
+ * Преобразовать HTTP-статус и тело ответа ELS в ToolError.
+ *
+ * `body` приходит как уже-распарсенный JSON (или string, если parse не удался).
+ * `retryAfterHeader` — содержимое заголовка Retry-After (секунды).
+ */
+export declare function mapHttpToToolError(status: number, body: unknown, retryAfterHeader?: string | null): ToolError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,sBAAsB,GACtB,cAAc,GACd,WAAW,GACX,oBAAoB,GACpB,gBAAgB,GAChB,qBAAqB,GACrB,UAAU,CAAC;AAEf,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,aAAa,CAAC;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAG7C,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;IAcR;;OAEG;IACH,YAAY,IAAI;QACd,OAAO,EAAE,IAAI,CAAC;QACd,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC;CAaF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B,SAAS,CA4CX"}

package/dist/lib/errors.js

@@ -0,0 +1,83 @@
+export class ToolError extends Error {
+    code;
+    retryAfter;
+    suggestedAction;
+    meta;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = 'ToolError';
+        this.code = code;
+        if (typeof options.retryAfter === 'number')
+            this.retryAfter = options.retryAfter;
+        if (options.suggestedAction)
+            this.suggestedAction = options.suggestedAction;
+        if (options.meta)
+            this.meta = options.meta;
+        if (options.cause !== undefined) {
+            // Стандартный Error.cause — поддерживается Node 20+.
+            this.cause = options.cause;
+        }
+    }
+    /**
+     * Сериализация в MCP-tool error response.
+     */
+    toToolResult() {
+        const _meta = { code: this.code };
+        if (typeof this.retryAfter === 'number')
+            _meta.retryAfter = this.retryAfter;
+        if (this.suggestedAction)
+            _meta.suggestedAction = this.suggestedAction;
+        if (this.meta)
+            Object.assign(_meta, this.meta);
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `[${this.code}] ${this.message}` }],
+            structuredContent: { code: this.code, message: this.message, ...(this.meta ?? {}) },
+            _meta,
+        };
+    }
+}
+/**
+ * Преобразовать HTTP-статус и тело ответа ELS в ToolError.
+ *
+ * `body` приходит как уже-распарсенный JSON (или string, если parse не удался).
+ * `retryAfterHeader` — содержимое заголовка Retry-After (секунды).
+ */
+export function mapHttpToToolError(status, body, retryAfterHeader) {
+    const bodyAny = body;
+    const upstreamMessage = (typeof bodyAny?.message === 'string' && bodyAny.message) ||
+        (typeof bodyAny?.error === 'string' && bodyAny.error) ||
+        `Upstream ELS returned ${status}`;
+    if (status === 429) {
+        const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : undefined;
+        return new ToolError('RATE_LIMITED', upstreamMessage, {
+            retryAfter: Number.isFinite(retryAfter) ? retryAfter : 60,
+            suggestedAction: 'Wait and retry after the specified number of seconds.',
+        });
+    }
+    if (status === 404) {
+        return new ToolError('NOT_FOUND', upstreamMessage);
+    }
+    if (status === 403) {
+        return new ToolError('INSUFFICIENT_SCOPE', upstreamMessage, {
+            suggestedAction: 'API-key lacks required scope. Use a key with broader access.',
+        });
+    }
+    if (status === 401) {
+        return new ToolError('INSUFFICIENT_SCOPE', `Unauthorized: ${upstreamMessage}`, {
+            suggestedAction: 'Check ELS_API_KEY env var.',
+        });
+    }
+    if (status >= 400 && status < 500) {
+        return new ToolError('INVALID_ARGS', upstreamMessage, { meta: { status } });
+    }
+    if (status >= 500) {
+        return new ToolError('UPSTREAM_UNAVAILABLE', upstreamMessage, {
+            retryAfter: 5,
+            suggestedAction: 'Upstream is temporarily unavailable; retry in a few seconds.',
+            meta: { status },
+        });
+    }
+    return new ToolError('INTERNAL', upstreamMessage, { meta: { status } });
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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