@testrelic/mcp 2.1.0

package/dist/context/coverage-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-map.d.ts","sourceRoot":"","sources":["../../src/context/coverage-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;GASG;AAEH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkB;gBAGlB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,YAAY;IAGzB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAStD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAKrF,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK1F,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKnG,UAAU,IAAI,IAAI;CAG1B"}

package/dist/context/coverage-map.js

@@ -0,0 +1,44 @@
+/**
+ * Coverage map — `test_id -> { journey_ids[], code_node_ids[] }`.
+ *
+ * Built from three sources server-side:
+ *   1. Run artefacts (inferred network calls, selectors touched).
+ *   2. Static tags on tests (e.g. `@journey:checkout-guest`).
+ *   3. AST-extracted API calls (best-effort).
+ *
+ * This module just caches the platform's `/test-map` response.
+ */
+export class CoverageMap {
+    clients;
+    cache;
+    ns = "coverage-map";
+    constructor(clients, cache) {
+        this.clients = clients;
+        this.cache = cache;
+    }
+    async load(project_id) {
+        const key = this.cache.key("coverage-map:load", { project_id });
+        const hit = this.cache.get(key);
+        if (hit)
+            return hit.value;
+        const { data } = await this.clients.testrelic.getTestMap(project_id);
+        this.cache.set(key, data, { ttlSeconds: 1_800, namespace: this.ns });
+        return data;
+    }
+    async byTestId(project_id, test_id) {
+        const all = await this.load(project_id);
+        return all.find((e) => e.test_id === test_id);
+    }
+    async testsCoveringJourney(project_id, journey_id) {
+        const all = await this.load(project_id);
+        return all.filter((e) => e.journey_ids.includes(journey_id));
+    }
+    async testsTouchingCodeNode(project_id, code_node_id) {
+        const all = await this.load(project_id);
+        return all.filter((e) => e.code_node_ids.includes(code_node_id));
+    }
+    invalidate() {
+        this.cache.invalidateNamespace(this.ns);
+    }
+}
+//# sourceMappingURL=coverage-map.js.map

package/dist/context/coverage-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-map.js","sourceRoot":"","sources":["../../src/context/coverage-map.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,OAAO,WAAW;IAIH;IACA;IAJF,EAAE,GAAG,cAAc,CAAC;IAErC,YACmB,OAAqB,EACrB,KAAmB;QADnB,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAc;IACnC,CAAC;IAEG,KAAK,CAAC,IAAI,CAAC,UAAkB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,GAAG,CAAC,CAAC;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC;QAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,OAAe;QACvD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAAC,UAAkB,EAAE,UAAkB;QACtE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,UAAkB,EAAE,YAAoB;QACzE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/context/index.d.ts

@@ -0,0 +1,20 @@
+import type { CacheManager } from "../cache/index.js";
+import type { ClientBundle } from "../clients/index.js";
+import { CodeMap } from "./code-map.js";
+import { CoverageMap } from "./coverage-map.js";
+import { Correlator } from "./correlator.js";
+import { JourneyGraph } from "./journey-graph.js";
+import { SignalMap } from "./signal-map.js";
+/**
+ * Bundles all context-engine modules. Instantiated once per server.
+ */
+export interface ContextEngine {
+    journeys: JourneyGraph;
+    coverage: CoverageMap;
+    code: CodeMap;
+    signals: SignalMap;
+    correlator: Correlator;
+}
+export declare function buildContextEngine(clients: ClientBundle, cache: CacheManager): ContextEngine;
+export { JourneyGraph, CoverageMap, CodeMap, SignalMap, Correlator };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,CAU5F;AAED,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,18 @@
+import { CodeMap } from "./code-map.js";
+import { CoverageMap } from "./coverage-map.js";
+import { Correlator } from "./correlator.js";
+import { JourneyGraph } from "./journey-graph.js";
+import { SignalMap } from "./signal-map.js";
+export function buildContextEngine(clients, cache) {
+    const journeys = new JourneyGraph(clients, cache);
+    const coverage = new CoverageMap(clients, cache);
+    return {
+        journeys,
+        coverage,
+        code: new CodeMap(clients, cache),
+        signals: new SignalMap(clients, cache),
+        correlator: new Correlator(journeys, coverage),
+    };
+}
+export { JourneyGraph, CoverageMap, CodeMap, SignalMap, Correlator };
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,KAAmB;IAC3E,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;QACjC,OAAO,EAAE,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;QACtC,UAAU,EAAE,IAAI,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC"}

