@wizeworks/lens-node 0.3.0-alpha.2 → 0.3.0-alpha.4

package/dist/mcp-page.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { json, READ_ONLY } from "./mcp-shared.js";
+import { rangeArg } from "./mcp-store.js";
+/** The dashboard pages an agent may read, with what each holds and the parameters it takes. */
+export const MCP_PAGES = {
+    overview: "Headlines, charts, top errors, insights, and services. service: a service name.",
+    services: "Every service with status, traffic, errors, and latency. service: the selected row.",
+    service: "One service: endpoints, dependencies, versions, and errors. service (required): a name.",
+    endpoint: "One endpoint: latency, errors, slowest requests, users affected. service, endpoint (\"GET /api/orders/{id}\"), both required.",
+    requests: "Request list with totals. method, status (5xx, 4xx, 200), duration (slow, >1s), service, endpoint, user, q, sort, page, size.",
+    traces: "Trace list. status (ok, error), duration, service, q, sort (time, duration), page, size.",
+    errors: "Error groups. status (unresolved, resolved, ignored, all), service, type, endpoint, user, critical=1, new=1, q, sort (recent, count), page, size.",
+    error: "One error group: occurrences over time, endpoints, users affected, stack trace. group (required): a group key from errors.",
+    database: "Queries by shape, slowest and most called, N+1 and slow query counts. service, q, table, operation, database, sort, page, size.",
+    query: "One query shape: calls, latency, endpoints. q (required): the shape from database.",
+    insights: "Performance insights (N+1, slow queries, duplicates). area, impact, status, service, endpoint, q, key.",
+    logs: "Log lines with level counts. level, exact=1, service, category, trace, user, q, page, size.",
+    rendering: "Browser page views and components. q.",
+    route: "One browser route. route (required).",
+    "log-patterns": "Log lines grouped into patterns, with counts. level, exact=1, service, pattern, origin.",
+    traffic: "Requests, errors, and latency per time bucket and per endpoint. service, endpoint, buckets (16, 24, 48), from, to (ms).",
+    problems: "Problems: anomalies grouped with a suspected cause. service, sensitivity (high, medium, low), problem, at, focus.",
+    uptime: "Uptime checks: status, response time, incidents. check (one check id).",
+    users: "Signed-in users by requests. q, page, size.",
+    user: "One user: requests, failures, errors they hit, slowest requests. user (required).",
+};
+const PAGE_NAMES = Object.keys(MCP_PAGES);
+function registerGetPage(server, src) {
+    if (!src.defaults.overview)
+        return;
+    const inputSchema = {
+        ...src.arg,
+        page: z.enum(PAGE_NAMES).describe(PAGE_NAMES.map((p) => `${p}: ${MCP_PAGES[p]}`).join(" | ")),
+        params: z.record(z.string(), z.string().max(500)).optional().describe("The page's parameters, as listed with `page`. Values are text."),
+        range: rangeArg("the page covers"),
+    };
+    const description = "Read one dashboard page's numbers, the same the dashboard shows, from the whole store. Pick the page and its parameters; for a list, page through with page and size.";
+    server.registerTool("get_page", { description, inputSchema, annotations: READ_ONLY }, async (args) => {
+        const data = await src.open("get_page", args);
+        try {
+            return json(await data.page(args.page, args.range ?? "24h", args.params ?? {}));
+        }
+        catch (err) {
+            return { ...json({ error: err instanceof Error ? err.message : String(err) }), isError: true };
+        }
+    });
+}
+/** Where a rule sends, without the secret part (webhook URLs, routing keys, addresses). */
+const channelKinds = (cs) => cs.map((c) => c.kind);
+const ruleOf = (r) => {
+    const { channels, ...rest } = r;
+    return { ...rest, channels: channelKinds(channels) };
+};
+const iso = (ms) => (ms === null ? null : new Date(ms).toISOString());
+function reportOf(a) {
+    const names = new Map(a.rules.map((r) => [r.id, r.name]));
+    return {
+        firing: a.rules.filter((r) => r.enabled && r.state === "firing").map((r) => r.name),
+        rules: a.rules.map((r) => ({ ...ruleOf(r), lastEval: iso(r.lastEvalMs), mutedUntil: iso(r.mutedUntilMs) })),
+        events: a.events.map((e) => ({ rule: names.get(e.ruleId) ?? e.ruleId, kind: e.kind, value: e.value, message: e.message, time: iso(e.timeMs) })),
+    };
+}
+function registerGetAlerts(server, src) {
+    if (!src.defaults.alerts)
+        return;
+    const description = "List alert rules (what each watches, its threshold, and whether it is firing) and the newest alert events. Channel secrets are left out.";
+    server.registerTool("get_alerts", { description, inputSchema: { ...src.arg }, annotations: READ_ONLY }, async (args) => {
+        const data = await src.open("get_alerts", args);
+        return json(reportOf(await data.alerts()));
+    });
+}
+/** get_page and get_alerts. */
+export function registerPageTools(server, src) {
+    registerGetPage(server, src);
+    registerGetAlerts(server, src);
+}
+//# sourceMappingURL=mcp-page.js.map

