@tellagen/mcp-server 0.1.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/README.md +231 -12
  2. package/SKILL.md +407 -13
  3. package/contracts/runbooks/manifest.json +47 -0
  4. package/contracts/runbooks/v1/fixtures/global-runbook.json +7 -0
  5. package/contracts/runbooks/v1/runbook-definition.schema.json +25 -0
  6. package/contracts/runbooks/v2/compiled-plan.schema.json +40 -0
  7. package/contracts/runbooks/v2/fixtures/filesystem-pressure.json +181 -0
  8. package/contracts/runbooks/v2/fixtures/grafana-error-rate-plan.json +50 -0
  9. package/contracts/runbooks/v2/fixtures/grafana-error-rate.json +58 -0
  10. package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +90 -0
  11. package/contracts/runbooks/v2/fixtures/timeline-event-with-blocks.json +61 -0
  12. package/contracts/runbooks/v2/runbook-definition.schema.json +377 -0
  13. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +480 -0
  14. package/contracts/tellagen-runbook-contracts.json +8 -0
  15. package/dist/auth.d.ts +2 -1
  16. package/dist/auth.js +2 -1
  17. package/dist/auth.js.map +1 -1
  18. package/dist/client.d.ts +20 -0
  19. package/dist/client.js +81 -12
  20. package/dist/client.js.map +1 -1
  21. package/dist/diagnosis-structure.d.ts +1416 -0
  22. package/dist/diagnosis-structure.js +656 -0
  23. package/dist/diagnosis-structure.js.map +1 -0
  24. package/dist/errors.d.ts +2 -1
  25. package/dist/errors.js +4 -1
  26. package/dist/errors.js.map +1 -1
  27. package/dist/figures.d.ts +2336 -0
  28. package/dist/figures.js +1288 -0
  29. package/dist/figures.js.map +1 -0
  30. package/dist/image-info.d.ts +14 -0
  31. package/dist/image-info.js +65 -0
  32. package/dist/image-info.js.map +1 -0
  33. package/dist/index.js +2 -6
  34. package/dist/index.js.map +1 -1
  35. package/dist/server.js +63 -6
  36. package/dist/server.js.map +1 -1
  37. package/dist/source-links.d.ts +101 -0
  38. package/dist/source-links.js +374 -0
  39. package/dist/source-links.js.map +1 -0
  40. package/dist/start.d.ts +11 -0
  41. package/dist/start.js +14 -0
  42. package/dist/start.js.map +1 -0
  43. package/dist/tools/attachments.d.ts +19 -0
  44. package/dist/tools/attachments.js +177 -0
  45. package/dist/tools/attachments.js.map +1 -0
  46. package/dist/tools/causes.d.ts +50 -0
  47. package/dist/tools/causes.js +97 -0
  48. package/dist/tools/causes.js.map +1 -0
  49. package/dist/tools/context.d.ts +3 -0
  50. package/dist/tools/context.js +146 -0
  51. package/dist/tools/context.js.map +1 -0
  52. package/dist/tools/datasources.d.ts +3 -0
  53. package/dist/tools/datasources.js +325 -0
  54. package/dist/tools/datasources.js.map +1 -0
  55. package/dist/tools/diagnostics.d.ts +3 -0
  56. package/dist/tools/diagnostics.js +113 -0
  57. package/dist/tools/diagnostics.js.map +1 -0
  58. package/dist/tools/figures.d.ts +8 -0
  59. package/dist/tools/figures.js +209 -0
  60. package/dist/tools/figures.js.map +1 -0
  61. package/dist/tools/findings.js +84 -6
  62. package/dist/tools/findings.js.map +1 -1
  63. package/dist/tools/incidents.js +112 -3
  64. package/dist/tools/incidents.js.map +1 -1
  65. package/dist/tools/index.js +18 -0
  66. package/dist/tools/index.js.map +1 -1
  67. package/dist/tools/investigations.js +834 -12
  68. package/dist/tools/investigations.js.map +1 -1
  69. package/dist/tools/postmortem-runbooks.d.ts +786 -0
  70. package/dist/tools/postmortem-runbooks.js +330 -0
  71. package/dist/tools/postmortem-runbooks.js.map +1 -0
  72. package/dist/tools/source-links.d.ts +47 -0
  73. package/dist/tools/source-links.js +302 -0
  74. package/dist/tools/source-links.js.map +1 -0
  75. package/dist/tools/timeline.d.ts +3 -0
  76. package/dist/tools/timeline.js +333 -0
  77. package/dist/tools/timeline.js.map +1 -0
  78. package/dist/version.d.ts +2 -0
  79. package/dist/version.js +12 -0
  80. package/dist/version.js.map +1 -0
  81. package/package.json +4 -3
  82. package/server.json +15 -1