package/dist/context/journey-graph.d.ts

@@ -0,0 +1,22 @@
+import type { CacheManager } from "../cache/index.js";
+import type { ClientBundle } from "../clients/index.js";
+import type { UserJourney } from "../types/index.js";
+/**
+ * Journey graph — condensed DAG of user flows observed in production.
+ *
+ * v2: fetched from cloud-platform-app's per-repo navigation endpoint
+ * (`GET /api/v1/repos/:repoId/navigation`) which is derived server-side from
+ * session analytics + the org's Amplitude integration. The MCP never calls
+ * Amplitude directly.
+ */
+export declare class JourneyGraph {
+    private readonly clients;
+    private readonly cache;
+    private readonly ns;
+    constructor(clients: ClientBundle, cache: CacheManager);
+    top(project_id: string, limit?: number): Promise<UserJourney[]>;
+    byId(project_id: string, journey_id: string): Promise<UserJourney | undefined>;
+    totalUsers(project_id: string): Promise<number>;
+    invalidate(): void;
+}
+//# sourceMappingURL=journey-graph.d.ts.map

package/dist/context/journey-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-graph.d.ts","sourceRoot":"","sources":["../../src/context/journey-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;GAOG;AAEH,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;gBAGnB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,YAAY;IAGzB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAS3D,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAK9E,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD,UAAU,IAAI,IAAI;CAG1B"}

package/dist/context/journey-graph.js

@@ -0,0 +1,38 @@
+/**
+ * Journey graph — condensed DAG of user flows observed in production.
+ *
+ * v2: fetched from cloud-platform-app's per-repo navigation endpoint
+ * (`GET /api/v1/repos/:repoId/navigation`) which is derived server-side from
+ * session analytics + the org's Amplitude integration. The MCP never calls
+ * Amplitude directly.
+ */
+export class JourneyGraph {
+    clients;
+    cache;
+    ns = "journey-graph";
+    constructor(clients, cache) {
+        this.clients = clients;
+        this.cache = cache;
+    }
+    async top(project_id, limit = 50) {
+        const key = this.cache.key("journey-graph:top", { project_id, limit });
+        const hit = this.cache.get(key);
+        if (hit)
+            return hit.value;
+        const { data } = await this.clients.testrelic.listJourneys(project_id, limit);
+        this.cache.set(key, data, { ttlSeconds: 3_600, namespace: this.ns });
+        return data;
+    }
+    async byId(project_id, journey_id) {
+        const all = await this.top(project_id, 500);
+        return all.find((j) => j.id === journey_id);
+    }
+    async totalUsers(project_id) {
+        const all = await this.top(project_id, 500);
+        return all.reduce((sum, j) => sum + (j.user_count ?? 0), 0);
+    }
+    invalidate() {
+        this.cache.invalidateNamespace(this.ns);
+    }
+}
+//# sourceMappingURL=journey-graph.js.map

package/dist/context/journey-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-graph.js","sourceRoot":"","sources":["../../src/context/journey-graph.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,MAAM,OAAO,YAAY;IAIJ;IACA;IAJF,EAAE,GAAG,eAAe,CAAC;IAEtC,YACmB,OAAqB,EACrB,KAAmB;QADnB,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAc;IACnC,CAAC;IAEG,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,KAAK,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,GAAG,CAAC,CAAC;QAC/C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC;QAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,UAAkB;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,UAAkB;QACxC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/context/signal-map.d.ts

@@ -0,0 +1,26 @@
+import type { CacheManager } from "../cache/index.js";
+import type { ClientBundle } from "../clients/index.js";
+import type { LokiLogLine } from "../types/index.js";
+/**
+ * Signal map — last-24h error buckets by route/service, proxied through the
+ * cloud platform's Loki integration (`GET /api/v1/integrations/loki/logs`).
+ * The MCP never contacts Loki directly; the platform uses the org's stored
+ * Loki credentials to run the query and strips them from the response.
+ */
+export interface SignalBucket {
+    service: string;
+    error_rate_peak: number;
+    peak_time: string;
+    total_errors: number;
+    log_lines: LokiLogLine[];
+    time_range: string;
+}
+export declare class SignalMap {
+    private readonly clients;
+    private readonly cache;
+    private readonly ns;
+    constructor(clients: ClientBundle, cache: CacheManager);
+    forPattern(error_pattern: string, time_range?: string): Promise<SignalBucket>;
+    invalidate(): void;
+}
+//# sourceMappingURL=signal-map.d.ts.map

