@testrelic/mcp 2.1.0

package/dist/index.js

@@ -0,0 +1,127 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { mergeConfig, configFromEnv, resolveConfig } from "./config.js";
+import { createLogger, getLogger } from "./logger.js";
+import { metrics } from "./telemetry/metrics.js";
+import { CacheManager } from "./cache/index.js";
+import { buildClients } from "./clients/index.js";
+import { buildContextEngine } from "./context/index.js";
+import { SamplingBridge } from "./sampling/bridge.js";
+import { Elicitor } from "./elicit/ask.js";
+import { ToolRegistry } from "./registry/index.js";
+import { registerAllTools } from "./tools/index.js";
+import { registerResources } from "./resources/index.js";
+import { registerPrompts } from "./prompts/index.js";
+import { version, name } from "./version.js";
+import { startStdio } from "./transport/stdio.js";
+import { startHttp } from "./transport/http.js";
+export async function createServer(inputConfig = {}) {
+    const config = resolveConfig(mergeConfig(configFromEnv(), inputConfig));
+    createLogger(config.logLevel);
+    const server = new McpServer({ name, version }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+            logging: {},
+        },
+        instructions: "TestRelic MCP — intelligent testing context for creation, healing, coverage, and impact. Start with `tr_list_repos` or `tr_coverage_report` to orient; capabilities are gated by the --caps flag to keep the tool schema small.",
+    });
+    metrics.init(config.outputDir);
+    const cache = new CacheManager(config);
+    await cache.init();
+    const clients = buildClients(config);
+    const context = buildContextEngine(clients, cache);
+    const sampling = new SamplingBridge(server);
+    const elicit = new Elicitor(server);
+    // Best-effort bootstrap: one shot to /api/v1/mcp/bootstrap to pull the
+    // authenticated user/org/repo/integration summary. We never block startup
+    // on this — missing bootstrap just means repo_id must be given explicitly.
+    let bootstrap;
+    try {
+        bootstrap = await clients.cloud.bootstrap();
+        getLogger().info({
+            org: bootstrap.organization.id,
+            repos: bootstrap.repos.length,
+            integrations: bootstrap.integrations.filter((i) => i.connected).map((i) => i.type),
+        }, "mcp bootstrap ok");
+    }
+    catch (err) {
+        getLogger().warn({ err: err.message, cloudUrl: config.cloud.baseUrl }, "mcp bootstrap failed — continuing without repo/integration discovery");
+    }
+    const registry = new ToolRegistry();
+    const toolCtx = { server, config, clients, context, cache, sampling, elicit, bootstrap };
+    registerAllTools(toolCtx, registry);
+    registerResources(server, toolCtx);
+    registerPrompts(server);
+    // Factory used by the HTTP transport. `McpServer` is a single-connection
+    // object (throws on the second `connect`), so Streamable HTTP needs a
+    // fresh server + registrations per session. The singleton above is only
+    // for stdio and as the ctx anchor for non-server-bound helpers.
+    function buildSessionServer() {
+        const sessionServer = new McpServer({ name, version }, {
+            capabilities: { tools: {}, resources: {}, prompts: {}, logging: {} },
+            instructions: "TestRelic MCP — intelligent testing context for creation, healing, coverage, and impact. Start with `tr_list_repos` or `tr_coverage_report` to orient; capabilities are gated by the --caps flag to keep the tool schema small.",
+        });
+        const sessionRegistry = new ToolRegistry();
+        const sessionCtx = {
+            server: sessionServer,
+            config,
+            clients,
+            context,
+            cache,
+            sampling: new SamplingBridge(sessionServer),
+            elicit: new Elicitor(sessionServer),
+            bootstrap,
+        };
+        registerAllTools(sessionCtx, sessionRegistry);
+        registerResources(sessionServer, sessionCtx);
+        registerPrompts(sessionServer);
+        return sessionServer;
+    }
+    let stopTransport = null;
+    let stopped = false;
+    async function stop() {
+        if (stopped)
+            return;
+        stopped = true;
+        getLogger().info("shutting down");
+        if (stopTransport) {
+            await stopTransport().catch((err) => getLogger().warn({ err }, "transport close failed"));
+        }
+        await cache.close().catch((err) => getLogger().warn({ err }, "cache close failed"));
+        await metrics.close();
+        try {
+            await server.close();
+        }
+        catch {
+            // best effort
+        }
+    }
+    async function start() {
+        if (stopTransport)
+            return;
+        if (config.server.transport === "http") {
+            stopTransport = await startHttp(buildSessionServer, config);
+        }
+        else {
+            stopTransport = await startStdio(server);
+        }
+        const onSignal = (signal) => {
+            getLogger().info({ signal }, "signal received, stopping");
+            void stop().then(() => process.exit(0));
+        };
+        process.once("SIGINT", onSignal);
+        process.once("SIGTERM", onSignal);
+    }
+    return {
+        server,
+        config,
+        registeredTools: registry.list(),
+        start,
+        stop,
+        __ctx: toolCtx,
+    };
+}
+export { TestRelicMcpError, AuthError, UpstreamError, NotFoundError, RateLimitedError, InvalidInputError, TimeoutError, CircuitOpenError } from "./errors.js";
+export { version, name } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,6 @@
+import pino from "pino";
+import type { LogLevel } from "./config.js";
+export declare function createLogger(level?: LogLevel): pino.Logger;
+export declare function getLogger(): pino.Logger;
+export declare function setLogLevel(level: LogLevel): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C,wBAAgB,YAAY,CAAC,KAAK,GAAE,QAAiB,GAAG,IAAI,CAAC,MAAM,CAelE;AAED,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAKvC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD"}

