@tellagen/mcp-server 0.4.2 → 0.5.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 (180) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +334 -101
  3. package/SKILL.md +83 -17
  4. package/contracts/mcp-protocol.json +155 -0
  5. package/contracts/runbooks/manifest.json +26 -6
  6. package/contracts/runbooks/v2/cause-lead.guidance.json +37 -0
  7. package/contracts/runbooks/v2/client-protocol.json +926 -0
  8. package/contracts/runbooks/v2/client-writes.guidance.json +42 -0
  9. package/contracts/runbooks/v2/fixtures/timeline-event-blocks-rejected.json +30 -5
  10. package/contracts/runbooks/v2/result-summary.guidance.json +21 -0
  11. package/contracts/runbooks/v2/timeline-event-blocks.schema.json +18 -11
  12. package/contracts/tellagen-runbook-contracts.json +4 -4
  13. package/dist/active-run.d.ts +29 -0
  14. package/dist/active-run.js +67 -0
  15. package/dist/active-run.js.map +1 -0
  16. package/dist/bootstrap.d.ts +20 -0
  17. package/dist/bootstrap.js +29 -0
  18. package/dist/bootstrap.js.map +1 -0
  19. package/dist/cause-lead.d.ts +25 -0
  20. package/dist/cause-lead.js +145 -0
  21. package/dist/cause-lead.js.map +1 -0
  22. package/dist/cli/auth.d.ts +22 -0
  23. package/dist/cli/auth.js +207 -0
  24. package/dist/cli/auth.js.map +1 -0
  25. package/dist/cli/io.d.ts +16 -0
  26. package/dist/cli/io.js +53 -0
  27. package/dist/cli/io.js.map +1 -0
  28. package/dist/cli/listen-guard.d.ts +12 -0
  29. package/dist/cli/listen-guard.js +50 -0
  30. package/dist/cli/listen-guard.js.map +1 -0
  31. package/dist/cli/listen.d.ts +28 -0
  32. package/dist/cli/listen.js +205 -0
  33. package/dist/cli/listen.js.map +1 -0
  34. package/dist/cli/main.d.ts +3 -0
  35. package/dist/cli/main.js +53 -0
  36. package/dist/cli/main.js.map +1 -0
  37. package/dist/cli/trace-hook.d.ts +23 -0
  38. package/dist/cli/trace-hook.js +99 -0
  39. package/dist/cli/trace-hook.js.map +1 -0
  40. package/dist/client.d.ts +92 -6
  41. package/dist/client.js +300 -23
  42. package/dist/client.js.map +1 -1
  43. package/dist/config.d.ts +17 -0
  44. package/dist/config.js +38 -0
  45. package/dist/config.js.map +1 -0
  46. package/dist/credentials.d.ts +120 -0
  47. package/dist/credentials.js +363 -0
  48. package/dist/credentials.js.map +1 -0
  49. package/dist/diagnosis-structure.d.ts +207 -147
  50. package/dist/diagnosis-structure.js +142 -1
  51. package/dist/diagnosis-structure.js.map +1 -1
  52. package/dist/diff-figure.d.ts +56 -0
  53. package/dist/diff-figure.js +276 -0
  54. package/dist/diff-figure.js.map +1 -0
  55. package/dist/errors.d.ts +21 -0
  56. package/dist/errors.js +60 -0
  57. package/dist/errors.js.map +1 -1
  58. package/dist/figures.d.ts +281 -201
  59. package/dist/figures.js +189 -47
  60. package/dist/figures.js.map +1 -1
  61. package/dist/guide-resources.d.ts +28 -0
  62. package/dist/guide-resources.js +81 -0
  63. package/dist/guide-resources.js.map +1 -0
  64. package/dist/heartbeat.d.ts +24 -0
  65. package/dist/heartbeat.js +94 -0
  66. package/dist/heartbeat.js.map +1 -0
  67. package/dist/home.d.ts +8 -0
  68. package/dist/home.js +14 -0
  69. package/dist/home.js.map +1 -0
  70. package/dist/identity.d.ts +32 -0
  71. package/dist/identity.js +83 -0
  72. package/dist/identity.js.map +1 -0
  73. package/dist/index.js +46 -14
  74. package/dist/index.js.map +1 -1
  75. package/dist/listen-config.d.ts +67 -0
  76. package/dist/listen-config.js +83 -0
  77. package/dist/listen-config.js.map +1 -0
  78. package/dist/listen-probe.d.ts +57 -0
  79. package/dist/listen-probe.js +158 -0
  80. package/dist/listen-probe.js.map +1 -0
  81. package/dist/listen-rules.d.ts +88 -0
  82. package/dist/listen-rules.js +252 -0
  83. package/dist/listen-rules.js.map +1 -0
  84. package/dist/listen-settings.d.ts +18 -0
  85. package/dist/listen-settings.js +50 -0
  86. package/dist/listen-settings.js.map +1 -0
  87. package/dist/listen-wrap.d.ts +21 -0
  88. package/dist/listen-wrap.js +52 -0
  89. package/dist/listen-wrap.js.map +1 -0
  90. package/dist/listener.d.ts +195 -0
  91. package/dist/listener.js +600 -0
  92. package/dist/listener.js.map +1 -0
  93. package/dist/open-run.d.ts +2 -0
  94. package/dist/open-run.js +5 -0
  95. package/dist/open-run.js.map +1 -0
  96. package/dist/prompts.d.ts +12 -0
  97. package/dist/prompts.js +37 -0
  98. package/dist/prompts.js.map +1 -0
  99. package/dist/redact.d.ts +13 -0
  100. package/dist/redact.js +76 -0
  101. package/dist/redact.js.map +1 -0
  102. package/dist/run-events.d.ts +54 -0
  103. package/dist/run-events.js +210 -0
  104. package/dist/run-events.js.map +1 -0
  105. package/dist/run-state.d.ts +184 -0
  106. package/dist/run-state.js +207 -0
  107. package/dist/run-state.js.map +1 -0
  108. package/dist/server.d.ts +22 -2
  109. package/dist/server.js +137 -29
  110. package/dist/server.js.map +1 -1
  111. package/dist/session.d.ts +86 -0
  112. package/dist/session.js +155 -0
  113. package/dist/session.js.map +1 -0
  114. package/dist/shell-rules.d.ts +49 -0
  115. package/dist/shell-rules.js +335 -0
  116. package/dist/shell-rules.js.map +1 -0
  117. package/dist/signin-index.d.ts +164 -0
  118. package/dist/signin-index.js +116 -0
  119. package/dist/signin-index.js.map +1 -0
  120. package/dist/signin.d.ts +169 -0
  121. package/dist/signin.js +541 -0
  122. package/dist/signin.js.map +1 -0
  123. package/dist/start.d.ts +7 -6
  124. package/dist/start.js +14 -7
  125. package/dist/start.js.map +1 -1
  126. package/dist/tools/catalog.d.ts +44 -0
  127. package/dist/tools/catalog.js +105 -0
  128. package/dist/tools/catalog.js.map +1 -0
  129. package/dist/tools/causes.d.ts +6 -6
  130. package/dist/tools/causes.js +4 -5
  131. package/dist/tools/causes.js.map +1 -1
  132. package/dist/tools/context.js +5 -5
  133. package/dist/tools/context.js.map +1 -1
  134. package/dist/tools/datasources.js +1 -1
  135. package/dist/tools/datasources.js.map +1 -1
  136. package/dist/tools/diagnostics.js +2 -2
  137. package/dist/tools/diagnostics.js.map +1 -1
  138. package/dist/tools/figures.d.ts +3 -2
  139. package/dist/tools/figures.js +38 -13
  140. package/dist/tools/figures.js.map +1 -1
  141. package/dist/tools/findings.d.ts +28 -0
  142. package/dist/tools/findings.js +75 -12
  143. package/dist/tools/findings.js.map +1 -1
  144. package/dist/tools/incidents.js +5 -5
  145. package/dist/tools/incidents.js.map +1 -1
  146. package/dist/tools/index.d.ts +19 -2
  147. package/dist/tools/index.js +115 -14
  148. package/dist/tools/index.js.map +1 -1
  149. package/dist/tools/investigations.d.ts +54 -0
  150. package/dist/tools/investigations.js +369 -68
  151. package/dist/tools/investigations.js.map +1 -1
  152. package/dist/tools/next.d.ts +20 -0
  153. package/dist/tools/next.js +136 -0
  154. package/dist/tools/next.js.map +1 -0
  155. package/dist/tools/postmortem-runbooks.d.ts +52 -52
  156. package/dist/tools/postmortem-runbooks.js +3 -10
  157. package/dist/tools/postmortem-runbooks.js.map +1 -1
  158. package/dist/tools/resume.d.ts +5 -0
  159. package/dist/tools/resume.js +136 -0
  160. package/dist/tools/resume.js.map +1 -0
  161. package/dist/tools/signin.d.ts +12 -0
  162. package/dist/tools/signin.js +54 -0
  163. package/dist/tools/signin.js.map +1 -0
  164. package/dist/tools/source-links.js +5 -3
  165. package/dist/tools/source-links.js.map +1 -1
  166. package/dist/tools/timeline.js +57 -11
  167. package/dist/tools/timeline.js.map +1 -1
  168. package/dist/trace-record.d.ts +36 -0
  169. package/dist/trace-record.js +283 -0
  170. package/dist/trace-record.js.map +1 -0
  171. package/dist/version.d.ts +10 -2
  172. package/dist/version.js +20 -1
  173. package/dist/version.js.map +1 -1
  174. package/package.json +23 -3
  175. package/server.json +5 -5
  176. package/contracts/runbooks/v1/fixtures/global-runbook.json +0 -7
  177. package/contracts/runbooks/v1/runbook-definition.schema.json +0 -25
  178. package/dist/auth.d.ts +0 -7
  179. package/dist/auth.js +0 -19
  180. package/dist/auth.js.map +0 -1
