@inso_web/els-mcp 0.1.0

package/dist/tools/groupedErrors.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { ToolError } from '../lib/errors.js';
+/**
+ * Tool: grouped_errors
+ * Mapping: GET /analytics/grouped-errors → analytics.routes.ts:329
+ * Upstream Zod: GroupedErrorsSchema (from, to, take, +фасет-фильтры).
+ *
+ * Список уникальных fingerprint'ов, отсортированных по count (default), с
+ * per-group stats: count, firstSeen, lastSeen, affectedUsers, exampleTraceId.
+ *
+ * Phase 2 не пробрасывает sortBy в upstream (ELS-endpoint его не принимает),
+ * но возвращает выбранное значение в structured-content для подсказки LLM.
+ */
+export const groupedErrorsInputShape = {
+    from: z.string().optional(),
+    to: z.string().optional(),
+    level: z.array(z.string().max(16)).optional(),
+    serviceName: z.array(z.string().max(255)).optional(),
+    take: z.number().int().min(1).max(100).default(20),
+    sortBy: z.enum(['count', 'lastSeen', 'affectedUsers']).default('count'),
+};
+export const groupedErrorsToolDef = {
+    name: 'grouped_errors',
+    title: 'Deduplicated error groups',
+    description: 'List of unique fingerprints sorted by occurrence, with per-group stats (count, firstSeen, lastSeen, affectedUsers, exampleTraceId). The "ranked list of all problems" view.',
+    inputShape: groupedErrorsInputShape,
+};
+export async function handleGroupedErrors(args, client) {
+    try {
+        const params = {
+            from: args.from,
+            to: args.to,
+            take: args.take,
+            levels: args.level?.join(','),
+            serviceName: args.serviceName?.join(','),
+        };
+        const { data, elsRequestId } = await client.groupedErrors(params);
+        const body = (data ?? {});
+        const items = Array.isArray(body.data)
+            ? body.data
+            : Array.isArray(body.items)
+                ? body.items
+                : [];
+        const meta = {
+            elsRequestId,
+            cached: false,
+            ttlSec: 60,
+            redactionApplied: false,
+        };
+        return {
+            structuredContent: {
+                items,
+                sortBy: args.sortBy,
+                nextCursor: null,
+                _meta: meta,
+            },
+            content: [
+                {
+                    type: 'text',
+                    text: `${items.length} grouped errors (take=${args.take}, sortBy=${args.sortBy}).`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            return err.toToolResult();
+        throw err;
+    }
+}
+//# sourceMappingURL=groupedErrors.js.map

package/dist/tools/groupedErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupedErrors.js","sourceRoot":"","sources":["../../src/tools/groupedErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CACxE,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,2BAA2B;IAClC,WAAW,EACT,6KAA6K;IAC/K,UAAU,EAAE,uBAAuB;CACpC,CAAC;AAWF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAU,EAAE,MAAiB;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAgD;YAC1D,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC;SACzC,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAElE,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACpC,CAAC,CAAC,IAAI,CAAC,IAAI;YACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAC,IAAI,CAAC,KAAK;gBACZ,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,IAAI,GAAiB;YACzB,YAAY;YACZ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE;YACV,gBAAgB,EAAE,KAAK;SACxB,CAAC;QAEF,OAAO;YACL,iBAAiB,EAAE;gBACjB,KAAK;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,IAAI;aACZ;YACD,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,yBAAyB,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,MAAM,IAAI;iBACnF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS;YAAE,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/impactAnalysis.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import type { ElsClient } from '../elsClient.js';
+import type { ToolResult } from '../types.js';
+/**
+ * Tool: impact_analysis
+ * Mapping: GET /analytics/impact → analytics.routes.ts:344
+ * Upstream Zod: ImpactSchema (from, to, +фасет-фильтры).
+ *
+ * Ранжирует ошибки по impact-score (комбинация frequency / affectedUsers /
+ * severity / recency). Upstream сам считает score; tool пробрасывает.
+ *
+ * Поле `weights` в input — на будущее (Phase 4), upstream его не принимает.
+ */
+export declare const impactAnalysisInputShape: {
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    serviceName: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    take: z.ZodDefault<z.ZodNumber>;
+};
+export declare const impactAnalysisToolDef: {
+    name: string;
+    title: string;
+    description: string;
+    inputShape: {
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        level: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        serviceName: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        take: z.ZodDefault<z.ZodNumber>;
+    };
+};
+type Args = {
+    from?: string;
+    to?: string;
+    level?: string[];
+    serviceName?: string[];
+    take: number;
+};
+export declare function handleImpactAnalysis(args: Args, client: ElsClient): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=impactAnalysis.d.ts.map

package/dist/tools/impactAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactAnalysis.d.ts","sourceRoot":"","sources":["../../src/tools/impactAnalysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;GASG;AAEH,eAAO,MAAM,wBAAwB;;;;;;CAMpC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAMjC,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC7F"}

package/dist/tools/impactAnalysis.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { ToolError } from '../lib/errors.js';
+/**
+ * Tool: impact_analysis
+ * Mapping: GET /analytics/impact → analytics.routes.ts:344
+ * Upstream Zod: ImpactSchema (from, to, +фасет-фильтры).
+ *
+ * Ранжирует ошибки по impact-score (комбинация frequency / affectedUsers /
+ * severity / recency). Upstream сам считает score; tool пробрасывает.
+ *
+ * Поле `weights` в input — на будущее (Phase 4), upstream его не принимает.
+ */
+export const impactAnalysisInputShape = {
+    from: z.string().optional(),
+    to: z.string().optional(),
+    level: z.array(z.string().max(16)).optional(),
+    serviceName: z.array(z.string().max(255)).optional(),
+    take: z.number().int().min(1).max(100).default(20),
+};
+export const impactAnalysisToolDef = {
+    name: 'impact_analysis',
+    title: 'Business-impact score for top errors',
+    description: 'Rank errors by impact score (frequency + affected users + severity + recency). Use for "what should we fix first?".',
+    inputShape: impactAnalysisInputShape,
+};
+export async function handleImpactAnalysis(args, client) {
+    try {
+        const params = {
+            from: args.from,
+            to: args.to,
+            levels: args.level?.join(','),
+            serviceName: args.serviceName?.join(','),
+        };
+        const { data, elsRequestId } = await client.impact(params);
+        const body = (data ?? {});
+        const rawItems = Array.isArray(body.data)
+            ? body.data
+            : Array.isArray(body.items)
+                ? body.items
+                : [];
+        const items = rawItems.slice(0, args.take);
+        const meta = {
+            elsRequestId,
+            cached: false,
+            ttlSec: 300,
+            redactionApplied: false,
+        };
+        return {
+            structuredContent: { items, _meta: meta },
+            content: [
+                { type: 'text', text: `${items.length} errors ranked by impact score.` },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            return err.toToolResult();
+        throw err;
+    }
+}
+//# sourceMappingURL=impactAnalysis.js.map

package/dist/tools/impactAnalysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impactAnalysis.js","sourceRoot":"","sources":["../../src/tools/impactAnalysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACnD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,sCAAsC;IAC7C,WAAW,EACT,qHAAqH;IACvH,UAAU,EAAE,wBAAwB;CACrC,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAU,EAAE,MAAiB;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAuC;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC;SACzC,CAAC;QACF,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3D,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACvC,CAAC,CAAE,IAAI,CAAC,IAAuC;YAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAE,IAAI,CAAC,KAAwC;gBAChD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,IAAI,GAAiB;YACzB,YAAY;YACZ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,GAAG;YACX,gBAAgB,EAAE,KAAK;SACxB,CAAC;QAEF,OAAO;YACL,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;YACzC,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,iCAAiC,EAAE;aACzE;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS;YAAE,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,41 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Logger } from 'pino';
+import type { ElsClient } from '../elsClient.js';
+import { type ToolContext, type MiddlewareDeps } from '../middleware/withMiddleware.js';
+import type { Tier } from '../billing/limits.js';
+/**
+ * Регистрирует все Phase 1 read-only tools на MCP-сервере.
+ *
+ * Каждый tool регистрируется через `server.registerTool(name, config, cb)`.
+ * SDK 1.x принимает Zod raw shape (Record<string, ZodType>) в `inputSchema` и
+ * автоматически валидирует args перед вызовом handler'а. На выходе handler
+ * возвращает `{ structuredContent, content, isError? }`.
+ *
+ * Опционально tool можно отключить через ENV `MCP_DISABLE_TOOLS=name1,name2`.
+ */
+export interface RegisterToolsOptions {
+    client: ElsClient;
+    disabled?: readonly string[];
+    log?: Logger;
+    /**
+     * Phase 5: дополнительный contextProvider для извлечения appId/keyId/tier
+     * из текущего request-контекста (в stdio-режиме обычно константа из config,
+     * в HTTP-режиме — из OIDC claim / API-key). Если не задан, middleware
+     * пропускается и handler вызывается напрямую (legacy-режим).
+     */
+    contextProvider?: () => ToolContext;
+    /** Phase 5: deps для middleware (audit/usage/redaction). */
+    middleware?: MiddlewareDeps;
+}
+export declare function registerTools(server: McpServer, opts: RegisterToolsOptions): string[];
+/**
+ * Phase 5 helper: создаёт ToolContext из переменных окружения для stdio-режима.
+ */
+export declare function makeStdioContext(args: {
+    appId: string;
+    apiKey: string;
+    tier: Tier;
+    log?: Logger;
+}): ToolContext;
+export declare const ALL_TOOL_NAMES: string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAuBjD;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,WAAW,CAAC;IACpC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAiCD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAoDrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,WAAW,CAOd;AAED,eAAO,MAAM,cAAc,UAAmC,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,83 @@
+import { withMiddleware, } from '../middleware/withMiddleware.js';
+import { searchLogsToolDef, handleSearchLogs } from './searchLogs.js';
+import { getLogDetailsToolDef, handleGetLogDetails } from './getLogDetails.js';
+import { findSimilarErrorsToolDef, handleFindSimilarErrors } from './findSimilarErrors.js';
+import { findCorrelatedErrorsToolDef, handleFindCorrelatedErrors, } from './findCorrelatedErrors.js';
+import { topErrorMessagesToolDef, handleTopErrorMessages } from './topErrorMessages.js';
+import { errorHistogramToolDef, handleErrorHistogram } from './errorHistogram.js';
+import { trafficStatsToolDef, handleTrafficStats } from './trafficStats.js';
+import { listAppsToolDef, handleListApps } from './listApps.js';
+import { queryLogsJqlToolDef, handleQueryLogsJql } from './queryLogsJql.js';
+import { errorStatsBreakdownToolDef, handleErrorStatsBreakdown } from './errorStatsBreakdown.js';
+import { groupedErrorsToolDef, handleGroupedErrors } from './groupedErrors.js';
+import { impactAnalysisToolDef, handleImpactAnalysis } from './impactAnalysis.js';
+import { baselineCompareToolDef, handleBaselineCompare } from './baselineCompare.js';
+import { versionRegressionToolDef, handleVersionRegression } from './versionRegression.js';
+import { errorHeatmapToolDef, handleErrorHeatmap } from './errorHeatmap.js';
+import { triageRecentCriticalToolDef, handleTriageRecentCritical } from './triageRecentCritical.js';
+import { errorsInSessionToolDef, handleErrorsInSession } from './errorsInSession.js';
+import { explainErrorToolDef, handleExplainError } from './explainError.js';
+const ALL_TOOLS = [
+    // Phase 1
+    { def: searchLogsToolDef, handler: handleSearchLogs },
+    { def: getLogDetailsToolDef, handler: handleGetLogDetails },
+    { def: findSimilarErrorsToolDef, handler: handleFindSimilarErrors },
+    { def: findCorrelatedErrorsToolDef, handler: handleFindCorrelatedErrors },
+    { def: topErrorMessagesToolDef, handler: handleTopErrorMessages },
+    { def: errorHistogramToolDef, handler: handleErrorHistogram },
+    { def: trafficStatsToolDef, handler: handleTrafficStats },
+    { def: listAppsToolDef, handler: handleListApps },
+    // Phase 2
+    { def: queryLogsJqlToolDef, handler: handleQueryLogsJql },
+    { def: errorStatsBreakdownToolDef, handler: handleErrorStatsBreakdown },
+    { def: groupedErrorsToolDef, handler: handleGroupedErrors },
+    { def: impactAnalysisToolDef, handler: handleImpactAnalysis },
+    { def: baselineCompareToolDef, handler: handleBaselineCompare },
+    { def: versionRegressionToolDef, handler: handleVersionRegression },
+    { def: errorHeatmapToolDef, handler: handleErrorHeatmap },
+    { def: triageRecentCriticalToolDef, handler: handleTriageRecentCritical },
+    { def: errorsInSessionToolDef, handler: handleErrorsInSession },
+    { def: explainErrorToolDef, handler: handleExplainError },
+];
+export function registerTools(server, opts) {
+    const disabled = new Set(opts.disabled ?? []);
+    const registered = [];
+    for (const { def, handler } of ALL_TOOLS) {
+        if (disabled.has(def.name)) {
+            opts.log?.info?.({ tool: def.name }, 'Tool disabled via MCP_DISABLE_TOOLS');
+            continue;
+        }
+        // SDK 1.x: registerTool typed via Zod raw shape; обходим строгий generic
+        // через локальный `any`-каст — handler внутри сам валидирован zod-парсером,
+        // который SDK прогоняет до вызова callback.
+        const register = server.registerTool.bind(server);
+        // Phase 5: если в opts задан contextProvider — оборачиваем handler в
+        // withMiddleware (quota + audit + usage + redaction). Иначе — legacy путь.
+        const effectiveHandler = opts.contextProvider
+            ? withMiddleware(def.name, handler, () => opts.contextProvider(), opts.middleware ?? {})
+            : handler;
+        register(def.name, {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputShape,
+        }, async (args) => {
+            const result = (await effectiveHandler(args, opts.client));
+            return result;
+        });
+        registered.push(def.name);
+    }
+    return registered;
+}
+/**
+ * Phase 5 helper: создаёт ToolContext из переменных окружения для stdio-режима.
+ */
+export function makeStdioContext(args) {
+    return {
+        appId: args.appId,
+        keyId: args.apiKey.slice(0, 8),
+        tier: args.tier,
+        ...(args.log ? { log: args.log } : {}),
+    };
+}
+export const ALL_TOOL_NAMES = ALL_TOOLS.map((t) => t.def.name);
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/listApps.d.ts

@@ -0,0 +1,27 @@
+import type { ElsClient } from '../elsClient.js';
+import type { ToolResult } from '../types.js';
+/**
+ * Tool: list_apps
+ *
+ * Mapping: GET /apps → apps.routes.ts:23 (требует master key, `requireMaster`).
+ *
+ * Поведение Phase 1:
+ *   - Если master-key → возвращает все apps как есть.
+ *   - Если обычный ELS-key → 403 INSUFFICIENT_SCOPE от ELS → graceful fallback:
+ *     отдаём `{ apps: [{ slug: '(current-app)', restricted: true }] }` с
+ *     `_meta.warnings` и `_meta.degraded=true`. Это согласуется с планом
+ *     «derived from API-key context» — для обычного key пользователь и так
+ *     работает в рамках одного app.
+ *
+ * Phase 3: после OAuth-токенов сможем извлечь app-slug из `token.app` claim
+ * и выдавать его без 403-fallback.
+ */
+export declare const listAppsInputShape: {};
+export declare const listAppsToolDef: {
+    name: string;
+    title: string;
+    description: string;
+    inputShape: {};
+};
+export declare function handleListApps(_args: Record<string, never>, client: ElsClient): Promise<ToolResult>;
+//# sourceMappingURL=listApps.d.ts.map

package/dist/tools/listApps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApps.d.ts","sourceRoot":"","sources":["../../src/tools/listApps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,IAAK,CAAC;AAErC,eAAO,MAAM,eAAe;;;;;CAM3B,CAAC;AAEF,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAoDzG"}

package/dist/tools/listApps.js

@@ -0,0 +1,78 @@
+import { ToolError } from '../lib/errors.js';
+/**
+ * Tool: list_apps
+ *
+ * Mapping: GET /apps → apps.routes.ts:23 (требует master key, `requireMaster`).
+ *
+ * Поведение Phase 1:
+ *   - Если master-key → возвращает все apps как есть.
+ *   - Если обычный ELS-key → 403 INSUFFICIENT_SCOPE от ELS → graceful fallback:
+ *     отдаём `{ apps: [{ slug: '(current-app)', restricted: true }] }` с
+ *     `_meta.warnings` и `_meta.degraded=true`. Это согласуется с планом
+ *     «derived from API-key context» — для обычного key пользователь и так
+ *     работает в рамках одного app.
+ *
+ * Phase 3: после OAuth-токенов сможем извлечь app-slug из `token.app` claim
+ * и выдавать его без 403-fallback.
+ */
+export const listAppsInputShape = {};
+export const listAppsToolDef = {
+    name: 'list_apps',
+    title: 'List apps available to current API-key',
+    description: 'List apps (tenants) accessible to the current API key. For a regular key — one app; for a master key — all active apps.',
+    inputShape: listAppsInputShape,
+};
+export async function handleListApps(_args, client) {
+    try {
+        const { data, elsRequestId } = await client.listApps();
+        const apps = (data?.apps ?? []).map((a) => ({
+            slug: a.slug,
+            name: a.name,
+            tier: a.rateLimitTier,
+            isActive: a.isActive,
+            createdAt: a.createdAt,
+        }));
+        const meta = {
+            elsRequestId,
+            cached: false,
+            ttlSec: 300,
+            redactionApplied: false,
+        };
+        return {
+            structuredContent: { apps, _meta: meta },
+            content: [{ type: 'text', text: `${apps.length} app(s) accessible.` }],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError && err.code === 'INSUFFICIENT_SCOPE') {
+            // Graceful fallback: обычный ELS-key не имеет доступа к /apps,
+            // но всегда привязан к одному app (см. apiContext.app.slug в middleware).
+            const meta = {
+                elsRequestId: null,
+                cached: false,
+                ttlSec: 300,
+                redactionApplied: false,
+                degraded: true,
+                warnings: [
+                    'API key lacks master scope; cannot enumerate apps. Returning current-app placeholder.',
+                ],
+            };
+            return {
+                structuredContent: {
+                    apps: [{ slug: '(current-app)', name: 'Current app', isActive: true, restricted: true }],
+                    _meta: meta,
+                },
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Current API key is scoped to a single app. Use a master key to enumerate all apps.',
+                    },
+                ],
+            };
+        }
+        if (err instanceof ToolError)
+            return err.toToolResult();
+        throw err;
+    }
+}
+//# sourceMappingURL=listApps.js.map

package/dist/tools/listApps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApps.js","sourceRoot":"","sources":["../../src/tools/listApps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,wCAAwC;IAC/C,WAAW,EACT,yHAAyH;IAC3H,UAAU,EAAE,kBAAkB;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA4B,EAAE,MAAiB;IAClF,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,aAAa;YACrB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,GAAiB;YACzB,YAAY;YACZ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,GAAG;YACX,gBAAgB,EAAE,KAAK;SACxB,CAAC;QAEF,OAAO;YACL,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YACxC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,qBAAqB,EAAE,CAAC;SACvE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAClE,+DAA+D;YAC/D,0EAA0E;YAC1E,MAAM,IAAI,GAAiB;gBACzB,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,GAAG;gBACX,gBAAgB,EAAE,KAAK;gBACvB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE;oBACR,uFAAuF;iBACxF;aACF,CAAC;YACF,OAAO;gBACL,iBAAiB,EAAE;oBACjB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;oBACxF,KAAK,EAAE,IAAI;iBACZ;gBACD,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oFAAoF;qBAC3F;iBACF;aACF,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,YAAY,SAAS;YAAE,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/tools/queryLogsJql.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import type { ElsClient } from '../elsClient.js';
+import type { ResponseFormat, ToolResult } from '../types.js';
+export declare const queryLogsJqlInputShape: {
+    filter: z.ZodOptional<z.ZodType<unknown, z.ZodTypeDef, unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["receivedAt", "level", "message"]>>;
+    order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    response_format: z.ZodDefault<z.ZodEnum<["compact", "full", "summary"]>>;
+};
+export declare const queryLogsJqlToolDef: {
+    name: string;
+    title: string;
+    description: string;
+    inputShape: {
+        filter: z.ZodOptional<z.ZodType<unknown, z.ZodTypeDef, unknown>>;
+        search: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        sort: z.ZodDefault<z.ZodEnum<["receivedAt", "level", "message"]>>;
+        order: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+        response_format: z.ZodDefault<z.ZodEnum<["compact", "full", "summary"]>>;
+    };
+};
+type Args = {
+    filter?: unknown;
+    search?: string;
+    from?: string;
+    to?: string;
+    limit: number;
+    offset: number;
+    sort: 'receivedAt' | 'level' | 'message';
+    order: 'asc' | 'desc';
+    response_format: ResponseFormat;
+};
+export declare function handleQueryLogsJql(args: Args, client: ElsClient): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=queryLogsJql.d.ts.map

package/dist/tools/queryLogsJql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryLogsJql.d.ts","sourceRoot":"","sources":["../../src/tools/queryLogsJql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAuC,UAAU,EAAE,MAAM,aAAa,CAAC;AAoCnG,eAAO,MAAM,sBAAsB;;;;;;;;;;CAalC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;CAM/B,CAAC;AAEF,KAAK,IAAI,GAAG;IACV,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;IACzC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,eAAe,EAAE,cAAc,CAAC;CACjC,CAAC;AAMF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAwD3F"}

package/dist/tools/queryLogsJql.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { ToolError } from '../lib/errors.js';
+import { applyResponseFormat } from '../lib/responseFormat.js';
+/**
+ * Tool: query_logs_jql
+ * Mapping: POST /errors/query → analytics.routes.ts:60
+ * Upstream Zod: JqlQueryRequestSchema (filter AST, pagination, search).
+ *
+ * Поддерживает структурные boolean-условия (AND/OR/NOT/IN/comparison) поверх
+ * whitelisted полей ErrorLog. AST формат полностью совпадает с upstream
+ * ExprAst (см. schemas/jql.schema.ts) — мы пробрасываем body как есть.
+ *
+ * Limits (upstream): depth ≤ 8, nodes ≤ 100, IN-list ≤ 50, value ≤ 500 chars.
+ * При превышении ELS вернёт 400 → INVALID_ARGS.
+ *
+ * Defaults: limit=20, response_format=compact, sort=receivedAt desc.
+ */
+const JQL_OP_VALUES = ['=', '!=', '~', '!~', 'in', 'not_in', '>', '<', '>=', '<='];
+// Recursive AST schema — зеркало FilterAstSchema из upstream.
+// Используем z.ZodType<unknown> чтобы избежать чрезмерной типизации в SDK.
+const PrimitiveValueSchema = z.union([z.string().max(500), z.number(), z.boolean()]);
+const ExprSchema = z.lazy(() => z.union([
+    z.object({
+        type: z.literal('comparison'),
+        field: z.string().min(1).max(64),
+        op: z.enum(JQL_OP_VALUES),
+        value: z.union([PrimitiveValueSchema, z.array(PrimitiveValueSchema).max(50)]),
+    }),
+    z.object({ type: z.literal('and'), children: z.array(ExprSchema).min(1).max(50) }),
+    z.object({ type: z.literal('or'), children: z.array(ExprSchema).min(1).max(50) }),
+    z.object({ type: z.literal('not'), child: ExprSchema }),
+]));
+export const queryLogsJqlInputShape = {
+    filter: ExprSchema.optional().describe('Filter AST (comparison / and / or / not). Fields whitelisted upstream; ops per field-type.'),
+    search: z.string().max(500).optional(),
+    from: z.string().optional().describe('ISO timestamp. Default: 1h ago.'),
+    to: z.string().optional(),
+    limit: z.number().int().min(1).max(200).default(20),
+    offset: z.number().int().min(0).default(0),
+    sort: z.enum(['receivedAt', 'level', 'message']).default('receivedAt'),
+    order: z.enum(['asc', 'desc']).default('desc'),
+    // eslint-disable-next-line camelcase
+    response_format: z.enum(['compact', 'full', 'summary']).default('compact'),
+};
+export const queryLogsJqlToolDef = {
+    name: 'query_logs_jql',
+    title: 'Query logs with JQL filter AST',
+    description: 'Run a JQL-like structured query with nested AND/OR/NOT groups and IN/NOT_IN operators on whitelisted fields. Use when search_logs cannot express boolean logic.',
+    inputShape: queryLogsJqlInputShape,
+};
+function defaultFrom() {
+    return new Date(Date.now() - 60 * 60 * 1000).toISOString();
+}
+export async function handleQueryLogsJql(args, client) {
+    try {
+        const body = {
+            pagination: {
+                from: args.from ?? defaultFrom(),
+                to: args.to,
+                limit: args.limit,
+                offset: args.offset,
+                sort: args.sort,
+                order: args.order,
+            },
+        };
+        if (args.filter !== undefined)
+            body.filter = args.filter;
+        if (args.search !== undefined)
+            body.search = args.search;
+        const { data, elsRequestId } = await client.queryLogsJql(body);
+        const raw = data;
+        const { items: formattedItems, truncated } = applyResponseFormat(raw.items ?? [], args.response_format);
+        const total = Number(raw.total ?? 0);
+        const hasMore = args.offset + args.limit < total;
+        const meta = {
+            elsRequestId,
+            cached: false,
+            ttlSec: 15,
+            redactionApplied: false,
+            truncated,
+        };
+        return {
+            structuredContent: {
+                items: formattedItems,
+                total,
+                facets: raw.facets ?? {},
+                histogram: raw.histogram ?? [],
+                nextCursor: null,
+                offset: args.offset,
+                hasMore,
+                _meta: meta,
+            },
+            content: [
+                {
+                    type: 'text',
+                    text: `Matched ${total} logs via JQL (showing ${formattedItems.length}, offset ${args.offset}).`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            return err.toToolResult();
+        throw err;
+    }
+}
+//# sourceMappingURL=queryLogsJql.js.map

package/dist/tools/queryLogsJql.js.map

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