package/dist/mcp-page.js.map

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

package/dist/mcp-problems.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Source } from "./mcp-shared.js";
+/** list_problems: services and endpoints above their normal, grouped into problems with a suspected cause. */
+export declare function registerProblemTools(server: McpServer, src: Source): void;
+//# sourceMappingURL=mcp-problems.d.ts.map

package/dist/mcp-problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-problems.d.ts","sourceRoot":"","sources":["../src/mcp-problems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAwD,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AA4CpG,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAazE"}

package/dist/mcp-problems.js

@@ -0,0 +1,56 @@
+import { causeText } from "@wizeworks/lens-core";
+import { z } from "zod";
+import { json, READ_ONLY } from "./mcp-shared.js";
+const RANGES = ["1h", "6h", "24h", "7d"];
+const iso = (ms) => new Date(ms).toISOString();
+const round = (v) => Math.round(v * 100) / 100;
+const anomalyOf = (a) => ({
+    metric: a.metric,
+    service: a.name,
+    endpoint: a.endpoint,
+    started: iso(a.startMs),
+    ongoing: a.ongoing,
+    value: round(a.peak.value),
+    normal: round(a.peak.normal),
+    alertsAbove: round(a.peak.upper),
+});
+const problemOf = (p) => ({
+    id: p.id,
+    title: p.title,
+    started: iso(p.startMs),
+    ended: p.ongoing ? null : iso(p.endMs),
+    ongoing: p.ongoing,
+    services: p.services.map((s) => `${s.name} (${s.kind})`),
+    suspectedCause: p.cause ? causeText(p.cause) : null,
+    otherCauses: p.causes.slice(1).map(causeText),
+    anomalies: p.anomalies.map(anomalyOf),
+    moreAnomalies: p.anomalyCount - p.anomalies.length,
+});
+function reportOf(m) {
+    const normal = m.baseline.mode === "week" ? "the same hour in earlier weeks" : "the same hour on earlier days";
+    return {
+        window: { from: iso(m.meta.window.from), to: iso(m.meta.window.to) },
+        baseline: m.baseline.learning ? `learning: needs two earlier ${m.baseline.mode}s with data, has ${m.baseline.samples}` : `normal is ${normal} (${m.baseline.samples} with data)`,
+        problems: m.total,
+        ongoing: m.ongoing,
+        list: m.problems.map(problemOf),
+    };
+}
+const problemsOf = async (data, range) => reportOf(await data.page("problems", range));
+/** list_problems: services and endpoints above their normal, grouped into problems with a suspected cause. */
+export function registerProblemTools(server, src) {
+    if (!src.defaults.overview)
+        return;
+    const inputSchema = { ...src.arg, range: z.enum(RANGES).optional().describe("Time range to look for problems in. Default 24h.") };
+    const description = "Problems: error rate, p95 duration, or traffic above normal (the same hour in earlier weeks, plain statistics) on services and endpoints that call each other, grouped by when they started. Each names a suspected cause: a new release, a new error group, a query, or a service further down the calls. Ongoing problems come first. Without `project` on a multi-project host, it covers every project.";
+    server.registerTool("list_problems", { description, inputSchema, annotations: READ_ONLY }, async (args) => {
+        const range = args.range ?? "24h";
+        const named = args.project;
+        if (named || !src.each)
+            return json({ range, ...(await problemsOf(await src.open("list_problems", args), range)) });
+        const all = await src.each("list_problems", args);
+        const projects = await Promise.all(all.map(async ({ project, data }) => ({ project: project.name, projectId: project.id, ...(await problemsOf(data, range)) })));
+        return json({ range, projects: projects.sort((a, b) => b.ongoing - a.ongoing || b.problems - a.problems) });
+    });
+}
+//# sourceMappingURL=mcp-problems.js.map