@@ -0,0 +1,50 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { z } from "zod";
3
+ import { TellagenClient } from "../client.js";
4
+ /** The causes endpoint limits. */
5
+ export declare const CAUSE_STATES: readonly ["leading", "open", "ruled_out"];
6
+ export declare const updateCauseInputShape: {
7
+ investigation_run_id: z.ZodString;
8
+ cause_key: z.ZodString;
9
+ label: z.ZodOptional<z.ZodString>;
10
+ state: z.ZodOptional<z.ZodEnum<["leading", "open", "ruled_out"]>>;
11
+ rationale: z.ZodOptional<z.ZodString>;
12
+ evidence_for: z.ZodOptional<z.ZodNumber>;
13
+ evidence_against: z.ZodOptional<z.ZodNumber>;
14
+ finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
15
+ sources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16
+ };
17
+ declare const updateCauseSchema: z.ZodObject<{
18
+ investigation_run_id: z.ZodString;
19
+ cause_key: z.ZodString;
20
+ label: z.ZodOptional<z.ZodString>;
21
+ state: z.ZodOptional<z.ZodEnum<["leading", "open", "ruled_out"]>>;
22
+ rationale: z.ZodOptional<z.ZodString>;
23
+ evidence_for: z.ZodOptional<z.ZodNumber>;
24
+ evidence_against: z.ZodOptional<z.ZodNumber>;
25
+ finding_ids: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
26
+ sources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
27
+ }, "strict", z.ZodTypeAny, {
28
+ cause_key: string;
29
+ investigation_run_id: string;
30
+ label?: string | undefined;
31
+ state?: "open" | "ruled_out" | "leading" | undefined;
32
+ finding_ids?: number[] | undefined;
33
+ rationale?: string | undefined;
34
+ evidence_for?: number | undefined;
35
+ evidence_against?: number | undefined;
36
+ sources?: string[] | undefined;
37
+ }, {
38
+ cause_key: string;
39
+ investigation_run_id: string;
40
+ label?: string | undefined;
41
+ state?: "open" | "ruled_out" | "leading" | undefined;
42
+ finding_ids?: number[] | undefined;
43
+ rationale?: string | undefined;
44
+ evidence_for?: number | undefined;
45
+ evidence_against?: number | undefined;
46
+ sources?: string[] | undefined;
47
+ }>;
48
+ export type UpdateCauseInput = z.infer<typeof updateCauseSchema>;
49
+ export declare function registerCauseTools(server: McpServer, client: TellagenClient): void;
50
+ export {};
@@ -0,0 +1,97 @@
1
+ import { z } from "zod";
2
+ import { formatError } from "../errors.js";
3
+ import { DIAGNOSIS_STRUCTURE_CAPABILITY, supportsDiagnosisStructure, } from "../diagnosis-structure.js";
4
+ /** The causes endpoint limits. */
5
+ export const CAUSE_STATES = ["leading", "open", "ruled_out"];
6
+ export const updateCauseInputShape = {
7
+ investigation_run_id: z
8
+ .string()
9
+ .min(1)
10
+ .describe("Active investigation run ID"),
11
+ cause_key: z
12
+ .string()
13
+ .min(1)
14
+ .max(64)
15
+ .regex(/^\S+$/, "no spaces")
16
+ .describe("Short stable key for this cause, up to 64 characters, no spaces (for example deploy-4412). Use the same value as cause_key on tellagen_post_trace_step."),
17
+ label: z
18
+ .string()
19
+ .trim()
20
+ .min(1)
21
+ .max(160)
22
+ .optional()
23
+ .describe("Name of the cause, up to 160 characters. Required the first time you post a key."),
24
+ state: z
25
+ .enum(CAUSE_STATES)
26
+ .optional()
27
+ .describe("leading (best supported so far), open (still being tested) or ruled_out. Keep one leading cause."),
28
+ rationale: z
29
+ .string()
30
+ .max(1000)
31
+ .optional()
32
+ .describe("Why it is in this state, up to 1000 characters. Say what excluded it when ruled_out."),
33
+ evidence_for: z
34
+ .number()
35
+ .int()
36
+ .min(0)
37
+ .max(999)
38
+ .optional()
39
+ .describe("Count of checks that support this cause"),
40
+ evidence_against: z
41
+ .number()
42
+ .int()
43
+ .min(0)
44
+ .max(999)
45
+ .optional()
46
+ .describe("Count of checks that contradict this cause"),
47
+ finding_ids: z
48
+ .array(z.number().int().positive())
49
+ .max(20)
50
+ .optional()
51
+ .describe("Numeric ids returned by tellagen_post_finding for this run, up to 20. [] clears the list."),
52
+ sources: z
53
+ .array(z.string().trim().min(1).max(60))
54
+ .max(8)
55
+ .optional()
56
+ .describe("Names of the sources consulted for this cause, up to 8 of 60 characters. [] clears the list."),
57
+ };
58
+ const updateCauseSchema = z.object(updateCauseInputShape).strict();
59
+ export function registerCauseTools(server, client) {
60
+ server.registerTool("tellagen_update_cause", {
61
+ description: "Post or update one cause you are testing, so the Diagnosis tab shows it while the run is live. Call it when a cause starts (state open), when its state changes (leading, open, ruled_out) and when you rule it out (with a rationale and finding_ids). Do not call it for every check; link checks to a cause with cause_key on tellagen_post_trace_step. At most 8 causes per run. A field you leave out keeps its value, and label is required the first time. Causes are reconciled to the final result_summary when you complete the run. Needs diagnosis_structure_v1; otherwise nothing is sent and the result explains why.",
62
+ inputSchema: updateCauseInputShape,
63
+ }, async (input) => {
64
+ try {
65
+ const { investigation_run_id, cause_key, ...fields } = input;
66
+ if (!(await supportsDiagnosisStructure(client, investigation_run_id))) {
67
+ return {
68
+ content: [
69
+ {
70
+ type: "text",
71
+ text: JSON.stringify({
72
+ sent: false,
73
+ mcp_notice: `This Tellagen backend does not advertise ${DIAGNOSIS_STRUCTURE_CAPABILITY} for this run, so it does not support live causes and nothing was sent. Update Tellagen to post causes under test; keep investigating and put the cause chain in the completion result_summary.`,
74
+ }),
75
+ },
76
+ ],
77
+ };
78
+ }
79
+ const body = {};
80
+ for (const [key, value] of Object.entries(fields)) {
81
+ if (value !== undefined)
82
+ body[key] = value;
83
+ }
84
+ const data = await client.put(`/api/v1/investigation-runs/${encodeURIComponent(investigation_run_id)}/causes/${encodeURIComponent(cause_key)}`, body);
85
+ return {
86
+ content: [{ type: "text", text: JSON.stringify(data) }],
87
+ };
88
+ }
89
+ catch (err) {
90
+ return {
91
+ content: [{ type: "text", text: formatError(err) }],
92
+ isError: true,
93
+ };
94
+ }
95
+ });
96
+ }
97
+ //# sourceMappingURL=causes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"causes.js","sourceRoot":"","sources":["../../src/tools/causes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { TellagenClient } from "../client.js";
3
+ export declare function registerContextTools(server: McpServer, client: TellagenClient): void;
@@ -0,0 +1,146 @@
1
+ import { z } from "zod";
2
+ import { formatError } from "../errors.js";
3
+ function withQuery(path, params) {
4
+ const query = params.toString();
5
+ return query ? `${path}?${query}` : path;
6
+ }
7
+ export function registerContextTools(server, client) {
8
+ server.registerTool("tellagen_get_impact_summary", {
9
+ description: "Get Tellagen's customer-impact summary for an incident.",
10
+ inputSchema: {
11
+ incident_id: z.number().int().positive().describe("Incident ID"),
12
+ },
13
+ }, async ({ incident_id }) => {
14
+ try {
15
+ const data = await client.get(`/api/v1/incidents/${incident_id}/impact-summary`);
16
+ return {
17
+ content: [{ type: "text", text: JSON.stringify(data) }],
18
+ };
19
+ }
20
+ catch (err) {
21
+ return {
22
+ content: [{ type: "text", text: formatError(err) }],
23
+ isError: true,
24
+ };
25
+ }
26
+ });
27
+ server.registerTool("tellagen_list_affected_customers", {
28
+ description: "List affected customers for an incident, with optional status/email filters and pagination.",
29
+ inputSchema: {
30
+ incident_id: z.number().int().positive().describe("Incident ID"),
31
+ status: z.string().optional(),
32
+ email: z.string().email().optional(),
33
+ limit: z.number().int().min(1).max(50).optional(),
34
+ cursor: z.string().optional(),
35
+ },
36
+ }, async ({ incident_id, status, email, limit, cursor }) => {
37
+ try {
38
+ const params = new URLSearchParams();
39
+ if (status !== undefined)
40
+ params.set("status", status);
41
+ if (email !== undefined)
42
+ params.set("email", email);
43
+ if (limit !== undefined)
44
+ params.set("limit", String(limit));
45
+ if (cursor !== undefined)
46
+ params.set("cursor", cursor);
47
+ const data = await client.get(withQuery(`/api/v1/incidents/${incident_id}/affected-customers`, params));
48
+ return {
49
+ content: [{ type: "text", text: JSON.stringify(data) }],
50
+ };
51
+ }
52
+ catch (err) {
53
+ return {
54
+ content: [{ type: "text", text: formatError(err) }],
55
+ isError: true,
56
+ };
57
+ }
58
+ });
59
+ server.registerTool("tellagen_search", {
60
+ description: "Search Tellagen incidents, timeline events, issues, services, and related workspace records.",
61
+ inputSchema: {
62
+ q: z.string().min(2).optional().describe("Search query"),
63
+ filters: z.string().optional().describe("Advanced filter string"),
64
+ types: z.array(z.string()).optional(),
65
+ incident_id: z.number().int().positive().optional(),
66
+ limit: z.number().int().min(1).max(100).optional(),
67
+ offset: z.number().int().min(0).optional(),
68
+ date_from: z.string().datetime().optional(),
69
+ date_to: z.string().datetime().optional(),
70
+ },
71
+ }, async ({ q, filters, types, incident_id, limit, offset, date_from, date_to, }) => {
72
+ try {
73
+ const params = new URLSearchParams();
74
+ if (q !== undefined)
75
+ params.set("q", q);
76
+ if (filters !== undefined)
77
+ params.set("filters", filters);
78
+ if (types !== undefined && types.length > 0) {
79
+ params.set("types", types.join(","));
80
+ }
81
+ if (incident_id !== undefined) {
82
+ params.set("incident_id", String(incident_id));
83
+ }
84
+ if (limit !== undefined)
85
+ params.set("limit", String(limit));
86
+ if (offset !== undefined)
87
+ params.set("offset", String(offset));
88
+ if (date_from !== undefined)
89
+ params.set("date_from", date_from);
90
+ if (date_to !== undefined)
91
+ params.set("date_to", date_to);
92
+ const data = await client.get(withQuery("/api/v1/search", params));
93
+ return {
94
+ content: [{ type: "text", text: JSON.stringify(data) }],
95
+ };
96
+ }
97
+ catch (err) {
98
+ return {
99
+ content: [{ type: "text", text: formatError(err) }],
100
+ isError: true,
101
+ };
102
+ }
103
+ });
104
+ server.registerTool("tellagen_list_services", {
105
+ description: "List services in the Tellagen service catalog.",
106
+ inputSchema: {
107
+ include_archived: z.boolean().optional(),
108
+ },
109
+ }, async ({ include_archived }) => {
110
+ try {
111
+ const params = new URLSearchParams();
112
+ if (include_archived)
113
+ params.set("include_archived", "true");
114
+ const data = await client.get(withQuery("/api/v1/services", params));
115
+ return {
116
+ content: [{ type: "text", text: JSON.stringify(data) }],
117
+ };
118
+ }
119
+ catch (err) {
120
+ return {
121
+ content: [{ type: "text", text: formatError(err) }],
122
+ isError: true,
123
+ };
124
+ }
125
+ });
126
+ server.registerTool("tellagen_get_service", {
127
+ description: "Get one Tellagen service catalog entry by ID.",
128
+ inputSchema: {
129
+ service_id: z.number().int().positive().describe("Service ID"),
130
+ },
131
+ }, async ({ service_id }) => {
132
+ try {
133
+ const data = await client.get(`/api/v1/services/${service_id}`);
134
+ return {
135
+ content: [{ type: "text", text: JSON.stringify(data) }],
136
+ };
137
+ }
138
+ catch (err) {
139
+ return {
140
+ content: [{ type: "text", text: formatError(err) }],
141
+ isError: true,
142
+ };
143
+ }
144
+ });
145
+ }
146
+ //# sourceMappingURL=context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { TellagenClient } from "../client.js";
3
+ export declare function registerDatasourceTools(server: McpServer, client: TellagenClient): void;
@@ -0,0 +1,325 @@
1
+ import { z } from "zod";
2
+ import { formatError } from "../errors.js";
3
+ const DEFAULT_GRAFANA_ENV_VARS = [
4
+ "GRAFANA_URL",
5
+ "GRAFANA_SERVICE_ACCOUNT_TOKEN",
6
+ ];
7
+ export function registerDatasourceTools(server, client) {
8
+ server.registerTool("tellagen_probe_datasource", {
9
+ description: "Run a local read-only diagnostic for a Tellagen datasource. For Grafana, checks required local environment variables and calls Grafana /api/health without returning credentials.",
10
+ inputSchema: {
11
+ datasource_id: z
12
+ .number()
13
+ .int()
14
+ .positive()
15
+ .optional()
16
+ .describe("Datasource ID from Tellagen"),
17
+ name: z.string().min(1).optional().describe("Datasource name"),
18
+ timeout_ms: z
19
+ .number()
20
+ .int()
21
+ .min(500)
22
+ .max(10000)
23
+ .optional()
24
+ .describe("Grafana health probe timeout in milliseconds"),
25
+ },
26
+ }, async ({ datasource_id, name, timeout_ms }) => {
27
+ try {
28
+ const data = await client.get("/api/v1/datasources");
29
+ const datasources = Array.isArray(data.datasources)
30
+ ? data.datasources
31
+ : [];
32
+ const selected = selectDatasource(datasources, datasource_id, name);
33
+ if (!selected.datasource) {
34
+ return {
35
+ content: [
36
+ {
37
+ type: "text",
38
+ text: JSON.stringify(selected.result),
39
+ },
40
+ ],
41
+ };
42
+ }
43
+ const result = await probeDatasource(selected.datasource, timeout_ms ?? 3000);
44
+ return {
45
+ content: [{ type: "text", text: JSON.stringify(result) }],
46
+ };
47
+ }
48
+ catch (err) {
49
+ return {
50
+ content: [{ type: "text", text: formatError(err) }],
51
+ isError: true,
52
+ };
53
+ }
54
+ });
55
+ }
56
+ function selectDatasource(datasources, datasourceID, name) {
57
+ const checks = [];
58
+ const safeDatasources = datasources.map(safeDatasource);
59
+ if (datasourceID !== undefined) {
60
+ const datasource = datasources.find((candidate) => candidate.id === datasourceID);
61
+ if (datasource)
62
+ return { datasource };
63
+ return {
64
+ result: {
65
+ ok: false,
66
+ checks: [
67
+ {
68
+ name: "metadata_lookup",
69
+ status: "error",
70
+ message: `No datasource found with ID ${datasourceID}.`,
71
+ },
72
+ ],
73
+ missing_env_vars: [],
74
+ available_datasources: safeDatasources,
75
+ recommended_action: "Run tellagen_probe_datasource with a datasource_id or name from available_datasources.",
76
+ },
77
+ };
78
+ }
79
+ const trimmedName = name?.trim();
80
+ if (trimmedName) {
81
+ const datasource = datasources.find((candidate) => candidate.name === trimmedName);
82
+ if (datasource)
83
+ return { datasource };
84
+ return {
85
+ result: {
86
+ ok: false,
87
+ checks: [
88
+ {
89
+ name: "metadata_lookup",
90
+ status: "error",
91
+ message: `No datasource found named ${trimmedName}.`,
92
+ },
93
+ ],
94
+ missing_env_vars: [],
95
+ available_datasources: safeDatasources,
96
+ recommended_action: "Run tellagen_probe_datasource with a datasource_id or name from available_datasources.",
97
+ },
98
+ };
99
+ }
100
+ const enabledDatasources = datasources.filter((datasource) => datasource.enabled !== false);
101
+ const grafanaDatasources = enabledDatasources.filter((datasource) => datasource.type?.toLowerCase() === "grafana");
102
+ if (grafanaDatasources.length === 1)
103
+ return { datasource: grafanaDatasources[0] };
104
+ if (enabledDatasources.length === 1)
105
+ return { datasource: enabledDatasources[0] };
106
+ checks.push({
107
+ name: "metadata_selection",
108
+ status: "error",
109
+ message: "Multiple datasources are available. Provide datasource_id or name to choose one.",
110
+ });
111
+ return {
112
+ result: {
113
+ ok: false,
114
+ checks,
115
+ missing_env_vars: [],
116
+ available_datasources: safeDatasources,
117
+ recommended_action: "Run tellagen_probe_datasource again with datasource_id or name.",
118
+ },
119
+ };
120
+ }
121
+ async function probeDatasource(datasource, timeoutMs) {
122
+ const safe = safeDatasource(datasource);
123
+ const checks = [
124
+ {
125
+ name: "metadata_lookup",
126
+ status: "ok",
127
+ message: "Datasource metadata was found in Tellagen.",
128
+ },
129
+ ];
130
+ const missingEnvVars = safe.required_env_vars.filter((envVar) => process.env[envVar]?.trim() === undefined || process.env[envVar]?.trim() === "");
131
+ if (missingEnvVars.length > 0) {
132
+ checks.push({
133
+ name: "required_env",
134
+ status: "error",
135
+ message: `Missing local environment variables: ${missingEnvVars.join(", ")}.`,
136
+ });
137
+ return {
138
+ ok: false,
139
+ datasource: safe,
140
+ checks,
141
+ missing_env_vars: missingEnvVars,
142
+ recommended_action: "Add the missing variables to your MCP client env or shell before starting tellagen-mcp-server.",
143
+ };
144
+ }
145
+ checks.push({
146
+ name: "required_env",
147
+ status: "ok",
148
+ message: "All required local environment variables are present.",
149
+ });
150
+ if (datasource.type?.toLowerCase() !== "grafana") {
151
+ checks.push({
152
+ name: "provider_probe",
153
+ status: "skipped",
154
+ message: `No provider-specific probe is implemented for datasource type ${datasource.type ?? "unknown"}.`,
155
+ });
156
+ return {
157
+ ok: true,
158
+ datasource: safe,
159
+ checks,
160
+ missing_env_vars: [],
161
+ };
162
+ }
163
+ const grafanaURL = grafanaURLForDatasource(safe);
164
+ const tokenEnvVar = grafanaTokenEnvVar(safe.required_env_vars);
165
+ const token = process.env[tokenEnvVar]?.trim();
166
+ if (!grafanaURL || !token) {
167
+ const missing = [
168
+ ...(!grafanaURL ? ["GRAFANA_URL"] : []),
169
+ ...(!token ? [tokenEnvVar] : []),
170
+ ];
171
+ checks.push({
172
+ name: "grafana_config",
173
+ status: "error",
174
+ message: `Grafana probe needs ${missing.join(" and ")}.`,
175
+ });
176
+ return {
177
+ ok: false,
178
+ datasource: safe,
179
+ checks,
180
+ missing_env_vars: missing,
181
+ recommended_action: "Set Grafana URL and service account token in the local MCP client environment.",
182
+ };
183
+ }
184
+ checks.push(await probeGrafanaHealth(grafanaURL, token, timeoutMs));
185
+ return {
186
+ ok: checks.every((check) => check.status === "ok" || check.status === "skipped"),
187
+ datasource: safe,
188
+ checks,
189
+ missing_env_vars: [],
190
+ };
191
+ }
192
+ async function probeGrafanaHealth(grafanaURL, token, timeoutMs) {
193
+ let timeout;
194
+ const controller = new AbortController();
195
+ try {
196
+ timeout = setTimeout(() => controller.abort(), timeoutMs);
197
+ const response = await fetch(grafanaHealthURL(grafanaURL), {
198
+ method: "GET",
199
+ headers: {
200
+ Accept: "application/json",
201
+ Authorization: `Bearer ${token}`,
202
+ },
203
+ signal: controller.signal,
204
+ });
205
+ if (response.ok) {
206
+ return {
207
+ name: "grafana_health",
208
+ status: "ok",
209
+ message: "Grafana /api/health responded successfully.",
210
+ http_status: response.status,
211
+ };
212
+ }
213
+ return {
214
+ name: "grafana_health",
215
+ status: "error",
216
+ message: `Grafana /api/health returned HTTP ${response.status}.`,
217
+ http_status: response.status,
218
+ };
219
+ }
220
+ catch (err) {
221
+ const aborted = err instanceof Error && err.name.toLowerCase() === "aborterror";
222
+ return {
223
+ name: "grafana_health",
224
+ status: "error",
225
+ message: aborted
226
+ ? `Grafana /api/health timed out after ${timeoutMs}ms.`
227
+ : "Grafana /api/health failed before receiving a response. Check the URL, network path, and TLS configuration.",
228
+ };
229
+ }
230
+ finally {
231
+ if (timeout !== undefined)
232
+ clearTimeout(timeout);
233
+ }
234
+ }
235
+ function safeDatasource(datasource) {
236
+ const config = datasourceConfig(datasource);
237
+ const requiredEnvVars = requiredEnvVarsForDatasource(datasource, config);
238
+ return {
239
+ id: datasource.id,
240
+ name: datasource.name,
241
+ type: datasource.type,
242
+ custody_mode: datasource.custody_mode,
243
+ enabled: datasource.enabled,
244
+ base_url: safeURL(stringField(config, "base_url")),
245
+ mcp_server: stringField(config, "mcp_server"),
246
+ datasource_names: stringArrayField(config, "datasource_names"),
247
+ required_env_vars: requiredEnvVars,
248
+ };
249
+ }
250
+ function datasourceConfig(datasource) {
251
+ if (isRecord(datasource.metadata))
252
+ return datasource.metadata;
253
+ if (isRecord(datasource.config))
254
+ return datasource.config;
255
+ return {};
256
+ }
257
+ function requiredEnvVarsForDatasource(datasource, config) {
258
+ const configured = stringArrayField(config, "required_env_vars");
259
+ if (configured.length > 0)
260
+ return configured;
261
+ if (datasource.type?.toLowerCase() === "grafana") {
262
+ return DEFAULT_GRAFANA_ENV_VARS;
263
+ }
264
+ return [];
265
+ }
266
+ function grafanaURLForDatasource(datasource) {
267
+ const envURL = process.env.GRAFANA_URL?.trim();
268
+ return envURL || datasource.base_url;
269
+ }
270
+ function grafanaTokenEnvVar(requiredEnvVars) {
271
+ return (requiredEnvVars.find((envVar) => /(^|_)(TOKEN|API_KEY|PASSWORD|SECRET)(_|$)/i.test(envVar)) ?? "GRAFANA_SERVICE_ACCOUNT_TOKEN");
272
+ }
273
+ function grafanaHealthURL(baseURL) {
274
+ const url = new URL(baseURL);
275
+ url.username = "";
276
+ url.password = "";
277
+ const pathPrefix = url.pathname === "/" ? "" : url.pathname.replace(/\/+$/, "");
278
+ url.pathname = `${pathPrefix}/api/health`;
279
+ url.search = "";
280
+ url.hash = "";
281
+ return url.toString();
282
+ }
283
+ function stringField(record, key) {
284
+ const value = record[key];
285
+ if (typeof value !== "string")
286
+ return undefined;
287
+ const trimmed = value.trim();
288
+ return trimmed || undefined;
289
+ }
290
+ function stringArrayField(record, key) {
291
+ const value = record[key];
292
+ if (!Array.isArray(value))
293
+ return [];
294
+ return value
295
+ .filter((item) => typeof item === "string")
296
+ .map((item) => item.trim())
297
+ .filter(Boolean);
298
+ }
299
+ function safeURL(raw) {
300
+ if (!raw)
301
+ return undefined;
302
+ try {
303
+ const url = new URL(raw);
304
+ url.username = "";
305
+ url.password = "";
306
+ for (const key of [...url.searchParams.keys()]) {
307
+ if (isSensitiveKey(key))
308
+ url.searchParams.delete(key);
309
+ }
310
+ if (url.pathname === "/" && url.search === "") {
311
+ return `${url.protocol}//${url.host}`;
312
+ }
313
+ return url.toString().replace(/\/$/, "");
314
+ }
315
+ catch {
316
+ return undefined;
317
+ }
318
+ }
319
+ function isSensitiveKey(key) {
320
+ return /(token|key|secret|password|authorization|auth)/i.test(key);
321
+ }
322
+ function isRecord(value) {
323
+ return typeof value === "object" && value !== null && !Array.isArray(value);
324
+ }
325
+ //# sourceMappingURL=datasources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"datasources.js","sourceRoot":"","sources":["../../src/tools/datasources.ts"],"names":[],"mappings":"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"}