package/dist/logger.js

@@ -0,0 +1,29 @@
+import pino from "pino";
+/**
+ * Structured logger that writes to STDERR only. MCP stdio transport uses
+ * STDOUT exclusively for JSON-RPC frames — logging to stdout breaks clients.
+ */
+let logger = null;
+export function createLogger(level = "info") {
+    logger = pino({
+        level,
+        base: { svc: "testrelic-mcp" },
+        timestamp: pino.stdTimeFunctions.isoTime,
+        formatters: {
+            level(label) {
+                return { level: label };
+            },
+        },
+    }, pino.destination({ dest: 2, sync: false }));
+    return logger;
+}
+export function getLogger() {
+    if (!logger) {
+        logger = createLogger("info");
+    }
+    return logger;
+}
+export function setLogLevel(level) {
+    getLogger().level = level;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;GAGG;AAEH,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,MAAM,UAAU,YAAY,CAAC,QAAkB,MAAM;IACnD,MAAM,GAAG,IAAI,CACX;QACE,KAAK;QACL,IAAI,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE;QAC9B,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,UAAU,EAAE;YACV,KAAK,CAAC,KAAK;gBACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1B,CAAC;SACF;KACF,EACD,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAC3C,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,SAAS,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;AAC5B,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Ready-made prompts the client UI can surface as slash commands.
+ * Each one guides the agent through a canonical workflow — tools it should
+ * call, in what order, and what to do with the results.
+ */
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE;;;;GAIG;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6FvD"}

package/dist/prompts/index.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+/**
+ * Ready-made prompts the client UI can surface as slash commands.
+ * Each one guides the agent through a canonical workflow — tools it should
+ * call, in what order, and what to do with the results.
+ */
+export function registerPrompts(server) {
+    server.registerPrompt("create_test_from_gap", {
+        title: "Create a test for the highest-impact coverage gap",
+        description: "Finds the top uncovered journey, plans a test, generates code, and runs a dry-run type check. End-to-end flow.",
+        argsSchema: {
+            project_id: z.string().describe("TestRelic project_id"),
+            framework: z.enum(["playwright", "cypress", "jest", "vitest"]).optional(),
+        },
+    }, ({ project_id, framework }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Create a high-impact test for ${project_id}.`,
+                        `1. Call \`tr_coverage_gaps\` with project_id="${project_id}" limit=3.`,
+                        `2. Call \`tr_plan_test\` with the highest-gain journey_id from step 1${framework ? ` and framework="${framework}"` : ""}.`,
+                        `3. Call \`tr_generate_test\` with the plan_cache_key from step 2.`,
+                        `4. Call \`tr_dry_run_test\` with the generated file_path.`,
+                        `5. Summarise: what user-coverage gain the new test brings and any dry-run issues.`,
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("triage_and_heal", {
+        title: "Triage a failing run, correlate impact, propose a heal",
+        description: "Diagnose → correlate user impact → propose a healing patch → optionally file a Jira ticket.",
+        argsSchema: {
+            run_id: z.string(),
+        },
+    }, ({ run_id }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Triage run ${run_id}.`,
+                        `1. Call \`tr_diagnose_run\` with run_id="${run_id}".`,
+                        `2. Call \`tr_user_impact\` with run_id="${run_id}".`,
+                        `3. Call \`tr_ai_rca\` with run_id="${run_id}".`,
+                        `4. Call \`tr_heal_run\` with run_id="${run_id}" — propose a patch.`,
+                        `5. If user impact is high, call \`tr_create_jira\` with dry_run=true and surface the summary for confirmation.`,
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("pr_impact_gate", {
+        title: "Risk-rank tests for a PR diff",
+        description: "Given a diff, rank tests into MUST/SHOULD/OPTIONAL buckets with a user-impact risk score.",
+        argsSchema: {
+            project_id: z.string(),
+            unified_diff: z.string(),
+        },
+    }, ({ project_id, unified_diff }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Gate the following diff for ${project_id}.`,
+                        `1. Call \`tr_analyze_diff\` with the attached unified_diff.`,
+                        `2. Call \`tr_select_tests\` with the same inputs.`,
+                        `3. Summarise: risk level, MUST-run tests, SHOULD-run tests, and which journeys are at risk.`,
+                        "",
+                        "Diff:",
+                        "```diff",
+                        unified_diff,
+                        "```",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AAEH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,sBAAsB,EACtB;QACE,KAAK,EAAE,mDAAmD;QAC1D,WAAW,EACT,gHAAgH;QAClH,UAAU,EAAE;YACV,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACvD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC1E;KACF,EACD,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,iCAAiC,UAAU,GAAG;wBAC9C,iDAAiD,UAAU,YAAY;wBACvE,wEAAwE,SAAS,CAAC,CAAC,CAAC,mBAAmB,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;wBAC3H,mEAAmE;wBACnE,2DAA2D;wBAC3D,mFAAmF;qBACpF,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,KAAK,EAAE,wDAAwD;QAC/D,WAAW,EAAE,6FAA6F;QAC1G,UAAU,EAAE;YACV,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB;KACF,EACD,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,cAAc,MAAM,GAAG;wBACvB,4CAA4C,MAAM,IAAI;wBACtD,2CAA2C,MAAM,IAAI;wBACrD,sCAAsC,MAAM,IAAI;wBAChD,wCAAwC,MAAM,sBAAsB;wBACpE,gHAAgH;qBACjH,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,2FAA2F;QACxG,UAAU,EAAE;YACV,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;SACzB;KACF,EACD,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,+BAA+B,UAAU,GAAG;wBAC5C,6DAA6D;wBAC7D,mDAAmD;wBACnD,6FAA6F;wBAC7F,EAAE;wBACF,OAAO;wBACP,SAAS;wBACT,YAAY;wBACZ,KAAK;qBACN,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,70 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+import type { ResolvedConfig, Capability } from "../config.js";
+import type { ClientBundle } from "../clients/index.js";
+import type { BootstrapResponse } from "../clients/cloud.js";
+import type { ContextEngine } from "../context/index.js";
+import type { CacheManager } from "../cache/index.js";
+import type { SamplingBridge } from "../sampling/bridge.js";
+import type { Elicitor } from "../elicit/ask.js";
+/**
+ * Capability-gated tool registry.
+ *
+ * Every tool declares its capability. `registerTools` filters by the
+ * enabled capability set (with "core" always on) — this is the primary
+ * token-reduction lever. A client with `--caps=creation` sees ~6 tools
+ * instead of the full ~35, meaning the tool-schema prelude sent with
+ * every request shrinks dramatically.
+ */
+export interface ToolContext {
+    server: McpServer;
+    config: ResolvedConfig;
+    clients: ClientBundle;
+    context: ContextEngine;
+    cache: CacheManager;
+    sampling: SamplingBridge;
+    elicit: Elicitor;
+    /**
+     * One-time fetched at startup from `GET /api/v1/mcp/bootstrap`. Populated
+     * best-effort — undefined if the call failed (e.g. no token, offline).
+     * Tools that depend on repo discovery should guard on this.
+     */
+    bootstrap?: BootstrapResponse;
+}
+export interface ToolResponse {
+    /** Human-readable summary (capped by tokenBudgetPerTool). */
+    text: string;
+    /** Machine-readable payload for MCP structured output. Typed loosely so handler authors can return concrete interfaces without indexable casts. */
+    structured?: Record<string, unknown> | object;
+    /** If this result is large, cache_key points to the full blob in L4. */
+    cacheKey?: string;
+}
+export interface ToolDefinition<I extends z.ZodRawShape = z.ZodRawShape, O extends z.ZodRawShape = z.ZodRawShape> {
+    name: string;
+    capability: Capability;
+    title: string;
+    description: string;
+    inputSchema: I;
+    outputSchema?: O;
+    /** Alias names registered at the same time (used to deprecate v1 flat names). */
+    aliases?: Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Whether to treat this as deprecated (just metadata for listing). */
+    deprecated?: boolean;
+    handler: (input: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResponse>;
+}
+export interface RegisteredTool {
+    name: string;
+    capability: Capability;
+    title: string;
+    description: string;
+    deprecated: boolean;
+}
+export declare class ToolRegistry {
+    private readonly registered;
+    register<I extends z.ZodRawShape, O extends z.ZodRawShape>(ctx: ToolContext, def: ToolDefinition<I, O>): void;
+    list(): RegisteredTool[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMjD;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,mJAAmJ;IACnJ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IAC9G,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IAE5C,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,WAAW,EAC9D,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GACxB,IAAI;IAsFA,IAAI,IAAI,cAAc,EAAE;CAGhC"}

package/dist/registry/index.js

@@ -0,0 +1,88 @@
+import { getLogger } from "../logger.js";
+import { countObjectTokens, truncateToTokens } from "../telemetry/tokens.js";
+import { metrics } from "../telemetry/metrics.js";
+import { TestRelicMcpError } from "../errors.js";
+export class ToolRegistry {
+    registered = [];
+    register(ctx, def) {
+        const isEnabled = ctx.config.capabilities.includes(def.capability);
+        if (!isEnabled)
+            return;
+        const wrapped = async (rawInput) => {
+            const start = Date.now();
+            const inputTokens = countObjectTokens(rawInput);
+            let outputTokens = 0;
+            let errCode;
+            try {
+                const result = await def.handler(rawInput, ctx);
+                const budget = ctx.config.tokenBudgetPerTool;
+                const text = result.text.length > 0 ? truncateToTokens(result.text, budget) : "";
+                const structured = (result.structured ?? {});
+                outputTokens = countObjectTokens(text) + countObjectTokens(structured);
+                return {
+                    content: [{ type: "text", text }],
+                    structuredContent: structured,
+                };
+            }
+            catch (err) {
+                if (err instanceof TestRelicMcpError) {
+                    errCode = err.code;
+                    return err.toToolError();
+                }
+                errCode = "INTERNAL";
+                const message = err instanceof Error ? err.message : String(err);
+                getLogger().error({ tool: def.name, err }, "tool handler threw");
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Internal error in ${def.name}: ${message}` }],
+                    structuredContent: { error: { code: "INTERNAL", message } },
+                };
+            }
+            finally {
+                const duration = Date.now() - start;
+                metrics.record({
+                    ts: new Date().toISOString(),
+                    tool: def.name,
+                    capability: def.capability,
+                    input_tokens: inputTokens,
+                    output_tokens: outputTokens,
+                    duration_ms: duration,
+                    cache_hit: false,
+                    error_code: errCode,
+                });
+            }
+        };
+        ctx.server.registerTool(def.name, {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputSchema,
+            outputSchema: def.outputSchema,
+        }, wrapped);
+        this.registered.push({
+            name: def.name,
+            capability: def.capability,
+            title: def.title,
+            description: def.description,
+            deprecated: def.deprecated ?? false,
+        });
+        for (const alias of def.aliases ?? []) {
+            ctx.server.registerTool(alias.name, {
+                title: def.title,
+                description: `[DEPRECATED — use ${def.name}] ${alias.description}`,
+                inputSchema: def.inputSchema,
+                outputSchema: def.outputSchema,
+            }, wrapped);
+            this.registered.push({
+                name: alias.name,
+                capability: def.capability,
+                title: def.title,
+                description: `[DEPRECATED] ${alias.description}`,
+                deprecated: true,
+            });
+        }
+    }
+    list() {
+        return [...this.registered];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2DjD,MAAM,OAAO,YAAY;IACN,UAAU,GAAqB,EAAE,CAAC;IAE5C,QAAQ,CACb,GAAgB,EAChB,GAAyB;QAEzB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,OAAO,GAAG,KAAK,EAAE,QAAiC,EAAE,EAAE;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,OAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;gBACxE,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;gBACvE,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;oBAC1C,iBAAiB,EAAE,UAAU;iBAC9B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,iBAAiB,EAAE,CAAC;oBACrC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;oBACnB,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;gBAC3B,CAAC;gBACD,OAAO,GAAG,UAAU,CAAC;gBACrB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;gBACjE,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,qBAAqB,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,EAAE,CAAC;oBACvF,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;iBAC5D,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC;oBACb,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,YAAY,EAAE,WAAW;oBACzB,aAAa,EAAE,YAAY;oBAC3B,WAAW,EAAE,QAAQ;oBACrB,SAAS,EAAE,KAAK;oBAChB,UAAU,EAAE,OAAO;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,GAAG,CAAC,MAAM,CAAC,YAAY,CACrB,GAAG,CAAC,IAAI,EACR;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,EACD,OAAmE,CACpE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,KAAK;SACpC,CAAC,CAAC;QAEH,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,YAAY,CACrB,KAAK,CAAC,IAAI,EACV;gBACE,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,qBAAqB,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,WAAW,EAAE;gBAClE,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,EACD,OAAmE,CACpE,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,gBAAgB,KAAK,CAAC,WAAW,EAAE;gBAChD,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,IAAI;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/registry/project.d.ts

@@ -0,0 +1,20 @@
+import type { ToolContext } from "./index.js";
+/**
+ * Resolve the project (cloud-platform-app repoId) a tool should operate on.
+ *
+ * Precedence:
+ *   1. Explicit `project_id` argument from the caller — matched against
+ *      bootstrap.repos[].id then .gitId (so users can pass either).
+ *   2. `config.cloud.defaultRepoId` if set.
+ *   3. If there's exactly one repo in bootstrap, use it silently.
+ *   4. Throw InvalidInputError and include the available repo list in the
+ *      structured error so the LLM can re-prompt the user.
+ */
+export declare function resolveProjectId(ctx: ToolContext, argProjectId?: string): string;
+/**
+ * Require that a given integration type is connected in the current org.
+ * Emits a clean, user-facing error pointing at the settings URL so the LLM
+ * can tell the user exactly where to go.
+ */
+export declare function requireIntegration(ctx: ToolContext, type: string): void;
+//# sourceMappingURL=project.d.ts.map

package/dist/registry/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/registry/project.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQvE"}

package/dist/registry/project.js

@@ -0,0 +1,44 @@
+import { InvalidInputError } from "../errors.js";
+/**
+ * Resolve the project (cloud-platform-app repoId) a tool should operate on.
+ *
+ * Precedence:
+ *   1. Explicit `project_id` argument from the caller — matched against
+ *      bootstrap.repos[].id then .gitId (so users can pass either).
+ *   2. `config.cloud.defaultRepoId` if set.
+ *   3. If there's exactly one repo in bootstrap, use it silently.
+ *   4. Throw InvalidInputError and include the available repo list in the
+ *      structured error so the LLM can re-prompt the user.
+ */
+export function resolveProjectId(ctx, argProjectId) {
+    const repos = ctx.bootstrap?.repos ?? [];
+    if (argProjectId) {
+        const match = repos.find((r) => r.id === argProjectId || r.gitId === argProjectId);
+        if (match)
+            return match.id;
+        if (repos.length === 0)
+            return argProjectId; // no bootstrap — trust caller
+        throw new InvalidInputError(`Unknown project_id "${argProjectId}". Available repos: ${repos.map((r) => r.gitId).join(", ")}`, "UNKNOWN_PROJECT");
+    }
+    if (ctx.config.cloud.defaultRepoId)
+        return ctx.config.cloud.defaultRepoId;
+    if (repos.length === 1)
+        return repos[0].id;
+    if (repos.length === 0) {
+        throw new InvalidInputError("No project_id provided and no repos found in bootstrap. Provide project_id or configure default_repo_id.", "PROJECT_REQUIRED");
+    }
+    throw new InvalidInputError(`project_id is required when multiple repos exist. Available: ${repos.map((r) => r.gitId).join(", ")}`, "PROJECT_REQUIRED");
+}
+/**
+ * Require that a given integration type is connected in the current org.
+ * Emits a clean, user-facing error pointing at the settings URL so the LLM
+ * can tell the user exactly where to go.
+ */
+export function requireIntegration(ctx, type) {
+    const integration = ctx.bootstrap?.integrations.find((i) => i.type === type);
+    if (integration?.connected)
+        return;
+    const base = ctx.config.cloud.baseUrl.replace(/\/api\/v1\/?$/, "");
+    throw new InvalidInputError(`Integration "${type}" is not connected. Configure it at ${base}/settings/integrations`, "INTEGRATION_NOT_CONNECTED");
+}
+//# sourceMappingURL=project.js.map

package/dist/registry/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/registry/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,YAAqB;IACtE,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC;IACzC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;QACnF,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,YAAY,CAAC,CAAC,8BAA8B;QAC3E,MAAM,IAAI,iBAAiB,CACzB,uBAAuB,YAAY,uBAAuB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAChG,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC;IAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,iBAAiB,CACzB,0GAA0G,EAC1G,kBAAkB,CACnB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,iBAAiB,CACzB,gEAAgE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtG,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAgB,EAAE,IAAY;IAC/D,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7E,IAAI,WAAW,EAAE,SAAS;QAAE,OAAO;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,iBAAiB,CACzB,gBAAgB,IAAI,uCAAuC,IAAI,wBAAwB,EACvF,2BAA2B,CAC5B,CAAC;AACJ,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "../registry/index.js";
+/**
+ * MCP resources — read-only URIs the client can fetch on demand.
+ *
+ * URI schemes:
+ *   testrelic://repos/{repo_id}/journeys
+ *   testrelic://repos/{repo_id}/coverage-report
+ *   testrelic://repos/{repo_id}/gaps
+ *   testrelic://cache/{key}          (resolves cached blobs)
+ */
+export declare function registerResources(server: McpServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;GAQG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAmF3E"}

package/dist/resources/index.js

@@ -0,0 +1,76 @@
+/**
+ * MCP resources — read-only URIs the client can fetch on demand.
+ *
+ * URI schemes:
+ *   testrelic://repos/{repo_id}/journeys
+ *   testrelic://repos/{repo_id}/coverage-report
+ *   testrelic://repos/{repo_id}/gaps
+ *   testrelic://cache/{key}          (resolves cached blobs)
+ */
+export function registerResources(server, ctx) {
+    server.registerResource("journeys", "testrelic://repos/{repo_id}/journeys", {
+        title: "Top user journeys for a repo",
+        description: "JSON list of top-N user journeys for the given repo, Amplitude-derived.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const match = uri.pathname.match(/^\/repos\/([^/]+)\/journeys$/);
+        if (!match)
+            throw new Error(`Invalid journeys URI: ${uri.href}`);
+        const repo_id = decodeURIComponent(match[1] ?? "");
+        const journeys = await ctx.context.journeys.top(repo_id, 200);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify({ repo_id, journeys }, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("coverage-report", "testrelic://repos/{repo_id}/coverage-report", {
+        title: "Coverage report (95% readout)",
+        description: "User/test coverage, gaps summary, and targets.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const match = uri.pathname.match(/^\/repos\/([^/]+)\/coverage-report$/);
+        if (!match)
+            throw new Error(`Invalid coverage-report URI: ${uri.href}`);
+        const repo_id = decodeURIComponent(match[1] ?? "");
+        const report = await ctx.context.correlator.coverageReport(repo_id);
+        return {
+            contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(report, null, 2) }],
+        };
+    });
+    server.registerResource("coverage-gaps", "testrelic://repos/{repo_id}/gaps", {
+        title: "Ranked coverage gaps",
+        description: "Top-N uncovered journeys ranked by user count.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const match = uri.pathname.match(/^\/repos\/([^/]+)\/gaps$/);
+        if (!match)
+            throw new Error(`Invalid gaps URI: ${uri.href}`);
+        const repo_id = decodeURIComponent(match[1] ?? "");
+        const gaps = await ctx.context.correlator.rankedGaps(repo_id, 50);
+        return { contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ repo_id, gaps }, null, 2) }] };
+    });
+    server.registerResource("cache-blob", "testrelic://cache/{key}", {
+        title: "Cached payload blob",
+        description: "Resolves a cache_key returned by other tools to the full payload.",
+        mimeType: "application/octet-stream",
+    }, async (uri) => {
+        const match = uri.pathname.match(/^\/cache\/([^/]+)$/);
+        if (!match)
+            throw new Error(`Invalid cache URI: ${uri.href}`);
+        const key = decodeURIComponent(match[1] ?? "");
+        const value = ctx.cache.get(key);
+        if (!value)
+            throw new Error(`No cached value for key ${key}`);
+        if (value.value && typeof value.value === "object" && "blob" in value.value && typeof value.value.blob === "string") {
+            const text = ctx.cache.blob.readText(value.value.blob);
+            return { contents: [{ uri: uri.href, mimeType: "application/octet-stream", text: text ?? "" }] };
+        }
+        return { contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(value.value, null, 2) }] };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAgB;IACnE,MAAM,CAAC,gBAAgB,CACrB,UAAU,EACV,sCAAsC,EACtC;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,yEAAyE;QACtF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,iBAAiB,EACjB,6CAA6C,EAC7C;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACpE,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnG,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,eAAe,EACf,kCAAkC,EAClC;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3H,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,YAAY,EACZ,yBAAyB,EACzB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,mEAAmE;QAChF,QAAQ,EAAE,0BAA0B;KACrC,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAA8C,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpH,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACnG,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACrH,CAAC,CACF,CAAC;AACJ,CAAC"}