@testrelic/mcp 2.1.0

package/dist/sampling/bridge.d.ts

@@ -0,0 +1,35 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Sampling bridge: wraps `server.server.createMessage` so tools can ask the
+ * client's LLM to generate text without the server needing its own LLM key.
+ *
+ * Falls back to a deterministic template when the client doesn't support
+ * sampling — preserves the "works offline" guarantee.
+ */
+export interface SamplingOptions {
+    systemPrompt?: string;
+    maxTokens?: number;
+    temperature?: number;
+    modelPreferences?: {
+        hints?: Array<{
+            name: string;
+        }>;
+        intelligencePriority?: number;
+        costPriority?: number;
+        speedPriority?: number;
+    };
+    stopSequences?: string[];
+}
+export interface SamplingResult {
+    text: string;
+    model?: string;
+    stopReason?: string;
+    /** True when we fell back to a local template because sampling failed. */
+    fallback: boolean;
+}
+export declare class SamplingBridge {
+    private readonly server;
+    constructor(server: McpServer);
+    createMessage(prompt: string, opts?: SamplingOptions): Promise<SamplingResult>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/sampling/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/sampling/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAEjC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CA+BhG"}

package/dist/sampling/bridge.js

@@ -0,0 +1,39 @@
+import { getLogger } from "../logger.js";
+export class SamplingBridge {
+    server;
+    constructor(server) {
+        this.server = server;
+    }
+    async createMessage(prompt, opts = {}) {
+        try {
+            const sdkServer = this.server.server;
+            if (!sdkServer?.createMessage)
+                throw new Error("sampling not supported by client");
+            const result = await sdkServer.createMessage({
+                messages: [
+                    {
+                        role: "user",
+                        content: { type: "text", text: prompt },
+                    },
+                ],
+                systemPrompt: opts.systemPrompt,
+                maxTokens: opts.maxTokens ?? 2_000,
+                temperature: opts.temperature ?? 0.3,
+                modelPreferences: opts.modelPreferences,
+                stopSequences: opts.stopSequences,
+            });
+            const text = result.content?.type === "text" ? result.content.text ?? "" : "";
+            return {
+                text,
+                model: result.model,
+                stopReason: result.stopReason,
+                fallback: false,
+            };
+        }
+        catch (err) {
+            getLogger().debug({ err }, "sampling unavailable — using local fallback");
+            return { text: "", fallback: true };
+        }
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/sampling/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/sampling/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA+BzC,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAE3C,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,OAAwB,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,SAAS,GAAI,IAAI,CAAC,MAAiK,CAAC,MAAM,CAAC;YACjM,IAAI,CAAC,SAAS,EAAE,aAAa;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAEnF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC;gBAC3C,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;qBACxC;iBACF;gBACD,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;gBAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG;gBACpC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,6CAA6C,CAAC,CAAC;YAC1E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/telemetry/metrics.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Appends one JSON line per tool invocation to ${outputDir}/metrics.jsonl.
+ *
+ * Line shape:
+ *   { ts, tool, capability, input_tokens, output_tokens, duration_ms,
+ *     cache_hit, cache_layer, error_code? }
+ */
+export interface MetricRecord {
+    ts: string;
+    tool: string;
+    capability: string;
+    input_tokens: number;
+    output_tokens: number;
+    duration_ms: number;
+    cache_hit: boolean;
+    cache_layer?: "L1" | "L2" | "L3" | "L4" | null;
+    error_code?: string;
+}
+declare class MetricsWriter {
+    private stream;
+    private path;
+    init(outputDir: string): void;
+    record(rec: MetricRecord): void;
+    close(): Promise<void>;
+    getPath(): string | null;
+}
+export declare const metrics: MetricsWriter;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAuB;IAE5B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAe7B,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IASzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,IAAI,MAAM,GAAG,IAAI;CAGhC;AAED,eAAO,MAAM,OAAO,eAAsB,CAAC"}

package/dist/telemetry/metrics.js

@@ -0,0 +1,46 @@
+import { mkdirSync, createWriteStream } from "node:fs";
+import { join } from "node:path";
+import { getLogger } from "../logger.js";
+class MetricsWriter {
+    stream = null;
+    path = null;
+    init(outputDir) {
+        if (this.stream)
+            return;
+        try {
+            mkdirSync(outputDir, { recursive: true });
+            this.path = join(outputDir, "metrics.jsonl");
+            this.stream = createWriteStream(this.path, { flags: "a" });
+            this.stream.on("error", (err) => {
+                getLogger().warn({ err }, "metrics.jsonl write error — disabling metrics");
+                this.stream = null;
+            });
+        }
+        catch (err) {
+            getLogger().warn({ err }, "failed to open metrics.jsonl");
+        }
+    }
+    record(rec) {
+        if (!this.stream)
+            return;
+        try {
+            this.stream.write(JSON.stringify(rec) + "\n");
+        }
+        catch {
+            // best-effort — never throw from telemetry
+        }
+    }
+    async close() {
+        if (!this.stream)
+            return;
+        await new Promise((resolve) => {
+            this.stream.end(() => resolve());
+        });
+        this.stream = null;
+    }
+    getPath() {
+        return this.path;
+    }
+}
+export const metrics = new MetricsWriter();
+//# sourceMappingURL=metrics.js.map

package/dist/telemetry/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAsBzC,MAAM,aAAa;IACT,MAAM,GAAuB,IAAI,CAAC;IAClC,IAAI,GAAkB,IAAI,CAAC;IAE5B,IAAI,CAAC,SAAiB;QAC3B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC;YACH,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9B,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,+CAA+C,CAAC,CAAC;gBAC3E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,8BAA8B,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,GAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,MAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/telemetry/tokens.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Token counting using gpt-tokenizer (cl100k_base — OpenAI default encoder).
+ *
+ * This is an approximation for Anthropic / other models, but it's the
+ * canonical open-source tokenizer and the usual Playwright MCP choice.
+ * Accuracy within +/- 10% vs true Anthropic tokenization is acceptable
+ * for budget enforcement purposes.
+ */
+export declare function countTokens(text: string): number;
+export declare function countObjectTokens(obj: unknown): number;
+/**
+ * Truncates text to stay under `maxTokens`, preserving a prefix/suffix with
+ * a visible ellipsis marker.
+ */
+export declare function truncateToTokens(text: string, maxTokens: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/telemetry/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/telemetry/tokens.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQxE"}

package/dist/telemetry/tokens.js

@@ -0,0 +1,40 @@
+import { encode } from "gpt-tokenizer";
+/**
+ * Token counting using gpt-tokenizer (cl100k_base — OpenAI default encoder).
+ *
+ * This is an approximation for Anthropic / other models, but it's the
+ * canonical open-source tokenizer and the usual Playwright MCP choice.
+ * Accuracy within +/- 10% vs true Anthropic tokenization is acceptable
+ * for budget enforcement purposes.
+ */
+export function countTokens(text) {
+    if (!text)
+        return 0;
+    try {
+        return encode(text).length;
+    }
+    catch {
+        // Fallback: rough 4 chars/token heuristic.
+        return Math.ceil(text.length / 4);
+    }
+}
+export function countObjectTokens(obj) {
+    if (obj == null)
+        return 0;
+    return countTokens(typeof obj === "string" ? obj : JSON.stringify(obj));
+}
+/**
+ * Truncates text to stay under `maxTokens`, preserving a prefix/suffix with
+ * a visible ellipsis marker.
+ */
+export function truncateToTokens(text, maxTokens) {
+    const tokens = countTokens(text);
+    if (tokens <= maxTokens)
+        return text;
+    const ratio = maxTokens / tokens;
+    const approxChars = Math.max(64, Math.floor(text.length * ratio * 0.95));
+    const head = text.slice(0, Math.floor(approxChars * 0.7));
+    const tail = text.slice(-Math.floor(approxChars * 0.3));
+    return `${head}\n\n... [truncated ${tokens - maxTokens} tokens — use tr_fetch_cached(cache_key) for full payload] ...\n\n${tail}`;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/telemetry/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/telemetry/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;;;;;GAOG;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,WAAW,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,MAAM,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,GAAG,IAAI,sBAAsB,MAAM,GAAG,SAAS,qEAAqE,IAAI,EAAE,CAAC;AACpI,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ToolContext, ToolDefinition } from "../../registry/index.js";
+/**
+ * Core capability — always on. Short, cheap introspection tools the agent
+ * uses to orient itself before committing to a capability-specific workflow.
+ */
+export declare const coreTools: ToolDefinition[];
+export declare function registerCoreTools(ctx: ToolContext, register: (def: ToolDefinition) => void): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/core/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG3E;;;GAGG;AAEH,eAAO,MAAM,SAAS,EAAE,cAAc,EAsNrC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAEjG"}

package/dist/tools/core/index.js

@@ -0,0 +1,219 @@
+import { z } from "zod";
+import { version } from "../../version.js";
+/**
+ * Core capability — always on. Short, cheap introspection tools the agent
+ * uses to orient itself before committing to a capability-specific workflow.
+ */
+export const coreTools = [
+    {
+        name: "tr_list_repos",
+        capability: "core",
+        title: "List TestRelic repos",
+        description: "Lists repos the authenticated user can see in cloud-platform-app. Sourced from /api/v1/mcp/bootstrap — no upstream fetch per call. Use this first when you don't know which repo_id (== repoId) to target.",
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).optional().default(20),
+        },
+        outputSchema: {
+            repos: z.array(z.object({
+                repo_id: z.string(),
+                repo_name: z.string(),
+                git_id: z.string(),
+            })),
+        },
+        handler: async (input, ctx) => {
+            const limit = input.limit ?? 20;
+            const repos = ctx.bootstrap?.repos ?? [];
+            const results = repos.slice(0, limit).map((r) => ({
+                repo_id: r.id,
+                repo_name: r.displayName,
+                git_id: r.gitId,
+            }));
+            const lines = ["## Repos", ""];
+            for (const p of results)
+                lines.push(`- **${p.repo_id}** — ${p.repo_name} (git: \`${p.git_id}\`)`);
+            if (!results.length) {
+                lines.push("_No repos found. Either bootstrap failed (check your MCP token) or this organization has no repos yet._");
+            }
+            return { text: lines.join("\n"), structured: { repos: results } };
+        },
+    },
+    {
+        name: "tr_describe_repo",
+        capability: "core",
+        title: "Describe a repo",
+        description: "Returns a repo's integrations and capabilities. Sourced from the startup bootstrap — zero additional upstream calls.",
+        inputSchema: {
+            repo_id: z.string().describe("Repo ID (== cloud-platform-app repoId) or git slug"),
+        },
+        handler: async (input, ctx) => {
+            const id = input.repo_id;
+            const repo = ctx.bootstrap?.repos.find((r) => r.id === id || r.gitId === id);
+            if (!repo) {
+                return {
+                    text: `Repo "${id}" not found. Call \`tr_list_repos\` to see available repos.`,
+                    structured: { error: { code: "NOT_FOUND" } },
+                };
+            }
+            const integrations = (ctx.bootstrap?.integrations ?? [])
+                .filter((i) => i.connected)
+                .map((i) => i.type);
+            const text = [
+                `## ${repo.displayName} (${repo.id})`,
+                ``,
+                `- **Git slug:** \`${repo.gitId}\``,
+                `- **Organization integrations:** ${integrations.length ? integrations.join(", ") : "(none connected)"}`,
+                `- **Created:** ${repo.createdAt}`,
+            ].join("\n");
+            return { text, structured: { repo, integrations } };
+        },
+    },
+    {
+        name: "tr_integration_status",
+        capability: "core",
+        title: "Check integration health",
+        description: "Returns a live health check for one integration type in the current org (e.g. 'jira', 'amplitude', 'grafana-loki'). Call this when a tool that depends on an integration fails with INTEGRATION_NOT_CONNECTED — the error message tells you where to configure it in the cloud UI.",
+        inputSchema: {
+            type: z.enum(["jira", "amplitude", "grafana-loki", "github-actions"]),
+        },
+        handler: async (input, ctx) => {
+            const type = input.type;
+            const status = await ctx.clients.cloud.integrationStatus(type).catch((err) => ({
+                connected: false,
+                valid: false,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+            const base = ctx.config.cloud.baseUrl.replace(/\/api\/v1\/?$/, "");
+            const lines = [
+                `## Integration: ${type}`,
+                ``,
+                `- **Connected:** ${status.connected ? "yes" : "no"}`,
+                `- **Credentials valid:** ${status.valid ? "yes" : "no"}`,
+            ];
+            if (!status.connected || !status.valid) {
+                lines.push(`- **Configure at:** ${base}/settings/integrations`);
+                if (status.error)
+                    lines.push(`- **Last error:** ${status.error}`);
+            }
+            return { text: lines.join("\n"), structured: { type, ...status } };
+        },
+    },
+    {
+        name: "tr_recent_runs",
+        capability: "core",
+        title: "List recent test runs",
+        description: "Paginated list of recent runs. Supports filters by project, framework, status. Prefer this as the cheap entry point before diagnosing a specific run.",
+        inputSchema: {
+            project_id: z.string().optional(),
+            framework: z.enum(["playwright", "cypress", "jest", "vitest"]).optional(),
+            status: z.enum(["passed", "failed", "running", "cancelled"]).optional(),
+            cursor: z.string().optional(),
+            limit: z.number().int().min(1).max(20).optional().default(5),
+        },
+        handler: async (input, ctx) => {
+            const result = await ctx.clients.testrelic.listRuns(input);
+            const { data: runs, next_cursor, total } = result;
+            if (!runs.length)
+                return { text: "No test runs found matching your filters.", structured: { runs: [], total: 0 } };
+            const lines = [`## Test Runs (${runs.length} of ${total} total)`, ""];
+            for (const run of runs) {
+                const passRate = run.total > 0 ? ((run.passed / run.total) * 100).toFixed(1) : "0.0";
+                const duration = (run.duration_ms / 1000).toFixed(1);
+                const status = run.status === "passed" ? "✓ passed" : `✗ ${run.status}`;
+                lines.push(`- **${run.run_id}** [${status}]  ${run.failed} failed · ${run.flaky} flaky · ${passRate}% pass  |  ${run.framework}  |  ${run.branch}@${run.commit_sha}  |  ${duration}s  |  ${run.started_at}`);
+            }
+            lines.push("");
+            if (next_cursor)
+                lines.push(`**Next page cursor:** \`${next_cursor}\``);
+            else
+                lines.push("_No more pages._");
+            return { text: lines.join("\n"), structured: { runs, next_cursor, total } };
+        },
+    },
+    {
+        name: "tr_get_config",
+        capability: "core",
+        title: "Resolved server config",
+        description: "Returns the resolved configuration — capabilities, transport, timeouts, cache/output dirs. Safe to call early to learn what tools/resources are available.",
+        inputSchema: {},
+        handler: async (_input, ctx) => {
+            const cloud = {
+                baseUrl: ctx.config.cloud.baseUrl,
+                token: ctx.config.cloud.token ? "***" : undefined,
+                defaultRepoId: ctx.config.cloud.defaultRepoId,
+            };
+            const bootstrapIntegrations = ctx.bootstrap?.integrations.map((i) => ({
+                type: i.type,
+                connected: i.connected,
+                capabilities: i.capabilities,
+            })) ?? [];
+            const payload = {
+                version,
+                capabilities: ctx.config.capabilities,
+                transport: ctx.config.server.transport,
+                timeouts: ctx.config.timeouts,
+                outputDir: ctx.config.outputDir,
+                cacheDir: ctx.config.cacheDir,
+                isolated: ctx.config.isolated,
+                saveSession: ctx.config.saveSession,
+                mockMode: ctx.config.mockMode,
+                cloud,
+                integrations: bootstrapIntegrations,
+                tokenBudgetPerTool: ctx.config.tokenBudgetPerTool,
+            };
+            return {
+                text: ["## TestRelic MCP — resolved config", "", "```json", JSON.stringify(payload, null, 2), "```"].join("\n"),
+                structured: payload,
+            };
+        },
+    },
+    {
+        name: "tr_health",
+        capability: "core",
+        title: "Server health",
+        description: "Reports upstream connectivity, cache state, and whether any circuit breakers are open. Call this before a long workflow to fail fast if something is down.",
+        inputSchema: {},
+        handler: async (_input, ctx) => {
+            const stats = ctx.cache.snapshot();
+            const cloudOpen = ctx.clients._raw.cloud.isCircuitOpen();
+            const integrations = ctx.bootstrap?.integrations.map((i) => ({
+                type: i.type,
+                connected: i.connected,
+            })) ?? [];
+            const ok = !cloudOpen && !!ctx.bootstrap;
+            const text = [
+                `## Health: ${ok ? "OK" : "DEGRADED"}`,
+                "",
+                "### Cloud connection",
+                `- Base URL: ${ctx.config.cloud.baseUrl}`,
+                `- Bootstrap: ${ctx.bootstrap ? "ok" : "FAILED"}`,
+                `- Circuit breaker: ${cloudOpen ? "OPEN" : "closed"}`,
+                "",
+                "### Integrations (from bootstrap)",
+                ...(integrations.length
+                    ? integrations.map((i) => `- ${i.type}: ${i.connected ? "connected" : "disconnected"}`)
+                    : ["_(none configured)_"]),
+                "",
+                "### Cache",
+                `- L1 size: ${stats.lruSize}`,
+                `- L1 hits/misses: ${stats.l1Hits}/${stats.l1Misses}`,
+                `- L2 hits/misses: ${stats.l2Hits}/${stats.l2Misses}`,
+                `- Vector store: ${stats.vectorSize} records`,
+            ].join("\n");
+            return {
+                text,
+                structured: {
+                    ok,
+                    cloud: { baseUrl: ctx.config.cloud.baseUrl, circuitOpen: cloudOpen, bootstrapOk: !!ctx.bootstrap },
+                    integrations,
+                    cache: stats,
+                    version,
+                },
+            };
+        },
+    },
+];
+export function registerCoreTools(ctx, register) {
+    for (const tool of coreTools)
+        register(tool);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/core/index.js.map

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

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

@@ -0,0 +1,9 @@
+import type { ToolContext, ToolDefinition } from "../../registry/index.js";
+/**
+ * Coverage capability — the core intelligence behind the ≥95% User-Coverage
+ * / ≥95% Test-Coverage goal. Every tool is cache-first and uses the 3-state
+ * diff reader for repeat calls on the same project.
+ */
+export declare const coverageTools: ToolDefinition[];
+export declare function registerCoverageTools(ctx: ToolContext, register: (def: ToolDefinition) => void): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/coverage/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;;;GAIG;AAEH,eAAO,MAAM,aAAa,EAAE,cAAc,EAkPzC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAErG"}