package/dist/context/signal-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-map.d.ts","sourceRoot":"","sources":["../../src/context/signal-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;gBAGhB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,YAAY;IAGzB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBnF,UAAU,IAAI,IAAI;CAG1B"}

package/dist/context/signal-map.js

@@ -0,0 +1,30 @@
+export class SignalMap {
+    clients;
+    cache;
+    ns = "signal-map";
+    constructor(clients, cache) {
+        this.clients = clients;
+        this.cache = cache;
+    }
+    async forPattern(error_pattern, time_range) {
+        const key = this.cache.key("signal-map:pattern", { error_pattern, time_range: time_range ?? "default" });
+        const hit = this.cache.get(key);
+        if (hit)
+            return hit.value;
+        const data = await this.clients.loki.queryRange(error_pattern, time_range);
+        const bucket = {
+            service: data.log_lines[0]?.service ?? "unknown",
+            error_rate_peak: data.error_rate_peak,
+            peak_time: data.peak_time,
+            total_errors: data.total_errors,
+            log_lines: data.log_lines,
+            time_range: data.time_range,
+        };
+        this.cache.set(key, bucket, { ttlSeconds: 300, namespace: this.ns });
+        return bucket;
+    }
+    invalidate() {
+        this.cache.invalidateNamespace(this.ns);
+    }
+}
+//# sourceMappingURL=signal-map.js.map

package/dist/context/signal-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-map.js","sourceRoot":"","sources":["../../src/context/signal-map.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,SAAS;IAID;IACA;IAJF,EAAE,GAAG,YAAY,CAAC;IAEnC,YACmB,OAAqB,EACrB,KAAmB;QADnB,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAc;IACnC,CAAC;IAEG,KAAK,CAAC,UAAU,CAAC,aAAqB,EAAE,UAAmB;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC;QACzG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,GAAG,CAAC,CAAC;QAC9C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAiB;YAC3B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,SAAS;YAChD,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/elicit/ask.d.ts

@@ -0,0 +1,28 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+/**
+ * Elicitation helper: prompts the client's user for schema-driven input.
+ * Gracefully degrades when a client doesn't implement elicitation — tools
+ * should fall back to using whatever defaults they already have.
+ */
+export interface ElicitOptions {
+    message: string;
+    /** Zod schema describing the fields we want. */
+    schema: z.ZodType;
+}
+export type ElicitResult = {
+    kind: "accepted";
+    content: Record<string, unknown>;
+} | {
+    kind: "declined";
+} | {
+    kind: "cancelled";
+} | {
+    kind: "unsupported";
+};
+export declare class Elicitor {
+    private readonly server;
+    constructor(server: McpServer);
+    ask(opts: ElicitOptions): Promise<ElicitResult>;
+}
+//# sourceMappingURL=ask.d.ts.map

package/dist/elicit/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/elicit/ask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAEjC,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAmB7D"}

package/dist/elicit/ask.js