package/dist/mcp-problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-problems.js","sourceRoot":"","sources":["../src/mcp-problems.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,SAAS,EAAoD,MAAM,sBAAsB,CAAC;AACjH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAuC,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAEpG,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAyC,CAAC;AAEjF,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACvD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAEvD,MAAM,SAAS,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM;IAChB,OAAO,EAAE,CAAC,CAAC,IAAI;IACf,QAAQ,EAAE,CAAC,CAAC,QAAQ;IACpB,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO;IAClB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,EAAE;IACR,KAAK,EAAE,CAAC,CAAC,KAAK;IACd,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO;IAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;IACxD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;IACrC,aAAa,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM;CACnD,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,CAAgB;IAChC,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,+BAA+B,CAAC;IAC/G,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QACpE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,aAAa,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,aAAa;QAChL,QAAQ,EAAE,CAAC,CAAC,KAAK;QACjB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,KAAK,EAAE,IAAmB,EAAE,KAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAElH,8GAA8G;AAC9G,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,GAAW;IACjE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ;QAAE,OAAO;IACnC,MAAM,WAAW,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC,EAAE,CAAC;IAClI,MAAM,WAAW,GACf,6YAA6Y,CAAC;IAChZ,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACxG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QAClC,MAAM,KAAK,GAAI,IAA6B,CAAC,OAAO,CAAC;QACrD,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACpH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAgD,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/M,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp-projects.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type McpDataSource, type McpProject, type McpProjects, type Source } from "./mcp-shared.js";
+/** One data source: every call reads it. */
+export declare function singleSource(data: McpDataSource): Source;
+/** The project a call names by id or name; the only one when it names none. */
+export declare function pickProject(ps: readonly McpProject[], wanted: string | undefined): McpProject;
+/** Several projects: each call names one with the `project` argument. */
+export declare function projectsSource(m: McpProjects): Source;
+/** list_projects: the projects this key reads, for the `project` argument. */
+export declare function registerProjectTools(server: McpServer, m: McpProjects): void;
+//# sourceMappingURL=mcp-projects.d.ts.map

package/dist/mcp-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-projects.d.ts","sourceRoot":"","sources":["../src/mcp-projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAa,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAItH,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAMxD;AAID,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAU7F;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAmBrD;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,CAM5E"}

package/dist/mcp-projects.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { json, READ_ONLY } from "./mcp-shared.js";
+const auditLine = (service, tool, args) => `[wizelens] mcp tool=${tool} service=${service} args=${JSON.stringify(args ?? {})}`;
+/** One data source: every call reads it. */
+export function singleSource(data) {
+    return {
+        defaults: { slowQueryMs: data.slowQueryMs, nPlusOneThreshold: data.nPlusOneThreshold, metrics: !!data.metrics, metricRanges: data.metricRanges, overview: !!data.page, alerts: !!data.alerts },
+        arg: {},
+        open: async (tool, args) => (data.audit(auditLine(data.service, tool, args)), data),
+    };
+}
+const named = (ps) => ps.map((p) => `${p.name} (${p.id})`).join(", ");
+/** The project a call names by id or name; the only one when it names none. */
+export function pickProject(ps, wanted) {
+    if (ps.length === 0)
+        throw new Error("This key reads no projects.");
+    if (!wanted) {
+        if (ps.length === 1)
+            return ps[0];
+        throw new Error(`Add the project argument. This key reads: ${named(ps)}.`);
+    }
+    const w = wanted.trim().toLowerCase();
+    const p = ps.find((x) => x.id === wanted) ?? ps.find((x) => x.name.toLowerCase() === w);
+    if (!p)
+        throw new Error(`No project "${wanted}". This key reads: ${named(ps)}.`);
+    return p;
+}
+/** Several projects: each call names one with the `project` argument. */
+export function projectsSource(m) {
+    const project = z.string().max(200).optional().describe("Project id or name, from list_projects. Needed when the key reads more than one project.");
+    return {
+        defaults: { slowQueryMs: m.slowQueryMs, nPlusOneThreshold: m.nPlusOneThreshold, metrics: m.metrics, metricRanges: m.metricRanges, overview: !!m.overview, alerts: !!m.alerts },
+        arg: { project },
+        open: async (tool, args) => {
+            const data = await m.open(pickProject(m.projects, args.project).id);
+            data.audit(auditLine(data.service, tool, args));
+            return data;
+        },
+        each: (tool, args) => Promise.all(m.projects.map(async (project) => {
+            const data = await m.open(project.id);
+            data.audit(auditLine(data.service, tool, args));
+            return { project, data };
+        })),
+    };
+}
+/** list_projects: the projects this key reads, for the `project` argument. */
+export function registerProjectTools(server, m) {
+    const description = "List the projects this key can read. Pass one's id or name as `project` to the other tools.";
+    server.registerTool("list_projects", { description, inputSchema: {}, annotations: READ_ONLY }, async (args) => {
+        m.audit(auditLine(m.service, "list_projects", args));
+        return json(m.projects.map((p) => ({ id: p.id, name: p.name })));
+    });
+}
+//# sourceMappingURL=mcp-projects.js.map

