@tellagen/mcp-server 0.1.3 → 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.
- package/README.md +208 -12
- package/SKILL.md +376 -15
- package/contracts/runbooks/manifest.json +47 -0
- package/contracts/runbooks/v1/fixtures/global-runbook.json +7 -0
- package/contracts/runbooks/v1/runbook-definition.schema.json +25 -0
- package/contracts/runbooks/v2/compiled-plan.schema.json +40 -0
- package/contracts/runbooks/v2/fixtures/filesystem-pressure.json +181 -0
- package/contracts/runbooks/v2/fixtures/grafana-error-rate-plan.json +50 -0
- package/contracts/runbooks/v2/fixtures/grafana-error-rate.json +58 -0
- package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +90 -0
- package/contracts/runbooks/v2/fixtures/timeline-event-with-blocks.json +61 -0
- package/contracts/runbooks/v2/runbook-definition.schema.json +377 -0
- package/contracts/runbooks/v2/timeline-event-blocks.schema.json +480 -0
- package/contracts/tellagen-runbook-contracts.json +8 -0
- package/dist/auth.d.ts +2 -1
- package/dist/auth.js +2 -1
- package/dist/auth.js.map +1 -1
- package/dist/client.d.ts +20 -0
- package/dist/client.js +81 -12
- package/dist/client.js.map +1 -1
- package/dist/diagnosis-structure.d.ts +1416 -0
- package/dist/diagnosis-structure.js +656 -0
- package/dist/diagnosis-structure.js.map +1 -0
- package/dist/errors.d.ts +2 -1
- package/dist/errors.js +4 -1
- package/dist/errors.js.map +1 -1
- package/dist/figures.d.ts +2336 -0
- package/dist/figures.js +1288 -0
- package/dist/figures.js.map +1 -0
- package/dist/image-info.d.ts +14 -0
- package/dist/image-info.js +65 -0
- package/dist/image-info.js.map +1 -0
- package/dist/index.js +2 -6
- package/dist/index.js.map +1 -1
- package/dist/server.js +63 -6
- package/dist/server.js.map +1 -1
- package/dist/source-links.d.ts +101 -0
- package/dist/source-links.js +374 -0
- package/dist/source-links.js.map +1 -0
- package/dist/start.d.ts +11 -0
- package/dist/start.js +14 -0
- package/dist/start.js.map +1 -0
- package/dist/tools/attachments.d.ts +19 -0
- package/dist/tools/attachments.js +177 -0
- package/dist/tools/attachments.js.map +1 -0
- package/dist/tools/causes.d.ts +50 -0
- package/dist/tools/causes.js +97 -0
- package/dist/tools/causes.js.map +1 -0
- package/dist/tools/datasources.d.ts +3 -0
- package/dist/tools/datasources.js +325 -0
- package/dist/tools/datasources.js.map +1 -0
- package/dist/tools/diagnostics.d.ts +3 -0
- package/dist/tools/diagnostics.js +113 -0
- package/dist/tools/diagnostics.js.map +1 -0
- package/dist/tools/figures.d.ts +8 -0
- package/dist/tools/figures.js +209 -0
- package/dist/tools/figures.js.map +1 -0
- package/dist/tools/findings.js +84 -6
- package/dist/tools/findings.js.map +1 -1
- package/dist/tools/incidents.js +44 -4
- package/dist/tools/incidents.js.map +1 -1
- package/dist/tools/index.js +14 -0
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/investigations.js +523 -21
- package/dist/tools/investigations.js.map +1 -1
- package/dist/tools/postmortem-runbooks.d.ts +786 -0
- package/dist/tools/postmortem-runbooks.js +330 -0
- package/dist/tools/postmortem-runbooks.js.map +1 -0
- package/dist/tools/source-links.d.ts +47 -0
- package/dist/tools/source-links.js +302 -0
- package/dist/tools/source-links.js.map +1 -0
- package/dist/tools/timeline.js +173 -0
- package/dist/tools/timeline.js.map +1 -1
- package/dist/version.d.ts +2 -0
- package/dist/version.js +12 -0
- package/dist/version.js.map +1 -0
- package/package.json +3 -2
- package/server.json +15 -1
package/dist/client.js
CHANGED
|
@@ -1,4 +1,30 @@
|
|
|
1
1
|
import { TellagenAPIError } from "./errors.js";
|
|
2
|
+
/** The API error of a response that is not ok, from its JSON body when it has one. */
|
|
3
|
+
async function apiError(res) {
|
|
4
|
+
let code = "unknown";
|
|
5
|
+
let message = `HTTP ${res.status}`;
|
|
6
|
+
let payload;
|
|
7
|
+
try {
|
|
8
|
+
const candidate = (await res.json());
|
|
9
|
+
if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
|
|
10
|
+
payload = candidate;
|
|
11
|
+
if (typeof payload.code === "string") {
|
|
12
|
+
code = payload.code;
|
|
13
|
+
}
|
|
14
|
+
else if (typeof payload.error === "string") {
|
|
15
|
+
code = payload.error;
|
|
16
|
+
}
|
|
17
|
+
if (typeof payload.message === "string") {
|
|
18
|
+
message = payload.message;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
catch {
|
|
23
|
+
// Response was not JSON — use status text.
|
|
24
|
+
message = res.statusText || message;
|
|
25
|
+
}
|
|
26
|
+
return new TellagenAPIError(res.status, code, message, payload);
|
|
27
|
+
}
|
|
2
28
|
/** Thin HTTP wrapper for the Tellagen public API. */
|
|
3
29
|
export class TellagenClient {
|
|
4
30
|
baseUrl;
|
|
@@ -25,27 +51,70 @@ export class TellagenClient {
|
|
|
25
51
|
}
|
|
26
52
|
const res = await fetch(url, init);
|
|
27
53
|
if (!res.ok) {
|
|
28
|
-
|
|
29
|
-
let message = `HTTP ${res.status}`;
|
|
30
|
-
try {
|
|
31
|
-
const errBody = (await res.json());
|
|
32
|
-
code = errBody.error ?? code;
|
|
33
|
-
message = errBody.message ?? message;
|
|
34
|
-
}
|
|
35
|
-
catch {
|
|
36
|
-
// Response was not JSON — use status text.
|
|
37
|
-
message = res.statusText || message;
|
|
38
|
-
}
|
|
39
|
-
throw new TellagenAPIError(res.status, code, message);
|
|
54
|
+
throw await apiError(res);
|
|
40
55
|
}
|
|
41
56
|
return (await res.json());
|
|
42
57
|
}
|
|
58
|
+
/**
|
|
59
|
+
* GET the bytes at an API path with the API key, for images and other
|
|
60
|
+
* files. A response larger than maxBytes is refused before it is read in
|
|
61
|
+
* full, and an error status is reported like any other API error.
|
|
62
|
+
*/
|
|
63
|
+
async getBinary(path, options) {
|
|
64
|
+
const res = await fetch(`${this.baseUrl}${path}`, {
|
|
65
|
+
method: "GET",
|
|
66
|
+
headers: {
|
|
67
|
+
Authorization: `Bearer ${this.apiKey}`,
|
|
68
|
+
Accept: options.accept ?? "*/*",
|
|
69
|
+
},
|
|
70
|
+
});
|
|
71
|
+
if (!res.ok) {
|
|
72
|
+
throw await apiError(res);
|
|
73
|
+
}
|
|
74
|
+
const tooLarge = (size) => new TellagenAPIError(413, "response_too_large", `The response is ${size} bytes; at most ${options.maxBytes} are read`);
|
|
75
|
+
const declared = Number(res.headers.get("content-length") ?? "");
|
|
76
|
+
if (Number.isFinite(declared) && declared > options.maxBytes) {
|
|
77
|
+
await res.body?.cancel().catch(() => undefined);
|
|
78
|
+
throw tooLarge(declared);
|
|
79
|
+
}
|
|
80
|
+
const chunks = [];
|
|
81
|
+
let size = 0;
|
|
82
|
+
if (res.body) {
|
|
83
|
+
const reader = res.body.getReader();
|
|
84
|
+
for (;;) {
|
|
85
|
+
const { done, value } = await reader.read();
|
|
86
|
+
if (done)
|
|
87
|
+
break;
|
|
88
|
+
size += value.byteLength;
|
|
89
|
+
if (size > options.maxBytes) {
|
|
90
|
+
await reader.cancel().catch(() => undefined);
|
|
91
|
+
throw tooLarge(size);
|
|
92
|
+
}
|
|
93
|
+
chunks.push(value);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
const bytes = new Uint8Array(size);
|
|
97
|
+
let offset = 0;
|
|
98
|
+
for (const chunk of chunks) {
|
|
99
|
+
bytes.set(chunk, offset);
|
|
100
|
+
offset += chunk.byteLength;
|
|
101
|
+
}
|
|
102
|
+
return {
|
|
103
|
+
bytes,
|
|
104
|
+
contentType: (res.headers.get("content-type") ?? "").split(";")[0].trim().toLowerCase(),
|
|
105
|
+
etag: res.headers.get("etag") ?? undefined,
|
|
106
|
+
contentDisposition: res.headers.get("content-disposition") ?? undefined,
|
|
107
|
+
};
|
|
108
|
+
}
|
|
43
109
|
async get(path) {
|
|
44
110
|
return this.request("GET", path);
|
|
45
111
|
}
|
|
46
112
|
async post(path, body) {
|
|
47
113
|
return this.request("POST", path, body);
|
|
48
114
|
}
|
|
115
|
+
async put(path, body) {
|
|
116
|
+
return this.request("PUT", path, body);
|
|
117
|
+
}
|
|
49
118
|
async patch(path, body) {
|
|
50
119
|
return this.request("PATCH", path, body);
|
|
51
120
|
}
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|