@@ -0,0 +1,31 @@
+import { zodToJsonSchema } from "./zod-to-json.js";
+import { getLogger } from "../logger.js";
+export class Elicitor {
+    server;
+    constructor(server) {
+        this.server = server;
+    }
+    async ask(opts) {
+        try {
+            const sdkServer = this.server.server;
+            if (!sdkServer?.elicitInput)
+                return { kind: "unsupported" };
+            const result = await sdkServer.elicitInput({
+                message: opts.message,
+                requestedSchema: zodToJsonSchema(opts.schema),
+            });
+            if (result.action === "accept" && result.content)
+                return { kind: "accepted", content: result.content };
+            if (result.action === "decline")
+                return { kind: "declined" };
+            if (result.action === "cancel")
+                return { kind: "cancelled" };
+            return { kind: "unsupported" };
+        }
+        catch (err) {
+            getLogger().debug({ err }, "elicitation unavailable");
+            return { kind: "unsupported" };
+        }
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/elicit/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/elicit/ask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAoBzC,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAE3C,KAAK,CAAC,GAAG,CAAC,IAAmB;QAClC,IAAI,CAAC;YACH,MAAM,SAAS,GAAI,IAAI,CAAC,MAEtB,CAAC,MAAM,CAAC;YACV,IAAI,CAAC,SAAS,EAAE,WAAW;gBAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC;gBACzC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;aAC9C,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACvG,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,yBAAyB,CAAC,CAAC;YACtD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

package/dist/elicit/zod-to-json.d.ts

@@ -0,0 +1,7 @@
+import type { z } from "zod";
+/**
+ * Minimal zod → JSON-Schema converter covering the primitive shapes we use
+ * in elicitation. Falls back to `{type:"object"}` for anything exotic.
+ */
+export declare function zodToJsonSchema(schema: z.ZodType): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json.d.ts.map

package/dist/elicit/zod-to-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.d.ts","sourceRoot":"","sources":["../../src/elicit/zod-to-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8B1E"}

package/dist/elicit/zod-to-json.js

@@ -0,0 +1,37 @@
+/**
+ * Minimal zod → JSON-Schema converter covering the primitive shapes we use
+ * in elicitation. Falls back to `{type:"object"}` for anything exotic.
+ */
+export function zodToJsonSchema(schema) {
+    const def = schema._def;
+    switch (def.typeName) {
+        case "ZodString":
+            return { type: "string" };
+        case "ZodNumber":
+            return { type: "number" };
+        case "ZodBoolean":
+            return { type: "boolean" };
+        case "ZodEnum":
+            return { type: "string", enum: def.values };
+        case "ZodOptional":
+            return zodToJsonSchema(def.innerType);
+        case "ZodDefault":
+            return zodToJsonSchema(def.innerType);
+        case "ZodArray":
+            return { type: "array", items: zodToJsonSchema(def.type) };
+        case "ZodObject": {
+            const shape = def.shape();
+            const properties = {};
+            const required = [];
+            for (const [k, v] of Object.entries(shape)) {
+                properties[k] = zodToJsonSchema(v);
+                if (!v.isOptional?.())
+                    required.push(k);
+            }
+            return { type: "object", properties, required: required.length ? required : undefined };
+        }
+        default:
+            return { type: "object" };
+    }
+}
+//# sourceMappingURL=zod-to-json.js.map

package/dist/elicit/zod-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.js","sourceRoot":"","sources":["../../src/elicit/zod-to-json.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,GAAG,GAAI,MAA0E,CAAC,IAAI,CAAC;IAC7F,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAG,GAAuC,CAAC,MAAM,EAAE,CAAC;QACnF,KAAK,aAAa;YAChB,OAAO,eAAe,CAAE,GAA2C,CAAC,SAAS,CAAC,CAAC;QACjF,KAAK,YAAY;YACf,OAAO,eAAe,CAAE,GAA2C,CAAC,SAAS,CAAC,CAAC;QACjF,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAE,GAAsC,CAAC,IAAI,CAAC,EAAE,CAAC;QACjG,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAI,GAA6D,CAAC,KAAK,EAAE,CAAC;YACrF,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,UAAU,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAE,CAA+C,CAAC,UAAU,EAAE,EAAE;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAC1F,CAAC;QACD;YACE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Error taxonomy. Every error the server throws downstream of a tool handler
+ * should be one of these, so clients get machine-readable `code`.
+ */
+export type ErrorCode = "AUTH_ERROR" | "UPSTREAM_ERROR" | "NOT_FOUND" | "RATE_LIMITED" | "INVALID_INPUT" | "CACHE_MISS" | "CAPABILITY_DISABLED" | "TIMEOUT" | "INTERNAL" | "CIRCUIT_OPEN";
+export declare class TestRelicMcpError extends Error {
+    readonly code: ErrorCode;
+    readonly service?: string;
+    readonly retriable: boolean;
+    readonly cause?: unknown;
+    constructor(opts: {
+        code: ErrorCode;
+        message: string;
+        service?: string;
+        retriable?: boolean;
+        cause?: unknown;
+    });
+    toToolError(): {
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError: true;
+        structuredContent: Record<string, unknown>;
+    };
+}
+export declare class AuthError extends TestRelicMcpError {
+    constructor(message: string, service?: string);
+}
+export declare class UpstreamError extends TestRelicMcpError {
+    constructor(message: string, service?: string, retriable?: boolean);
+}
+export declare class NotFoundError extends TestRelicMcpError {
+    constructor(message: string, service?: string);
+}
+export declare class RateLimitedError extends TestRelicMcpError {
+    constructor(message: string, service?: string);
+}
+export declare class InvalidInputError extends TestRelicMcpError {
+    readonly subcode?: string;
+    constructor(message: string, subcode?: string);
+}
+export declare class CacheMissError extends TestRelicMcpError {
+    constructor(message: string);
+}
+export declare class CapabilityDisabledError extends TestRelicMcpError {
+    constructor(capability: string);
+}
+export declare class TimeoutError extends TestRelicMcpError {
+    constructor(message: string, service?: string);
+}
+export declare class CircuitOpenError extends TestRelicMcpError {
+    constructor(service: string);
+}
+/**
+ * Maps an axios/Error into a TestRelicMcpError. Preserves messages written for AI agents.
+ */
+export declare function wrapUpstreamError(err: unknown, service: string): TestRelicMcpError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,eAAe,GACf,YAAY,GACZ,qBAAqB,GACrB,SAAS,GACT,UAAU,GACV,cAAc,CAAC;AAEnB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAyB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAE7B,IAAI,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;IASM,WAAW,IAAI;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAcpI;AAED,qBAAa,SAAU,SAAQ,iBAAiB;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,aAAc,SAAQ,iBAAiB;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,UAAO;CAGhE;AAED,qBAAa,aAAc,SAAQ,iBAAiB;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBACrB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAI9C;AAED,qBAAa,cAAe,SAAQ,iBAAiB;gBACvC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,UAAU,EAAE,MAAM;CAO/B;AAED,qBAAa,YAAa,SAAQ,iBAAiB;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACzC,OAAO,EAAE,MAAM;CAQ5B;AAcD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAoClF"}

package/dist/errors.js

@@ -0,0 +1,122 @@
+/**
+ * Error taxonomy. Every error the server throws downstream of a tool handler
+ * should be one of these, so clients get machine-readable `code`.
+ */
+export class TestRelicMcpError extends Error {
+    code;
+    service;
+    retriable;
+    cause;
+    constructor(opts) {
+        super(opts.message);
+        this.name = "TestRelicMcpError";
+        this.code = opts.code;
+        this.service = opts.service;
+        this.retriable = opts.retriable ?? false;
+        this.cause = opts.cause;
+    }
+    toToolError() {
+        return {
+            isError: true,
+            content: [{ type: "text", text: this.message }],
+            structuredContent: {
+                error: {
+                    code: this.code,
+                    message: this.message,
+                    service: this.service,
+                    retriable: this.retriable,
+                },
+            },
+        };
+    }
+}
+export class AuthError extends TestRelicMcpError {
+    constructor(message, service) {
+        super({ code: "AUTH_ERROR", message, service, retriable: false });
+    }
+}
+export class UpstreamError extends TestRelicMcpError {
+    constructor(message, service, retriable = true) {
+        super({ code: "UPSTREAM_ERROR", message, service, retriable });
+    }
+}
+export class NotFoundError extends TestRelicMcpError {
+    constructor(message, service) {
+        super({ code: "NOT_FOUND", message, service, retriable: false });
+    }
+}
+export class RateLimitedError extends TestRelicMcpError {
+    constructor(message, service) {
+        super({ code: "RATE_LIMITED", message, service, retriable: true });
+    }
+}
+export class InvalidInputError extends TestRelicMcpError {
+    subcode;
+    constructor(message, subcode) {
+        super({ code: "INVALID_INPUT", message, retriable: false });
+        this.subcode = subcode;
+    }
+}
+export class CacheMissError extends TestRelicMcpError {
+    constructor(message) {
+        super({ code: "CACHE_MISS", message, retriable: false });
+    }
+}
+export class CapabilityDisabledError extends TestRelicMcpError {
+    constructor(capability) {
+        super({
+            code: "CAPABILITY_DISABLED",
+            message: `Capability "${capability}" is disabled. Enable it with --caps=${capability} or add to the "capabilities" array in your config.`,
+            retriable: false,
+        });
+    }
+}
+export class TimeoutError extends TestRelicMcpError {
+    constructor(message, service) {
+        super({ code: "TIMEOUT", message, service, retriable: true });
+    }
+}
+export class CircuitOpenError extends TestRelicMcpError {
+    constructor(service) {
+        super({
+            code: "CIRCUIT_OPEN",
+            message: `Circuit breaker is open for ${service}. Retries suppressed until the service recovers.`,
+            service,
+            retriable: true,
+        });
+    }
+}
+function isAxiosError(err) {
+    return typeof err === "object" && err !== null && err.isAxiosError === true;
+}
+/**
+ * Maps an axios/Error into a TestRelicMcpError. Preserves messages written for AI agents.
+ */
+export function wrapUpstreamError(err, service) {
+    if (err instanceof TestRelicMcpError)
+        return err;
+    if (isAxiosError(err)) {
+        const status = err.response?.status;
+        if (status === 401 || status === 403) {
+            return new AuthError(`${service} returned ${status} Unauthorized. Check credentials in your config or .env. If using mock mode, ensure MOCK_SERVER_URL is set and the mock server is running (npm run mock).`, service);
+        }
+        if (status === 404) {
+            return new NotFoundError(`${service} returned 404 Not Found. The requested resource does not exist.`, service);
+        }
+        if (status === 429) {
+            return new RateLimitedError(`${service} returned 429 Too Many Requests. Wait before retrying.`, service);
+        }
+        if (status && status >= 500) {
+            return new UpstreamError(`${service} returned ${status} Server Error. The service may be temporarily unavailable.`, service, true);
+        }
+        if (err.code === "ECONNREFUSED") {
+            return new UpstreamError(`Cannot connect to ${service} at ${err.config?.url}. If using mock mode, start the mock server first: npm run mock`, service, true);
+        }
+        if (err.code === "ECONNABORTED" || err.code === "ETIMEDOUT") {
+            return new TimeoutError(`${service} request timed out.`, service);
+        }
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return new UpstreamError(`${service} error: ${message}`, service, true);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "./config.js";
+import { type ResolvedConfig } from "./config.js";
+import { type ToolContext } from "./registry/index.js";
+/**
+ * Programmatic API — this is the entry point that the CLI uses and also
+ * what library consumers import via `import { createServer } from "@testrelic/mcp"`.
+ *
+ * @example
+ *   import { createServer } from "@testrelic/mcp";
+ *   const { server, start, stop } = await createServer({ capabilities: ["coverage"] });
+ *   await start();
+ *   // ... later
+ *   await stop();
+ */
+export interface TestRelicServer {
+    /** The underlying MCP server instance — do not mutate. */
+    server: McpServer;
+    /** Resolved config (defaults, env, and caller-provided merged). */
+    config: ResolvedConfig;
+    /** Registered tool list for logging/documentation. */
+    registeredTools: Array<{
+        name: string;
+        capability: string;
+        deprecated: boolean;
+    }>;
+    /** Start the transport (stdio or http based on config). */
+    start(): Promise<void>;
+    /** Gracefully shut down the transport and flush telemetry. */
+    stop(): Promise<void>;
+    /**
+     * INTERNAL — tool context exposed for tests. Not part of the public API.
+     * Do not use in production code; reach for the MCP protocol instead.
+     */
+    __ctx: ToolContext;
+}
+export declare function createServer(inputConfig?: Config): Promise<TestRelicServer>;
+export type { Config, ResolvedConfig } from "./config.js";
+export type { Capability, Transport, LogLevel, ServerConfig, TimeoutConfig, CloudConfig } from "./config.js";
+export type { ToolContext, ToolDefinition, ToolResponse, RegisteredTool } from "./registry/index.js";
+export { TestRelicMcpError, AuthError, UpstreamError, NotFoundError, RateLimitedError, InvalidInputError, TimeoutError, CircuitOpenError } from "./errors.js";
+export { version, name } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAA6C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7F,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQrE;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,EAAE,SAAS,CAAC;IAClB,mEAAmE;IACnE,MAAM,EAAE,cAAc,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClF,2DAA2D;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,8DAA8D;IAC9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;OAGG;IACH,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,WAAW,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA+HrF;AAGD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9J,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}