package/dist/mcp-projects.js.map

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

package/dist/mcp-search.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Source } from "./mcp-shared.js";
+/** search and search_fields: the search language, on the host's store or on `all()` in memory. */
+export declare function registerSearchTools(server: McpServer, src: Source): void;
+//# sourceMappingURL=mcp-search.d.ts.map

package/dist/mcp-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-search.d.ts","sourceRoot":"","sources":["../src/mcp-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAmB,KAAK,MAAM,EAAU,MAAM,iBAAiB,CAAC;AAgDvE,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAGxE"}

package/dist/mcp-search.js

@@ -0,0 +1,53 @@
+import { activeTags, checkSearch, decodeCursor, expandQuery, SEARCH_KINDS, searchMemory, suggestMemory, suggestTags } from "@wizeworks/lens-core";
+import { z } from "zod";
+import { json, READ_ONLY, tagsOf } from "./mcp-shared.js";
+import { pageTags } from "./mcp-tags.js";
+import { RANGES, windowOf } from "./mcp-store.js";
+const LANGUAGE = [
+    "Search language: words and \"phrases\" match text (path, SQL, messages, errors).",
+    "field:value with service, env, trace, span, name, method, path, route, status (500, 5xx, ok, error), duration (250ms, 1s), level, category, kind, user, error (true/false), message.",
+    "@attribute:value for any span or log attribute, such as @user.id:42 or @db.system.name:postgres.",
+    "Use >, >=, <, <= (status:>=500, duration:>1s), ranges a..b, * wildcards (path:/api/*), -term or NOT to exclude, OR, and parentheses.",
+    "tag:name matches a tag rule (list_tags) or a tag the app sets; results come with the tags on each.",
+].join(" ");
+function registerSearch(server, src) {
+    const inputSchema = {
+        ...src.arg,
+        q: z.string().max(2000).describe("The search. Empty finds everything in the range."),
+        kind: z.enum(SEARCH_KINDS).optional().describe("What to find: requests (default), traces, spans, or logs."),
+        range: z.enum(RANGES).optional().describe("How far back: 15m, 1h, 6h, 24h (default), 7d, 30d."),
+        limit: z.number().int().min(1).max(200).optional().describe("Results per page. Default 20."),
+        cursor: z.string().optional().describe("The `next` value of the last page, for the next page."),
+    };
+    const description = `Search requests, traces, spans, and logs, newest first. ${LANGUAGE}`;
+    server.registerTool("search", { description, inputSchema, annotations: READ_ONLY }, async (args) => {
+        const data = await src.open("search", args);
+        const parsed = checkSearch(args.q);
+        if (!parsed.ok)
+            return { ...json({ error: parsed.error, start: parsed.start, end: parsed.end }), isError: true };
+        const raw = { kind: (args.kind ?? "requests"), node: parsed.node, window: windowOf(data, args.range ?? "24h"), limit: args.limit ?? 20, cursor: decodeCursor(args.cursor), env: data.env };
+        const { query, unknownTags } = expandQuery(raw, activeTags(await tagsOf(data)));
+        const page = await (data.search ? data.search(query) : searchMemory(await data.all(), query));
+        return json({ ...page, tags: await pageTags(data, page), unknownTags });
+    });
+}
+function registerFields(server, src) {
+    const inputSchema = {
+        ...src.arg,
+        field: z.string().max(200).optional().describe("Leave out to list fields and attribute keys; or a field (service) or attribute (@user.id) to list its common values."),
+        prefix: z.string().max(200).optional().describe("Only names or values that start with this."),
+        range: z.enum(RANGES).optional().describe("Which data to read. Default 24h."),
+    };
+    const description = "List search fields, attribute keys seen in the data, or the common values of one field, to build a search.";
+    server.registerTool("search_fields", { description, inputSchema, annotations: READ_ONLY }, async (args) => {
+        const data = await src.open("search_fields", args);
+        const r = { field: args.field || null, prefix: args.prefix ?? "", window: windowOf(data, args.range ?? "24h"), limit: 50, env: data.env };
+        return json(suggestTags(r, await tagsOf(data)) ?? (await (data.suggest ? data.suggest(r) : suggestMemory(await data.all(), r))));
+    });
+}
+/** search and search_fields: the search language, on the host's store or on `all()` in memory. */
+export function registerSearchTools(server, src) {
+    registerSearch(server, src);
+    registerFields(server, src);
+}
+//# sourceMappingURL=mcp-search.js.map