@@ -0,0 +1,926 @@
1
+ {
2
+ "format": 1,
3
+ "about": "What Tellagen offers to a diagnosis client: capabilities, headers, error codes and the fields of each route a client calls. A test builds this file from the request and response types; refresh it with UPDATE_CLIENT_PROTOCOL=1 (see handlers/client_protocol_contract_test.go). The MCP server compares it with what it sends and relies on.",
4
+ "server_capabilities": [
5
+ "cause_lead_v1",
6
+ "client_heartbeat_v1",
7
+ "completion_repairs_v1",
8
+ "diagnosis_changes_v1",
9
+ "diagnosis_structure_v1",
10
+ "diff_lines_v1",
11
+ "figure_extras_v1",
12
+ "recorded_steps_v1",
13
+ "responder_notes_v1",
14
+ "run_images_v1"
15
+ ],
16
+ "protocol_capabilities": [
17
+ "cause_lead_v1",
18
+ "completion_coverage_v2",
19
+ "diagnosis_changes_v1",
20
+ "diagnosis_structure_v1",
21
+ "finding_roles_v2",
22
+ "gap_findings_v2",
23
+ "guidance_default_v1",
24
+ "responder_notes_v1",
25
+ "run_images_v1",
26
+ "runbook_plan_v2",
27
+ "strict_fields_v1",
28
+ "trace_check_id_v2"
29
+ ],
30
+ "client_headers": [
31
+ "X-Tellagen-Capabilities",
32
+ "X-Tellagen-Client",
33
+ "X-Tellagen-Client-Session",
34
+ "X-Tellagen-Client-Version",
35
+ "X-Tellagen-Computer",
36
+ "X-Tellagen-Server-Version"
37
+ ],
38
+ "error_codes": [
39
+ "client_upgrade_required",
40
+ "denied",
41
+ "expired",
42
+ "invalid_device_code",
43
+ "invalid_field_type",
44
+ "invalid_idempotency_key",
45
+ "investigation_completion_blocked",
46
+ "investigation_executor_conflict",
47
+ "investigation_run_ended",
48
+ "investigation_run_id_taken",
49
+ "pickup_client_context_mismatch",
50
+ "rate_limited",
51
+ "run_has_active_client",
52
+ "run_taken_over",
53
+ "too_many_waiting_requests",
54
+ "unknown_field"
55
+ ],
56
+ "routes": [
57
+ {
58
+ "method": "POST",
59
+ "path": "/api/v1/auth/device/start",
60
+ "request_fields": [
61
+ "client_name",
62
+ "client_version",
63
+ "computer_name",
64
+ "server_version"
65
+ ],
66
+ "response_fields": [
67
+ "device_code",
68
+ "expires_in",
69
+ "interval",
70
+ "user_code",
71
+ "verification_uri",
72
+ "verification_uri_complete"
73
+ ]
74
+ },
75
+ {
76
+ "method": "POST",
77
+ "path": "/api/v1/auth/device/token",
78
+ "request_fields": [
79
+ "device_code"
80
+ ],
81
+ "response_fields": [
82
+ "api_base_url",
83
+ "api_key",
84
+ "interval",
85
+ "key",
86
+ "key.company_id",
87
+ "key.created_at",
88
+ "key.created_by_email",
89
+ "key.created_by_name",
90
+ "key.created_by_user_id",
91
+ "key.description",
92
+ "key.expires_at",
93
+ "key.id",
94
+ "key.last_used_at",
95
+ "key.name",
96
+ "key.revoked_at",
97
+ "key.scopes",
98
+ "key.token_prefix",
99
+ "status",
100
+ "user",
101
+ "user.display_name",
102
+ "user.email",
103
+ "workspace",
104
+ "workspace.name",
105
+ "workspace.subdomain",
106
+ "workspace.url"
107
+ ]
108
+ },
109
+ {
110
+ "method": "GET",
111
+ "path": "/api/v1/auth/me",
112
+ "request_fields": [],
113
+ "response_fields": [
114
+ "demo",
115
+ "demo.can_share",
116
+ "demo.expires_at",
117
+ "demo.participant_count",
118
+ "demo.participant_id",
119
+ "demo.participant_limit",
120
+ "demo.participant_role",
121
+ "demo.reserved_guest_count",
122
+ "demo.server_now",
123
+ "demo_home_path",
124
+ "demo_mode",
125
+ "user",
126
+ "user.avatar_url",
127
+ "user.companies",
128
+ "user.company",
129
+ "user.company_onboarding_closed_at",
130
+ "user.created_at",
131
+ "user.display_name",
132
+ "user.email",
133
+ "user.has_password",
134
+ "user.id",
135
+ "user.last_company_id",
136
+ "user.permissions",
137
+ "user.role",
138
+ "user.seat_type",
139
+ "user.terms_accepted_at",
140
+ "user.terms_version",
141
+ "user.title",
142
+ "user.updated_at",
143
+ "user.view_preset"
144
+ ]
145
+ },
146
+ {
147
+ "method": "POST",
148
+ "path": "/api/v1/incidents/{id}/findings",
149
+ "request_fields": [
150
+ "claim",
151
+ "confidence",
152
+ "confidence_reason",
153
+ "evidence_refs",
154
+ "evidence_refs.added_by",
155
+ "evidence_refs.artifact_digest",
156
+ "evidence_refs.artifact_id",
157
+ "evidence_refs.captured_at",
158
+ "evidence_refs.command",
159
+ "evidence_refs.datasource",
160
+ "evidence_refs.evidence_fact_key",
161
+ "evidence_refs.links",
162
+ "evidence_refs.query",
163
+ "evidence_refs.result_bytes",
164
+ "evidence_refs.result_sample",
165
+ "evidence_refs.result_summary",
166
+ "evidence_refs.screenshots",
167
+ "evidence_refs.source",
168
+ "evidence_refs.source_url",
169
+ "evidence_refs.tool_use_id",
170
+ "evidence_refs.truncated",
171
+ "evidence_refs.url",
172
+ "evidence_refs.verified",
173
+ "evidence_summary",
174
+ "finding_type",
175
+ "idempotency_key",
176
+ "investigation_run_id",
177
+ "potential_root_cause",
178
+ "role",
179
+ "root_cause_status",
180
+ "screenshots",
181
+ "screenshots.base64",
182
+ "screenshots.caption",
183
+ "screenshots.media_type",
184
+ "screenshots.ref_index",
185
+ "screenshots.url"
186
+ ],
187
+ "response_fields": [
188
+ "finding",
189
+ "finding.claim",
190
+ "finding.confidence",
191
+ "finding.confidence_reason",
192
+ "finding.created_at",
193
+ "finding.created_by",
194
+ "finding.dismissal_reason",
195
+ "finding.evidence_refs",
196
+ "finding.evidence_summary",
197
+ "finding.finding_type",
198
+ "finding.id",
199
+ "finding.incident_id",
200
+ "finding.investigation_run_id",
201
+ "finding.potential_root_cause",
202
+ "finding.promoted_timeline_event_id",
203
+ "finding.question_resolution",
204
+ "finding.role",
205
+ "finding.root_cause_rejection_reason",
206
+ "finding.root_cause_status",
207
+ "finding.screenshots",
208
+ "finding.status",
209
+ "responder_notes",
210
+ "responder_notes.author_name",
211
+ "responder_notes.created_at",
212
+ "responder_notes.id",
213
+ "responder_notes.origin",
214
+ "responder_notes.text",
215
+ "run_state"
216
+ ]
217
+ },
218
+ {
219
+ "method": "POST",
220
+ "path": "/api/v1/incidents/{id}/investigations",
221
+ "request_fields": [
222
+ "agent_name",
223
+ "attachment_ids",
224
+ "context_links",
225
+ "context_links.kind",
226
+ "context_links.url",
227
+ "corrects_run_id",
228
+ "data_sources",
229
+ "evidence_budget_preset",
230
+ "execution_mode",
231
+ "executor",
232
+ "id",
233
+ "model_used",
234
+ "proxy_id",
235
+ "question",
236
+ "question_finding_id",
237
+ "without_grafana"
238
+ ],
239
+ "response_fields": [
240
+ "coverage",
241
+ "coverage.accounted_check_count",
242
+ "coverage.blocked_source_ids",
243
+ "coverage.checks",
244
+ "coverage.completed_check_ids",
245
+ "coverage.completion_allowed",
246
+ "coverage.decision",
247
+ "coverage.failed_check_ids",
248
+ "coverage.gapped_check_ids",
249
+ "coverage.missing_check_ids",
250
+ "coverage.missing_evidence_ids",
251
+ "coverage.mitigation_state",
252
+ "coverage.mode",
253
+ "coverage.not_applicable_check_ids",
254
+ "coverage.required_check_count",
255
+ "coverage.requirements_satisfied",
256
+ "coverage.result_outcome",
257
+ "coverage.skipped_check_ids",
258
+ "coverage.waived_check_ids",
259
+ "coverage.warnings",
260
+ "pickup",
261
+ "pickup.attachments",
262
+ "pickup.context_links",
263
+ "pickup.incident_human_id",
264
+ "pickup.incident_id",
265
+ "pickup.investigation_run_id",
266
+ "pickup.mcp_server_name",
267
+ "pickup.parent",
268
+ "run",
269
+ "run.agent_name",
270
+ "run.attachments",
271
+ "run.cause_lead",
272
+ "run.client",
273
+ "run.client_state",
274
+ "run.completed_at",
275
+ "run.context_links",
276
+ "run.corrects_run_id",
277
+ "run.created_by",
278
+ "run.data_sources",
279
+ "run.evidence_budget_preset",
280
+ "run.executor",
281
+ "run.failure_reason",
282
+ "run.finding_count",
283
+ "run.id",
284
+ "run.incident_id",
285
+ "run.listener",
286
+ "run.model_used",
287
+ "run.pickup_refusal",
288
+ "run.proxy_id",
289
+ "run.proxy_name",
290
+ "run.question",
291
+ "run.question_finding_id",
292
+ "run.result_summary",
293
+ "run.started_at",
294
+ "run.status"
295
+ ]
296
+ },
297
+ {
298
+ "method": "PUT",
299
+ "path": "/api/v1/investigation-runs/{id}/causes/{key}",
300
+ "request_fields": [
301
+ "evidence_against",
302
+ "evidence_for",
303
+ "finding_ids",
304
+ "label",
305
+ "rationale",
306
+ "sources",
307
+ "state"
308
+ ],
309
+ "response_fields": [
310
+ "cause",
311
+ "cause.created_at",
312
+ "cause.evidence_against",
313
+ "cause.evidence_for",
314
+ "cause.finding_ids",
315
+ "cause.investigation_run_id",
316
+ "cause.key",
317
+ "cause.label",
318
+ "cause.rationale",
319
+ "cause.sort_order",
320
+ "cause.sources",
321
+ "cause.state",
322
+ "cause.updated_at",
323
+ "responder_notes",
324
+ "responder_notes.author_name",
325
+ "responder_notes.created_at",
326
+ "responder_notes.id",
327
+ "responder_notes.origin",
328
+ "responder_notes.text",
329
+ "run_state"
330
+ ]
331
+ },
332
+ {
333
+ "method": "POST",
334
+ "path": "/api/v1/investigation-runs/{id}/check-attempts",
335
+ "request_fields": [
336
+ "artifact_digest",
337
+ "artifact_id",
338
+ "attempt_number",
339
+ "check_id",
340
+ "completed_at",
341
+ "duration_ms",
342
+ "error",
343
+ "error_code",
344
+ "gap_finding_id",
345
+ "input_json",
346
+ "mcp_server_version",
347
+ "proposed_outcome",
348
+ "result_bytes",
349
+ "result_json",
350
+ "result_summary",
351
+ "reuse_hint",
352
+ "reuse_hint.diagnostic_intent",
353
+ "reuse_hint.observed_outcome",
354
+ "reuse_hint.parameter_names",
355
+ "reuse_hint.trigger_summary",
356
+ "runbook_id",
357
+ "runbook_version",
358
+ "source_resolution_id",
359
+ "started_at",
360
+ "status",
361
+ "step_id",
362
+ "step_index",
363
+ "target_reference",
364
+ "title",
365
+ "tool_name",
366
+ "tool_use_id",
367
+ "truncated"
368
+ ],
369
+ "response_fields": [
370
+ "attempt",
371
+ "attempt.attempt_number",
372
+ "attempt.check_id",
373
+ "attempt.completed_at",
374
+ "attempt.created_at",
375
+ "attempt.error_code",
376
+ "attempt.error_message",
377
+ "attempt.execution_provenance",
378
+ "attempt.final_outcome",
379
+ "attempt.gap_finding_id",
380
+ "attempt.investigation_run_id",
381
+ "attempt.mcp_server_version",
382
+ "attempt.proposed_outcome",
383
+ "attempt.runbook_id",
384
+ "attempt.runbook_version",
385
+ "attempt.source_resolution_id",
386
+ "attempt.started_at",
387
+ "attempt.target_reference",
388
+ "attempt.trace_status",
389
+ "attempt.trace_step_id",
390
+ "execution",
391
+ "execution.branch_state",
392
+ "execution.check_id",
393
+ "execution.gap_finding_id",
394
+ "execution.investigation_run_id",
395
+ "execution.outcome",
396
+ "execution.runbook_id",
397
+ "execution.runbook_version",
398
+ "execution.source_resolution_id",
399
+ "execution.started_at",
400
+ "execution.terminal_at",
401
+ "execution.updated_at",
402
+ "execution.waiver_id",
403
+ "responder_notes",
404
+ "responder_notes.author_name",
405
+ "responder_notes.created_at",
406
+ "responder_notes.id",
407
+ "responder_notes.origin",
408
+ "responder_notes.text",
409
+ "run_state",
410
+ "trace",
411
+ "trace.artifact_digest",
412
+ "trace.artifact_id",
413
+ "trace.cause_key",
414
+ "trace.check_attempt_number",
415
+ "trace.check_id",
416
+ "trace.completed_at",
417
+ "trace.duration_ms",
418
+ "trace.error",
419
+ "trace.evidence_fact_key",
420
+ "trace.execution_provenance",
421
+ "trace.guidance",
422
+ "trace.input_json",
423
+ "trace.investigation_run_id",
424
+ "trace.mcp_server_version",
425
+ "trace.outcome",
426
+ "trace.recorded_by",
427
+ "trace.result_bytes",
428
+ "trace.result_json",
429
+ "trace.result_summary",
430
+ "trace.reuse_hint",
431
+ "trace.runbook_id",
432
+ "trace.runbook_version",
433
+ "trace.source_resolution_id",
434
+ "trace.started_at",
435
+ "trace.status",
436
+ "trace.step_id",
437
+ "trace.step_index",
438
+ "trace.target_reference",
439
+ "trace.title",
440
+ "trace.tool_name",
441
+ "trace.tool_use_id",
442
+ "trace.truncated"
443
+ ]
444
+ },
445
+ {
446
+ "method": "POST",
447
+ "path": "/api/v1/investigation-runs/{id}/heartbeat",
448
+ "request_fields": [
449
+ "session_id"
450
+ ],
451
+ "response_fields": [
452
+ "client_state",
453
+ "client_state.client_name",
454
+ "client_state.computer_name",
455
+ "client_state.connected_until",
456
+ "client_state.heartbeats",
457
+ "client_state.holder_name",
458
+ "client_state.last_contact_at",
459
+ "client_state.reads_notes",
460
+ "client_state.state",
461
+ "client_state.taken_over_at",
462
+ "client_state.taken_over_from",
463
+ "responder_notes",
464
+ "responder_notes.author_name",
465
+ "responder_notes.created_at",
466
+ "responder_notes.id",
467
+ "responder_notes.origin",
468
+ "responder_notes.text",
469
+ "run_state"
470
+ ]
471
+ },
472
+ {
473
+ "method": "POST",
474
+ "path": "/api/v1/investigation-runs/{id}/trace",
475
+ "request_fields": [
476
+ "artifact_digest",
477
+ "artifact_id",
478
+ "cause_key",
479
+ "completed_at",
480
+ "duration_ms",
481
+ "error",
482
+ "guidance",
483
+ "guidance.origin",
484
+ "guidance.reason",
485
+ "guidance.refs",
486
+ "input_json",
487
+ "outcome",
488
+ "recorded_by",
489
+ "result_bytes",
490
+ "result_json",
491
+ "result_summary",
492
+ "reuse_hint",
493
+ "reuse_hint.diagnostic_intent",
494
+ "reuse_hint.observed_outcome",
495
+ "reuse_hint.parameter_names",
496
+ "reuse_hint.trigger_summary",
497
+ "started_at",
498
+ "status",
499
+ "step_id",
500
+ "step_index",
501
+ "title",
502
+ "tool_name",
503
+ "tool_use_id",
504
+ "truncated"
505
+ ],
506
+ "response_fields": [
507
+ "note",
508
+ "note.code",
509
+ "note.limit",
510
+ "note.message",
511
+ "responder_notes",
512
+ "responder_notes.author_name",
513
+ "responder_notes.created_at",
514
+ "responder_notes.id",
515
+ "responder_notes.origin",
516
+ "responder_notes.text",
517
+ "run_state",
518
+ "steps",
519
+ "steps.artifact_digest",
520
+ "steps.artifact_id",
521
+ "steps.cause_key",
522
+ "steps.check_attempt_number",
523
+ "steps.check_id",
524
+ "steps.completed_at",
525
+ "steps.duration_ms",
526
+ "steps.error",
527
+ "steps.evidence_fact_key",
528
+ "steps.execution_provenance",
529
+ "steps.guidance",
530
+ "steps.input_json",
531
+ "steps.investigation_run_id",
532
+ "steps.mcp_server_version",
533
+ "steps.outcome",
534
+ "steps.recorded_by",
535
+ "steps.result_bytes",
536
+ "steps.result_json",
537
+ "steps.result_summary",
538
+ "steps.reuse_hint",
539
+ "steps.runbook_id",
540
+ "steps.runbook_version",
541
+ "steps.source_resolution_id",
542
+ "steps.started_at",
543
+ "steps.status",
544
+ "steps.step_id",
545
+ "steps.step_index",
546
+ "steps.target_reference",
547
+ "steps.title",
548
+ "steps.tool_name",
549
+ "steps.tool_use_id",
550
+ "steps.truncated"
551
+ ]
552
+ },
553
+ {
554
+ "method": "GET",
555
+ "path": "/api/v1/investigations",
556
+ "query": [
557
+ "listener_reason",
558
+ "listener_run",
559
+ "listening",
560
+ "requested_by",
561
+ "status",
562
+ "wait"
563
+ ],
564
+ "request_fields": [],
565
+ "response_fields": [
566
+ "listener",
567
+ "listener.computer_name",
568
+ "listener.take_runs_automatically",
569
+ "runs",
570
+ "runs.corrects_run_id",
571
+ "runs.follow_up",
572
+ "runs.incident_human_id",
573
+ "runs.incident_id",
574
+ "runs.incident_title",
575
+ "runs.link_count",
576
+ "runs.question",
577
+ "runs.requested_at",
578
+ "runs.requested_by",
579
+ "runs.requested_by_me",
580
+ "runs.run_id",
581
+ "runs.screenshot_count"
582
+ ]
583
+ },
584
+ {
585
+ "method": "PATCH",
586
+ "path": "/api/v1/investigations/{id}",
587
+ "request_fields": [
588
+ "dry_run",
589
+ "failure_reason",
590
+ "mitigation_state",
591
+ "result_summary",
592
+ "result_summary.assessment",
593
+ "result_summary.causal_paths",
594
+ "result_summary.change_refs",
595
+ "result_summary.conclusion",
596
+ "result_summary.confidence_percent",
597
+ "result_summary.coverage",
598
+ "result_summary.customer_impact",
599
+ "result_summary.headline",
600
+ "result_summary.impact",
601
+ "result_summary.likely_cause_label",
602
+ "result_summary.outcome_state",
603
+ "result_summary.quality_warnings",
604
+ "result_summary.question_verification",
605
+ "result_summary.recommended_actions",
606
+ "result_summary.ruled_out",
607
+ "result_summary.signals_checked",
608
+ "result_summary.takeaways",
609
+ "result_summary.unknowns",
610
+ "status"
611
+ ],
612
+ "response_fields": [
613
+ "coverage",
614
+ "coverage.accounted_check_count",
615
+ "coverage.blocked_source_ids",
616
+ "coverage.checks",
617
+ "coverage.completed_check_ids",
618
+ "coverage.completion_allowed",
619
+ "coverage.decision",
620
+ "coverage.failed_check_ids",
621
+ "coverage.gapped_check_ids",
622
+ "coverage.missing_check_ids",
623
+ "coverage.missing_evidence_ids",
624
+ "coverage.mitigation_state",
625
+ "coverage.mode",
626
+ "coverage.not_applicable_check_ids",
627
+ "coverage.required_check_count",
628
+ "coverage.requirements_satisfied",
629
+ "coverage.result_outcome",
630
+ "coverage.skipped_check_ids",
631
+ "coverage.waived_check_ids",
632
+ "coverage.warnings",
633
+ "dry_run",
634
+ "pickup",
635
+ "pickup.attachments",
636
+ "pickup.context_links",
637
+ "pickup.incident_human_id",
638
+ "pickup.incident_id",
639
+ "pickup.investigation_run_id",
640
+ "pickup.mcp_server_name",
641
+ "pickup.parent",
642
+ "ready",
643
+ "repairs",
644
+ "repairs.code",
645
+ "repairs.example",
646
+ "repairs.field",
647
+ "repairs.missing",
648
+ "responder_notes",
649
+ "responder_notes.author_name",
650
+ "responder_notes.created_at",
651
+ "responder_notes.id",
652
+ "responder_notes.origin",
653
+ "responder_notes.text",
654
+ "run",
655
+ "run.agent_name",
656
+ "run.attachments",
657
+ "run.cause_lead",
658
+ "run.client",
659
+ "run.client_state",
660
+ "run.completed_at",
661
+ "run.context_links",
662
+ "run.corrects_run_id",
663
+ "run.created_by",
664
+ "run.data_sources",
665
+ "run.evidence_budget_preset",
666
+ "run.executor",
667
+ "run.failure_reason",
668
+ "run.finding_count",
669
+ "run.id",
670
+ "run.incident_id",
671
+ "run.listener",
672
+ "run.model_used",
673
+ "run.pickup_refusal",
674
+ "run.proxy_id",
675
+ "run.proxy_name",
676
+ "run.question",
677
+ "run.question_finding_id",
678
+ "run.result_summary",
679
+ "run.started_at",
680
+ "run.status",
681
+ "run_state",
682
+ "warnings",
683
+ "warnings.code",
684
+ "warnings.message",
685
+ "warnings.path"
686
+ ]
687
+ },
688
+ {
689
+ "method": "GET",
690
+ "path": "/api/v1/investigations/{id}/context",
691
+ "request_fields": [],
692
+ "response_fields": [
693
+ "client_update_available",
694
+ "client_update_available.current_version",
695
+ "client_update_available.message",
696
+ "client_update_available.your_version",
697
+ "ignored_sources",
698
+ "incident",
699
+ "incident.archived_at",
700
+ "incident.archived_by",
701
+ "incident.company_id",
702
+ "incident.created_at",
703
+ "incident.created_by",
704
+ "incident.custom_fields",
705
+ "incident.customer_impact_status",
706
+ "incident.doc_url",
707
+ "incident.duration_anchor",
708
+ "incident.duration_seconds",
709
+ "incident.event_count",
710
+ "incident.first_reported_at",
711
+ "incident.first_responded_at",
712
+ "incident.has_assignees",
713
+ "incident.human_id",
714
+ "incident.id",
715
+ "incident.impact_started_at",
716
+ "incident.impact_summary",
717
+ "incident.incident_manager",
718
+ "incident.incident_responders",
719
+ "incident.investigation_summary",
720
+ "incident.issue_type",
721
+ "incident.last_event_at",
722
+ "incident.last_event_summary",
723
+ "incident.meet_url",
724
+ "incident.postmortem_summary",
725
+ "incident.recovered_at",
726
+ "incident.regions",
727
+ "incident.revision",
728
+ "incident.service",
729
+ "incident.severity",
730
+ "incident.severity_mode",
731
+ "incident.slack_channel_id",
732
+ "incident.status",
733
+ "incident.status_changed_at",
734
+ "incident.status_update_summary",
735
+ "incident.team_id",
736
+ "incident.title",
737
+ "pickup",
738
+ "pickup.attachments",
739
+ "pickup.context_links",
740
+ "pickup.incident_human_id",
741
+ "pickup.incident_id",
742
+ "pickup.investigation_run_id",
743
+ "pickup.mcp_server_name",
744
+ "pickup.parent",
745
+ "request",
746
+ "request.attribution_policy",
747
+ "request.company_id",
748
+ "request.connectors",
749
+ "request.context",
750
+ "request.coverage_mode",
751
+ "request.effort",
752
+ "request.evidence_budget",
753
+ "request.investigation_id",
754
+ "request.negotiation",
755
+ "request.protocol_version",
756
+ "request.schema_version",
757
+ "request.selection_summary",
758
+ "request.skills",
759
+ "request.source_resolutions",
760
+ "request.subject_id",
761
+ "request.subject_type",
762
+ "request.timeout_seconds",
763
+ "run",
764
+ "run.agent_name",
765
+ "run.attachments",
766
+ "run.cause_lead",
767
+ "run.client",
768
+ "run.client_state",
769
+ "run.completed_at",
770
+ "run.context_links",
771
+ "run.corrects_run_id",
772
+ "run.created_by",
773
+ "run.data_sources",
774
+ "run.evidence_budget_preset",
775
+ "run.executor",
776
+ "run.failure_reason",
777
+ "run.finding_count",
778
+ "run.id",
779
+ "run.incident_id",
780
+ "run.listener",
781
+ "run.model_used",
782
+ "run.pickup_refusal",
783
+ "run.proxy_id",
784
+ "run.proxy_name",
785
+ "run.question",
786
+ "run.question_finding_id",
787
+ "run.result_summary",
788
+ "run.started_at",
789
+ "run.status",
790
+ "server_capabilities",
791
+ "source_bases",
792
+ "source_bases.base_url",
793
+ "source_bases.kind",
794
+ "source_bases.name",
795
+ "source_bases.network",
796
+ "source_bases.repositories"
797
+ ]
798
+ },
799
+ {
800
+ "method": "POST",
801
+ "path": "/api/v1/investigations/{id}/pickup",
802
+ "request_fields": [
803
+ "available_sources",
804
+ "available_sources.detail",
805
+ "available_sources.key",
806
+ "available_sources.state",
807
+ "client",
808
+ "client.computer",
809
+ "client.mcp_server_version",
810
+ "client.name",
811
+ "client.profile_id",
812
+ "client.session_id",
813
+ "client.version",
814
+ "model",
815
+ "protocol_capabilities",
816
+ "takeover"
817
+ ],
818
+ "response_fields": [
819
+ "client_update_available",
820
+ "client_update_available.current_version",
821
+ "client_update_available.message",
822
+ "client_update_available.your_version",
823
+ "ignored_sources",
824
+ "incident",
825
+ "incident.archived_at",
826
+ "incident.archived_by",
827
+ "incident.company_id",
828
+ "incident.created_at",
829
+ "incident.created_by",
830
+ "incident.custom_fields",
831
+ "incident.customer_impact_status",
832
+ "incident.doc_url",
833
+ "incident.duration_anchor",
834
+ "incident.duration_seconds",
835
+ "incident.event_count",
836
+ "incident.first_reported_at",
837
+ "incident.first_responded_at",
838
+ "incident.has_assignees",
839
+ "incident.human_id",
840
+ "incident.id",
841
+ "incident.impact_started_at",
842
+ "incident.impact_summary",
843
+ "incident.incident_manager",
844
+ "incident.incident_responders",
845
+ "incident.investigation_summary",
846
+ "incident.issue_type",
847
+ "incident.last_event_at",
848
+ "incident.last_event_summary",
849
+ "incident.meet_url",
850
+ "incident.postmortem_summary",
851
+ "incident.recovered_at",
852
+ "incident.regions",
853
+ "incident.revision",
854
+ "incident.service",
855
+ "incident.severity",
856
+ "incident.severity_mode",
857
+ "incident.slack_channel_id",
858
+ "incident.status",
859
+ "incident.status_changed_at",
860
+ "incident.status_update_summary",
861
+ "incident.team_id",
862
+ "incident.title",
863
+ "pickup",
864
+ "pickup.attachments",
865
+ "pickup.context_links",
866
+ "pickup.incident_human_id",
867
+ "pickup.incident_id",
868
+ "pickup.investigation_run_id",
869
+ "pickup.mcp_server_name",
870
+ "pickup.parent",
871
+ "request",
872
+ "request.attribution_policy",
873
+ "request.company_id",
874
+ "request.connectors",
875
+ "request.context",
876
+ "request.coverage_mode",
877
+ "request.effort",
878
+ "request.evidence_budget",
879
+ "request.investigation_id",
880
+ "request.negotiation",
881
+ "request.protocol_version",
882
+ "request.schema_version",
883
+ "request.selection_summary",
884
+ "request.skills",
885
+ "request.source_resolutions",
886
+ "request.subject_id",
887
+ "request.subject_type",
888
+ "request.timeout_seconds",
889
+ "run",
890
+ "run.agent_name",
891
+ "run.attachments",
892
+ "run.cause_lead",
893
+ "run.client",
894
+ "run.client_state",
895
+ "run.completed_at",
896
+ "run.context_links",
897
+ "run.corrects_run_id",
898
+ "run.created_by",
899
+ "run.data_sources",
900
+ "run.evidence_budget_preset",
901
+ "run.executor",
902
+ "run.failure_reason",
903
+ "run.finding_count",
904
+ "run.id",
905
+ "run.incident_id",
906
+ "run.listener",
907
+ "run.model_used",
908
+ "run.pickup_refusal",
909
+ "run.proxy_id",
910
+ "run.proxy_name",
911
+ "run.question",
912
+ "run.question_finding_id",
913
+ "run.result_summary",
914
+ "run.started_at",
915
+ "run.status",
916
+ "server_capabilities",
917
+ "source_bases",
918
+ "source_bases.base_url",
919
+ "source_bases.kind",
920
+ "source_bases.name",
921
+ "source_bases.network",
922
+ "source_bases.repositories"
923
+ ]
924
+ }
925
+ ]
926
+ }