@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,377 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://tellagen.dev/contracts/runbooks/v2/runbook-definition.schema.json",
4
+ "title": "Tellagen structured investigation runbook definition",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "match",
10
+ "source_requirements",
11
+ "entry_check_ids",
12
+ "checks",
13
+ "escalation",
14
+ "completion"
15
+ ],
16
+ "properties": {
17
+ "schema_version": {"const": "v2"},
18
+ "match": {"$ref": "#/$defs/matcher"},
19
+ "source_requirements": {
20
+ "type": "array",
21
+ "minItems": 1,
22
+ "maxItems": 16,
23
+ "items": {"$ref": "#/$defs/sourceRequirement"}
24
+ },
25
+ "entry_check_ids": {
26
+ "type": "array",
27
+ "minItems": 1,
28
+ "maxItems": 16,
29
+ "uniqueItems": true,
30
+ "items": {"$ref": "#/$defs/stableID"}
31
+ },
32
+ "checks": {
33
+ "type": "array",
34
+ "minItems": 1,
35
+ "maxItems": 64,
36
+ "items": {"$ref": "#/$defs/check"}
37
+ },
38
+ "escalation": {"$ref": "#/$defs/escalation"},
39
+ "remediation": {"$ref": "#/$defs/remediation"},
40
+ "completion": {"$ref": "#/$defs/completion"},
41
+ "notes": {"type": "string", "maxLength": 16384}
42
+ },
43
+ "$defs": {
44
+ "stableID": {
45
+ "type": "string",
46
+ "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
47
+ "maxLength": 64
48
+ },
49
+ "tokenArray": {
50
+ "type": "array",
51
+ "maxItems": 32,
52
+ "uniqueItems": true,
53
+ "items": {"type": "string", "minLength": 1, "maxLength": 128}
54
+ },
55
+ "matcher": {
56
+ "type": "object",
57
+ "additionalProperties": false,
58
+ "required": ["scope"],
59
+ "properties": {
60
+ "scope": {"enum": ["global", "service", "context"]},
61
+ "services": {"$ref": "#/$defs/tokenArray"},
62
+ "tags": {"$ref": "#/$defs/tokenArray"},
63
+ "symptoms": {"$ref": "#/$defs/tokenArray"},
64
+ "severities": {"$ref": "#/$defs/tokenArray"},
65
+ "priority": {"type": "integer", "minimum": 0, "maximum": 100}
66
+ },
67
+ "allOf": [
68
+ {
69
+ "if": {"properties": {"scope": {"const": "global"}}, "required": ["scope"]},
70
+ "then": {
71
+ "properties": {
72
+ "services": {"maxItems": 0},
73
+ "tags": {"maxItems": 0},
74
+ "symptoms": {"maxItems": 0},
75
+ "severities": {"maxItems": 0}
76
+ }
77
+ }
78
+ },
79
+ {
80
+ "if": {"properties": {"scope": {"const": "service"}}, "required": ["scope"]},
81
+ "then": {"required": ["services"], "properties": {"services": {"minItems": 1}}}
82
+ },
83
+ {
84
+ "if": {"properties": {"scope": {"const": "context"}}, "required": ["scope"]},
85
+ "then": {
86
+ "properties": {"services": {"maxItems": 0}},
87
+ "anyOf": [
88
+ {"required": ["tags"], "properties": {"tags": {"minItems": 1}}},
89
+ {"required": ["symptoms"], "properties": {"symptoms": {"minItems": 1}}},
90
+ {"required": ["severities"], "properties": {"severities": {"minItems": 1}}}
91
+ ]
92
+ }
93
+ }
94
+ ]
95
+ },
96
+ "sourceRequirement": {
97
+ "type": "object",
98
+ "additionalProperties": false,
99
+ "required": ["id", "source_key", "capabilities", "required", "on_unavailable"],
100
+ "properties": {
101
+ "id": {"$ref": "#/$defs/stableID"},
102
+ "source_key": {"enum": ["grafana", "kubernetes", "github"]},
103
+ "capabilities": {
104
+ "type": "array",
105
+ "minItems": 1,
106
+ "uniqueItems": true,
107
+ "items": {
108
+ "enum": [
109
+ "dashboards:list",
110
+ "prometheus:query",
111
+ "loki:query",
112
+ "explore:link",
113
+ "datasources:list",
114
+ "pods:list",
115
+ "logs:read",
116
+ "events:list",
117
+ "deployments:list",
118
+ "namespaces:list",
119
+ "repos:read",
120
+ "pull_requests:read",
121
+ "commits:read",
122
+ "actions:read"
123
+ ]
124
+ }
125
+ },
126
+ "required": {"type": "boolean"},
127
+ "binding_selector": {
128
+ "type": "object",
129
+ "additionalProperties": false,
130
+ "required": ["connector_id"],
131
+ "properties": {"connector_id": {"type": "integer", "minimum": 1}}
132
+ },
133
+ "on_unavailable": {
134
+ "type": "object",
135
+ "additionalProperties": false,
136
+ "required": ["action"],
137
+ "properties": {"action": {"enum": ["fail", "record_gap", "use_fallback"]}}
138
+ },
139
+ "fallback_requirement_ids": {
140
+ "type": "array",
141
+ "maxItems": 16,
142
+ "uniqueItems": true,
143
+ "items": {"$ref": "#/$defs/stableID"}
144
+ }
145
+ },
146
+ "allOf": [
147
+ {
148
+ "if": {"properties": {"source_key": {"const": "grafana"}}, "required": ["source_key"]},
149
+ "then": {"properties": {"capabilities": {"items": {"enum": ["dashboards:list", "prometheus:query", "loki:query", "explore:link", "datasources:list"]}}}}
150
+ },
151
+ {
152
+ "if": {"properties": {"source_key": {"const": "kubernetes"}}, "required": ["source_key"]},
153
+ "then": {"properties": {"capabilities": {"items": {"enum": ["pods:list", "logs:read", "events:list", "deployments:list", "namespaces:list"]}}}}
154
+ },
155
+ {
156
+ "if": {"properties": {"source_key": {"const": "github"}}, "required": ["source_key"]},
157
+ "then": {"properties": {"capabilities": {"items": {"enum": ["repos:read", "pull_requests:read", "commits:read", "actions:read"]}}}}
158
+ },
159
+ {
160
+ "if": {"properties": {"on_unavailable": {"properties": {"action": {"const": "use_fallback"}}, "required": ["action"]}}, "required": ["on_unavailable"]},
161
+ "then": {"required": ["fallback_requirement_ids"], "properties": {"fallback_requirement_ids": {"minItems": 1}}}
162
+ },
163
+ {
164
+ "if": {"properties": {"on_unavailable": {"properties": {"action": {"enum": ["fail", "record_gap"]}}, "required": ["action"]}}, "required": ["on_unavailable"]},
165
+ "then": {"properties": {"fallback_requirement_ids": {"maxItems": 0}}}
166
+ }
167
+ ]
168
+ },
169
+ "parameter": {
170
+ "type": "object",
171
+ "additionalProperties": false,
172
+ "required": ["type"],
173
+ "properties": {
174
+ "type": {"enum": ["boolean", "duration", "integer", "string", "string_list", "time_range"]},
175
+ "source": {
176
+ "enum": [
177
+ "incident.service",
178
+ "incident.services",
179
+ "incident.severity",
180
+ "incident.symptoms",
181
+ "incident.tags",
182
+ "incident.time_range"
183
+ ]
184
+ },
185
+ "value": {
186
+ "oneOf": [
187
+ {"type": "boolean"},
188
+ {"type": "integer", "minimum": -1000000000, "maximum": 1000000000},
189
+ {"type": "string", "minLength": 1, "maxLength": 1024},
190
+ {
191
+ "type": "array",
192
+ "minItems": 1,
193
+ "maxItems": 32,
194
+ "items": {"type": "string", "minLength": 1, "maxLength": 256}
195
+ }
196
+ ]
197
+ },
198
+ "target": {"type": "string", "pattern": "^request\\.[a-z][a-z0-9_.-]*$"}
199
+ },
200
+ "oneOf": [
201
+ {"required": ["source"], "not": {"required": ["value"]}},
202
+ {"required": ["value"], "not": {"required": ["source"]}}
203
+ ],
204
+ "allOf": [
205
+ {
206
+ "if": {"properties": {"type": {"const": "boolean"}}, "required": ["type", "value"]},
207
+ "then": {"properties": {"value": {"type": "boolean"}}}
208
+ },
209
+ {
210
+ "if": {"properties": {"type": {"const": "integer"}}, "required": ["type", "value"]},
211
+ "then": {"properties": {"value": {"type": "integer", "minimum": -1000000000, "maximum": 1000000000}}}
212
+ },
213
+ {
214
+ "if": {"properties": {"type": {"const": "duration"}}, "required": ["type", "value"]},
215
+ "then": {"properties": {"value": {"type": "string", "pattern": "^[0-9]+(?:\\.[0-9]+)?(?:ns|us|µs|ms|s|m|h)(?:[0-9]+(?:\\.[0-9]+)?(?:ns|us|µs|ms|s|m|h))*$"}}}
216
+ },
217
+ {
218
+ "if": {"properties": {"type": {"const": "string"}}, "required": ["type", "value"]},
219
+ "then": {"properties": {"value": {"type": "string", "minLength": 1, "maxLength": 1024}}}
220
+ },
221
+ {
222
+ "if": {"properties": {"type": {"const": "string_list"}}, "required": ["type", "value"]},
223
+ "then": {"properties": {"value": {"type": "array", "minItems": 1, "maxItems": 32, "items": {"type": "string", "minLength": 1, "maxLength": 256}}}}
224
+ },
225
+ {
226
+ "if": {"properties": {"source": {"enum": ["incident.service", "incident.severity"]}}, "required": ["source"]},
227
+ "then": {"properties": {"type": {"const": "string"}}}
228
+ },
229
+ {
230
+ "if": {"properties": {"source": {"enum": ["incident.services", "incident.symptoms", "incident.tags"]}}, "required": ["source"]},
231
+ "then": {"properties": {"type": {"const": "string_list"}}}
232
+ },
233
+ {
234
+ "if": {"properties": {"source": {"const": "incident.time_range"}}, "required": ["source"]},
235
+ "then": {"properties": {"type": {"const": "time_range"}}}
236
+ }
237
+ ]
238
+ },
239
+ "parameters": {
240
+ "type": "object",
241
+ "maxProperties": 32,
242
+ "propertyNames": {"pattern": "^[a-z][a-z0-9_]{0,63}$"},
243
+ "additionalProperties": {"$ref": "#/$defs/parameter"}
244
+ },
245
+ "queryBounds": {
246
+ "type": "object",
247
+ "additionalProperties": false,
248
+ "required": ["lookback", "step", "max_points"],
249
+ "properties": {
250
+ "lookback": {"type": "string", "minLength": 2, "maxLength": 64},
251
+ "step": {"type": "string", "minLength": 2, "maxLength": 64},
252
+ "max_points": {"type": "integer", "minimum": 1, "maximum": 10000}
253
+ }
254
+ },
255
+ "queryInvocation": {
256
+ "type": "object",
257
+ "additionalProperties": false,
258
+ "required": ["kind", "capability", "template", "parameters", "bounds"],
259
+ "properties": {
260
+ "kind": {"const": "query"},
261
+ "capability": {"type": "string", "pattern": "^[a-z][a-z0-9_-]*:[a-z][a-z0-9_-]*$"},
262
+ "template": {"type": "string", "minLength": 1, "maxLength": 8192},
263
+ "parameters": {"$ref": "#/$defs/parameters"},
264
+ "bounds": {"$ref": "#/$defs/queryBounds"}
265
+ }
266
+ },
267
+ "commandInvocation": {
268
+ "type": "object",
269
+ "additionalProperties": false,
270
+ "required": ["kind", "capability", "args", "parameters", "timeout_seconds", "max_output_bytes"],
271
+ "properties": {
272
+ "kind": {"const": "command"},
273
+ "capability": {"type": "string", "pattern": "^[a-z][a-z0-9_-]*:[a-z][a-z0-9_-]*$"},
274
+ "args": {
275
+ "type": "array",
276
+ "minItems": 1,
277
+ "maxItems": 32,
278
+ "items": {"type": "string", "minLength": 1, "maxLength": 1024},
279
+ "not": {"contains": {"enum": ["apply", "create", "delete", "edit", "exec", "merge", "patch", "push", "replace", "restart", "scale", "set", "update", "write"]}}
280
+ },
281
+ "parameters": {"$ref": "#/$defs/parameters"},
282
+ "timeout_seconds": {"type": "integer", "minimum": 1, "maximum": 120},
283
+ "max_output_bytes": {"type": "integer", "minimum": 1, "maximum": 1048576}
284
+ }
285
+ },
286
+ "evidenceContract": {
287
+ "type": "object",
288
+ "additionalProperties": false,
289
+ "required": ["kind", "required_fields"],
290
+ "properties": {
291
+ "kind": {"enum": ["command_output", "document", "events", "logs", "records", "source_change", "timeseries"]},
292
+ "required_fields": {
293
+ "type": "array",
294
+ "minItems": 1,
295
+ "maxItems": 9,
296
+ "uniqueItems": true,
297
+ "contains": {"const": "result_summary"},
298
+ "items": {"enum": ["artifact", "captured_at", "join_basis", "query", "resource_identity", "result_sample", "result_summary", "source_url", "time_range"]}
299
+ }
300
+ }
301
+ },
302
+ "check": {
303
+ "type": "object",
304
+ "additionalProperties": false,
305
+ "required": [
306
+ "id",
307
+ "intent",
308
+ "source_requirement_id",
309
+ "safety",
310
+ "invocation",
311
+ "evidence_contract",
312
+ "confirms_when",
313
+ "falsifies_when",
314
+ "on_confirm",
315
+ "on_falsify",
316
+ "on_error"
317
+ ],
318
+ "properties": {
319
+ "id": {"$ref": "#/$defs/stableID"},
320
+ "intent": {"type": "string", "minLength": 1, "maxLength": 4096},
321
+ "source_requirement_id": {"$ref": "#/$defs/stableID"},
322
+ "safety": {"const": "read_only"},
323
+ "invocation": {"oneOf": [{"$ref": "#/$defs/queryInvocation"}, {"$ref": "#/$defs/commandInvocation"}]},
324
+ "evidence_contract": {"$ref": "#/$defs/evidenceContract"},
325
+ "confirms_when": {"type": "string", "minLength": 1, "maxLength": 4096},
326
+ "falsifies_when": {"type": "string", "minLength": 1, "maxLength": 4096},
327
+ "on_confirm": {"type": "array", "maxItems": 16, "uniqueItems": true, "items": {"$ref": "#/$defs/stableID"}},
328
+ "on_falsify": {"type": "array", "maxItems": 16, "uniqueItems": true, "items": {"$ref": "#/$defs/stableID"}},
329
+ "on_error": {
330
+ "type": "object",
331
+ "additionalProperties": false,
332
+ "required": ["action"],
333
+ "properties": {"action": {"enum": ["fail_run", "record_gap"]}}
334
+ }
335
+ }
336
+ },
337
+ "escalation": {
338
+ "type": "object",
339
+ "additionalProperties": false,
340
+ "required": ["when", "target"],
341
+ "properties": {
342
+ "when": {"type": "string", "minLength": 1, "maxLength": 4096},
343
+ "target": {"type": "string", "minLength": 1, "maxLength": 512}
344
+ }
345
+ },
346
+ "remediation": {
347
+ "type": "object",
348
+ "additionalProperties": false,
349
+ "required": [
350
+ "mode",
351
+ "proposed_steps",
352
+ "approval_required",
353
+ "approval_expectation",
354
+ "rollback_steps",
355
+ "verification_check_id"
356
+ ],
357
+ "properties": {
358
+ "mode": {"const": "suggest_only"},
359
+ "proposed_steps": {"type": "array", "minItems": 1, "maxItems": 16, "items": {"type": "string", "minLength": 1, "maxLength": 4096}},
360
+ "approval_required": {"const": true},
361
+ "approval_expectation": {"type": "string", "minLength": 1, "maxLength": 1024},
362
+ "rollback_steps": {"type": "array", "minItems": 1, "maxItems": 16, "items": {"type": "string", "minLength": 1, "maxLength": 4096}},
363
+ "verification_check_id": {"$ref": "#/$defs/stableID"}
364
+ }
365
+ },
366
+ "completion": {
367
+ "type": "object",
368
+ "additionalProperties": false,
369
+ "required": ["required_check_ids", "allow_inconclusive", "require_gap_reason_for_skips"],
370
+ "properties": {
371
+ "required_check_ids": {"type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": {"$ref": "#/$defs/stableID"}},
372
+ "allow_inconclusive": {"type": "boolean"},
373
+ "require_gap_reason_for_skips": {"type": "boolean"}
374
+ }
375
+ }
376
+ }
377
+ }