package/dist/mcp-search.js.map

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

package/dist/mcp-shared.d.ts

@@ -1,4 +1,20 @@
-import type { MetricsModel, TimeRange, Trace, TraceSummary } from "@wizeworks/lens-core";
+import type { ZodTypeAny } from "zod";
+import { type AlertRule, type MetricsModel, type ModelOf, type PageName, type SearchPage, type SearchQuery, type Suggestion, type SuggestRequest, type TagRule, type TimeRange, type Trace } from "@wizeworks/lens-core";
+/** The page models get_overview, list_problems, get_timeseries, and group_requests read. */
+export type OverviewPage = "overview" | "services" | "errors" | "problems" | "traffic";
+/** One alert event, as get_alerts lists it. */
+export interface McpAlertEvent {
+    ruleId: string;
+    kind: string;
+    value: number | null;
+    message: string;
+    timeMs: number;
+}
+/** The host's alert rules and their newest events. */
+export interface McpAlerts {
+    rules: AlertRule[];
+    events: McpAlertEvent[];
+}
 /** What the MCP tools can read. Read-only by design. */
 export interface McpDataSource {
     service: string;
@@ -7,16 +23,79 @@ export interface McpDataSource {
     slowQueryMs: number;
     /** Default repeats for find_n_plus_one. */
     nPlusOneThreshold: number;
-    list(limit: number): TraceSummary[];
-    all(): Trace[];
+    /** Recent traces, newest first, for the tools that read whole traces in memory. A host may load them only when a tool asks. */
+    all(): Trace[] | Promise<Trace[]>;
+    /** With `search`: the traces the store's search does not have yet (not settled). Default `all()`. */
+    unsettled?(): Trace[] | Promise<Trace[]>;
     get(traceId: string, federate: boolean): Promise<Trace | undefined>;
     audit(line: string): void;
     /** The metrics page for a range and page parameters. Without it, the metric tools are left out. */
     metrics?(range: TimeRange, params: Record<string, string>): MetricsModel | Promise<MetricsModel>;
     /** Ranges the metric tools offer, shortest first. Default all. */
     metricRanges?: readonly TimeRange[];
+    /** Search on the host's store. Without it, the search, list, error, and slow query tools read `all()` in memory. */
+    search?(q: SearchQuery): SearchPage | Promise<SearchPage>;
+    /** Autocomplete on the host's store. Without it, `all()` in memory. */
+    suggest?(r: SuggestRequest): Suggestion[] | Promise<Suggestion[]>;
+    /** The host's clock, for search ranges. Default Date.now. */
+    now?(): number;
+    /** The environment memory search gives this service's documents (in-app), as the HTTP search does. */
+    env?: string;
+    /** One dashboard page's model, from the host's stats, with the page's parameters. Without it, get_overview and get_page are left out. */
+    page?<P extends PageName>(page: P, range: TimeRange, params?: Record<string, string>): Promise<ModelOf<P>>;
+    /** Alert rules and their newest events. Without it, get_alerts is left out. */
+    alerts?(): Promise<McpAlerts>;
+    /** The project's tags (docs/TAGS-PLAN.md). Without it, only the built-ins. */
+    tags?(): readonly TagRule[] | Promise<readonly TagRule[]>;
+}
+/** The tags a tool reads: the host's, or the built-ins. */
+export declare const tagsOf: (data: McpDataSource) => Promise<readonly TagRule[]>;
+/** One project a multi-project host serves. */
+export interface McpProject {
+    id: string;
+    name: string;
+}
+/** A host that serves several projects (the cloud with a read key for many). Tools then take a `project` argument. */
+export interface McpProjects {
+    service: string;
+    version: string;
+    slowQueryMs: number;
+    nPlusOneThreshold: number;
+    /** True when every project has the metric tools. */
+    metrics: boolean;
+    metricRanges?: readonly TimeRange[];
+    /** True when every project has get_overview and get_page. */
+    overview?: boolean;
+    /** True when every project has get_alerts. */
+    alerts?: boolean;
+    projects: readonly McpProject[];
+    /** The data of one project from `projects`. */
+    open(projectId: string): Promise<McpDataSource>;
+    /** Audit for calls that read no project (list_projects). */
+    audit(line: string): void;
+}
+/** Defaults and features the tools are registered with: the same for every project. */
+export interface McpDefaults {
+    slowQueryMs: number;
+    nPlusOneThreshold: number;
+    metrics: boolean;
+    metricRanges?: readonly TimeRange[];
+    overview: boolean;
+    alerts: boolean;
+}
+/** Where the tools read. */
+export interface Source {
+    defaults: McpDefaults;
+    /** The `project` argument, on a multi-project host; else empty. */
+    arg: Record<string, ZodTypeAny>;
+    /** The data for one tool call, after the call is audited. */
+    open(tool: string, args: object): Promise<McpDataSource>;
+    /** Several projects: the data of each, for a call that names none. Each one is audited. */
+    each?(tool: string, args: object): Promise<{
+        project: McpProject;
+        data: McpDataSource;
+    }[]>;
 }
-export type Audit = (tool: string, args: unknown) => void;
 export declare const READ_ONLY: {
     readOnlyHint: boolean;
     openWorldHint: boolean;

package/dist/mcp-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-shared.d.ts","sourceRoot":"","sources":["../src/mcp-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzF,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACpC,GAAG,IAAI,KAAK,EAAE,CAAC;IACf,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mGAAmG;IACnG,OAAO,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjG,kEAAkE;IAClE,YAAY,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D,eAAO,MAAM,SAAS;IAAK,YAAY;IAAQ,aAAa;CAAS,CAAC;AAEtE,eAAO,MAAM,IAAI,UAAW,OAAO;;cACf,MAAM;;;CACxB,CAAC"}
+{"version":3,"file":"mcp-shared.d.ts","sourceRoot":"","sources":["../src/mcp-shared.ts"],"names":[],"mappings":"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"}

package/dist/mcp-shared.js

@@ -1,3 +1,6 @@
+import { tagList } from "@wizeworks/lens-core";
+/** The tags a tool reads: the host's, or the built-ins. */
+export const tagsOf = async (data) => (data.tags ? await data.tags() : tagList([], new Set()));
 export const READ_ONLY = { readOnlyHint: true, openWorldHint: false };
 export const json = (value) => ({
     content: [{ type: "text", text: JSON.stringify(value, null, 2) }],

package/dist/mcp-shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-shared.js","sourceRoot":"","sources":["../src/mcp-shared.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEtE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;CAC3E,CAAC,CAAC"}
+{"version":3,"file":"mcp-shared.js","sourceRoot":"","sources":["../src/mcp-shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAyJ,OAAO,EAA8B,MAAM,sBAAsB,CAAC;AAsDlO,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,IAAmB,EAA+B,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;AAiD3I,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAEtE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;CAC3E,CAAC,CAAC"}

package/dist/mcp-store.d.ts

@@ -0,0 +1,27 @@
+import { type SearchItems, type SearchKind, type SearchNode, type TimeRange } from "@wizeworks/lens-core";
+import { z } from "zod";
+import { type McpDataSource } from "./mcp-shared.js";
+export declare const RANGES: [TimeRange, ...TimeRange[]];
+export declare const rangeArg: (what: string) => z.ZodOptional<z.ZodEnum<{
+    "15m": "15m";
+    "1h": "1h";
+    "24h": "24h";
+    "30d": "30d";
+    "6h": "6h";
+    "7d": "7d";
+}>>;
+export declare const windowOf: (data: McpDataSource, range: TimeRange) => {
+    from: number;
+    to: number;
+};
+/** The matches of a search, newest first, up to `max`: the store, plus the traces it has not indexed yet (they are indexed once they go quiet). `tag:` reads the host's tags. */
+export declare function findAll<K extends SearchKind>(data: McpDataSource, kind: K, node: SearchNode | null, range: TimeRange, max: number): Promise<SearchItems[K][]>;
+/** Every part must hold: tool filters as search text, and the caller's own search. Null parts are left out. */
+export declare function allOf(parts: readonly (string | null | undefined)[]): {
+    ok: true;
+    node: SearchNode | null;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=mcp-store.d.ts.map

package/dist/mcp-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-store.d.ts","sourceRoot":"","sources":["../src/mcp-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAA+C,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1M,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,iBAAiB,CAAC;AAG7D,eAAO,MAAM,MAAM,EAA+B,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AAE9E,eAAO,MAAM,QAAQ,SAAU,MAAM;;;;;;;GAAqG,CAAC;AAI3I,eAAO,MAAM,QAAQ,SAAU,aAAa,SAAS,SAAS;IAEnD,IAAI;IAA+B,EAAE;CAC/C,CAAC;AAwBF,iLAAiL;AACjL,wBAAsB,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAOnK;AAED,+GAA+G;AAC/G,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CASzI"}

package/dist/mcp-store.js

@@ -0,0 +1,56 @@
+import { activeTags, checkSearch, decodeCursor, expandTags, searchMemory, TIME_RANGES } from "@wizeworks/lens-core";
+import { z } from "zod";
+import { tagsOf } from "./mcp-shared.js";
+// Tools that read the whole store through search, not a slice of recent traces (docs/SEARCH-PLAN.md, "MCP").
+export const RANGES = Object.keys(TIME_RANGES);
+export const rangeArg = (what) => z.enum(RANGES).optional().describe(`How far back ${what}: 15m, 1h, 6h, 24h (default), 7d, 30d.`);
+const PAGE = 200;
+export const windowOf = (data, range) => {
+    const now = data.now?.() ?? Date.now();
+    return { from: now - TIME_RANGES[range].ms, to: now };
+};
+const idOf = (item) => {
+    const r = item;
+    return r.key ?? (r.spanId ? `${r.traceId}:${r.spanId}` : r.traceId);
+};
+const timeOf = (item) => {
+    const r = item;
+    return r.startMs ?? r.timeMs ?? 0;
+};
+/** Store pages, newest first, up to `max`. */
+async function storePages(data, base, max) {
+    const out = [];
+    let cursor = null;
+    do {
+        const page = await data.search({ ...base, limit: Math.min(PAGE, max - out.length), cursor: decodeCursor(cursor) });
+        out.push(...page.items);
+        cursor = page.next;
+    } while (cursor && out.length < max);
+    return out;
+}
+/** The matches of a search, newest first, up to `max`: the store, plus the traces it has not indexed yet (they are indexed once they go quiet). `tag:` reads the host's tags. */
+export async function findAll(data, kind, node, range, max) {
+    const base = { kind, node: expandTags(node, activeTags(await tagsOf(data))).node, window: windowOf(data, range), env: data.env };
+    if (!data.search)
+        return searchMemory(await data.all(), { ...base, limit: max }).items;
+    const recent = searchMemory(await (data.unsettled ?? data.all)(), { ...base, limit: max }).items;
+    const seen = new Map();
+    for (const item of [...(await storePages(data, base, max)), ...recent])
+        seen.set(idOf(item), item);
+    return [...seen.values()].sort((a, b) => timeOf(b) - timeOf(a)).slice(0, max);
+}
+/** Every part must hold: tool filters as search text, and the caller's own search. Null parts are left out. */
+export function allOf(parts) {
+    const items = [];
+    for (const part of parts) {
+        if (!part)
+            continue;
+        const r = checkSearch(part);
+        if (!r.ok)
+            return { ok: false, error: `${r.error} (in "${part}")` };
+        if (r.node)
+            items.push(r.node);
+    }
+    return { ok: true, node: items.length === 0 ? null : items.length === 1 ? items[0] : { type: "and", items } };
+}
+//# sourceMappingURL=mcp-store.js.map

package/dist/mcp-store.js.map

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

package/dist/mcp-tags.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SearchPage, type TagMatches } from "@wizeworks/lens-core";
+import { type McpDataSource, type Source } from "./mcp-shared.js";
+/** The tags on each result of a page, keyed by "traceId owner" as `api/tags/match` answers. */
+export declare function pageTags(data: McpDataSource, page: SearchPage): Promise<TagMatches>;
+/** list_tags: the tags `tag:name` reads, with their searches. */
+export declare function registerTagTools(server: McpServer, src: Source): void;
+//# sourceMappingURL=mcp-tags.d.ts.map

package/dist/mcp-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tags.d.ts","sourceRoot":"","sources":["../src/mcp-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAoC,KAAK,UAAU,EAAkC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1I,OAAO,EAAQ,KAAK,aAAa,EAAa,KAAK,MAAM,EAAU,MAAM,iBAAiB,CAAC;AAO3F,+FAA+F;AAC/F,wBAAsB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAMzF;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMrE"}

package/dist/mcp-tags.js

@@ -0,0 +1,22 @@
+import { activeTags, itemOwner, matchTags, searchMemory } from "@wizeworks/lens-core";
+import { json, READ_ONLY, tagsOf } from "./mcp-shared.js";
+// Tags for AI tools (docs/TAGS-PLAN.md): the project's tag rules, and which of them match a page of search results.
+/** Runs one search page on the host's store, or in memory. */
+const runnerOf = (data) => async (q) => (data.search ? data.search(q) : searchMemory(await data.all(), q));
+/** The tags on each result of a page, keyed by "traceId owner" as `api/tags/match` answers. */
+export async function pageTags(data, page) {
+    const items = page.items.map((item) => {
+        const r = item;
+        return { traceId: r.traceId, owner: itemOwner(page.kind, item), timeMs: r.startMs ?? r.timeMs ?? 0 };
+    });
+    return matchTags(runnerOf(data), page.kind, items, activeTags(await tagsOf(data)), data.env);
+}
+/** list_tags: the tags `tag:name` reads, with their searches. */
+export function registerTagTools(server, src) {
+    const description = "List the project's tags: built-in and custom tag rules, each a name for a search. Use tag:name in search, list_traces q, or anything that takes a search.";
+    server.registerTool("list_tags", { description, inputSchema: { ...src.arg }, annotations: READ_ONLY }, async (args) => {
+        const data = await src.open("list_tags", args);
+        return json((await tagsOf(data)).map(({ name, query, builtIn, enabled }) => ({ name, query, builtIn, enabled })));
+    });
+}
+//# sourceMappingURL=mcp-tags.js.map

package/dist/mcp-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tags.js","sourceRoot":"","sources":["../src/mcp-tags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAqC,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAC1I,OAAO,EAAE,IAAI,EAAsB,SAAS,EAAe,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE3F,oHAAoH;AAEpH,8DAA8D;AAC9D,MAAM,QAAQ,GAAG,CAAC,IAAmB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAc,EAAuB,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAE5J,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAmB,EAAE,IAAgB;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,IAA8D,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IACvG,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/F,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAW;IAC7D,MAAM,WAAW,GAAG,2JAA2J,CAAC;IAChL,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp-traces.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { type Audit, type McpDataSource } from "./mcp-shared.js";
+import { type Source } from "./mcp-shared.js";
 /** list_traces, get_trace, and get_errors. */
-export declare function registerTraceTools(server: McpServer, data: McpDataSource, audit: Audit): void;
+export declare function registerTraceTools(server: McpServer, src: Source): void;
 //# sourceMappingURL=mcp-traces.d.ts.map

package/dist/mcp-traces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-traces.d.ts","sourceRoot":"","sources":["../src/mcp-traces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAE,KAAK,KAAK,EAAQ,KAAK,aAAa,EAAa,MAAM,iBAAiB,CAAC;AA8ClF,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAI7F"}
+{"version":3,"file":"mcp-traces.d.ts","sourceRoot":"","sources":["../src/mcp-traces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAuC,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAyDnF,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIvE"}