kaiten-cli 0.3.3__py3-none-any.whl

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 (99) hide show
  1. kaiten_cli/__init__.py +5 -0
  2. kaiten_cli/__main__.py +9 -0
  3. kaiten_cli/agent_gateway.py +577 -0
  4. kaiten_cli/app.py +1636 -0
  5. kaiten_cli/completion.py +570 -0
  6. kaiten_cli/discovery.py +39 -0
  7. kaiten_cli/errors.py +79 -0
  8. kaiten_cli/i18n.py +92 -0
  9. kaiten_cli/locales/ru.json +2967 -0
  10. kaiten_cli/localized_click.py +160 -0
  11. kaiten_cli/models.py +202 -0
  12. kaiten_cli/profiles.py +316 -0
  13. kaiten_cli/registry/__init__.py +260 -0
  14. kaiten_cli/registry/addons.py +392 -0
  15. kaiten_cli/registry/audit_and_analytics.py +451 -0
  16. kaiten_cli/registry/automation_schema.py +44 -0
  17. kaiten_cli/registry/automation_schemas.json +7417 -0
  18. kaiten_cli/registry/automations.py +342 -0
  19. kaiten_cli/registry/base.py +62 -0
  20. kaiten_cli/registry/blockers.py +320 -0
  21. kaiten_cli/registry/boards.py +520 -0
  22. kaiten_cli/registry/card_relations.py +376 -0
  23. kaiten_cli/registry/card_types.py +363 -0
  24. kaiten_cli/registry/cards.py +1329 -0
  25. kaiten_cli/registry/charts.py +539 -0
  26. kaiten_cli/registry/checklists.py +600 -0
  27. kaiten_cli/registry/columns.py +558 -0
  28. kaiten_cli/registry/comments.py +224 -0
  29. kaiten_cli/registry/custom_directories.py +980 -0
  30. kaiten_cli/registry/custom_properties.py +1460 -0
  31. kaiten_cli/registry/dashboards.py +564 -0
  32. kaiten_cli/registry/documents.py +761 -0
  33. kaiten_cli/registry/external_links.py +128 -0
  34. kaiten_cli/registry/files.py +738 -0
  35. kaiten_cli/registry/github_addon.py +613 -0
  36. kaiten_cli/registry/iterations.py +397 -0
  37. kaiten_cli/registry/lanes.py +205 -0
  38. kaiten_cli/registry/live_contracts.py +361 -0
  39. kaiten_cli/registry/members.py +336 -0
  40. kaiten_cli/registry/module_docs.py +108 -0
  41. kaiten_cli/registry/projects.py +369 -0
  42. kaiten_cli/registry/query.py +129 -0
  43. kaiten_cli/registry/restrictions.py +249 -0
  44. kaiten_cli/registry/roles_and_groups.py +1102 -0
  45. kaiten_cli/registry/scim.py +263 -0
  46. kaiten_cli/registry/service_desk.py +1270 -0
  47. kaiten_cli/registry/snapshot.py +187 -0
  48. kaiten_cli/registry/spaces.py +272 -0
  49. kaiten_cli/registry/subscribers.py +168 -0
  50. kaiten_cli/registry/tags.py +193 -0
  51. kaiten_cli/registry/time_logs.py +353 -0
  52. kaiten_cli/registry/tree.py +352 -0
  53. kaiten_cli/registry/utilities.py +287 -0
  54. kaiten_cli/registry/webhooks.py +265 -0
  55. kaiten_cli/runtime/__init__.py +1 -0
  56. kaiten_cli/runtime/automation_validation.py +115 -0
  57. kaiten_cli/runtime/behaviors.py +787 -0
  58. kaiten_cli/runtime/cache.py +733 -0
  59. kaiten_cli/runtime/client.py +387 -0
  60. kaiten_cli/runtime/endpoints.py +59 -0
  61. kaiten_cli/runtime/executor.py +269 -0
  62. kaiten_cli/runtime/fs_security.py +168 -0
  63. kaiten_cli/runtime/input.py +310 -0
  64. kaiten_cli/runtime/output.py +59 -0
  65. kaiten_cli/runtime/public_validation.py +35 -0
  66. kaiten_cli/runtime/snapshot_build.py +527 -0
  67. kaiten_cli/runtime/snapshot_common.py +363 -0
  68. kaiten_cli/runtime/snapshot_query.py +306 -0
  69. kaiten_cli/runtime/snapshot_store.py +1192 -0
  70. kaiten_cli/runtime/snapshots.py +62 -0
  71. kaiten_cli/runtime/sqlite_errors.py +23 -0
  72. kaiten_cli/runtime/support/__init__.py +1 -0
  73. kaiten_cli/runtime/support/addons.py +953 -0
  74. kaiten_cli/runtime/support/audit.py +70 -0
  75. kaiten_cli/runtime/support/batch.py +234 -0
  76. kaiten_cli/runtime/support/card_move_url.py +213 -0
  77. kaiten_cli/runtime/support/cards.py +174 -0
  78. kaiten_cli/runtime/support/checklists.py +21 -0
  79. kaiten_cli/runtime/support/company_users.py +117 -0
  80. kaiten_cli/runtime/support/dashboards.py +35 -0
  81. kaiten_cli/runtime/support/documents.py +175 -0
  82. kaiten_cli/runtime/support/files.py +561 -0
  83. kaiten_cli/runtime/support/markdown_export.py +525 -0
  84. kaiten_cli/runtime/support/pagination.py +167 -0
  85. kaiten_cli/runtime/support/projects.py +66 -0
  86. kaiten_cli/runtime/support/relations.py +86 -0
  87. kaiten_cli/runtime/support/restrictions.py +62 -0
  88. kaiten_cli/runtime/support/spaces.py +20 -0
  89. kaiten_cli/runtime/support/time_logs.py +61 -0
  90. kaiten_cli/runtime/support/tree.py +140 -0
  91. kaiten_cli/runtime/support/tree_sharing.py +447 -0
  92. kaiten_cli/runtime/trace.py +500 -0
  93. kaiten_cli/runtime/transforms.py +128 -0
  94. kaiten_cli/schema_docs.py +22 -0
  95. kaiten_cli/update_check.py +519 -0
  96. kaiten_cli-0.3.3.dist-info/METADATA +1110 -0
  97. kaiten_cli-0.3.3.dist-info/RECORD +99 -0
  98. kaiten_cli-0.3.3.dist-info/WHEEL +4 -0
  99. kaiten_cli-0.3.3.dist-info/entry_points.txt +3 -0
@@ -0,0 +1,539 @@
1
+ """Chart and compute-job tool specs."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from kaiten_cli.models import ExampleSpec, OperationSpec, ResponsePolicy, RuntimeBehavior
6
+ from kaiten_cli.registry.base import make_tool
7
+
8
+ _HEAVY = ResponsePolicy(heavy=True)
9
+ _READ_ONLY_ANALYTICS = RuntimeBehavior(
10
+ enforce_mutation_guard=False,
11
+ remote_side_effects=False,
12
+ )
13
+ _CHART_USAGE_NOTES = (
14
+ "Some tenants return 404 or feature-unavailable responses for chart endpoints even when the CLI surface is present.",
15
+ "If chart endpoints are unavailable, fall back to cards.list-all, space-activity-all.get, or card-location-history.batch-get instead of probing more chart variants.",
16
+ )
17
+ _POST_READ_USAGE_NOTES = _CHART_USAGE_NOTES + (
18
+ "This is a read-only analytics request even though the Kaiten API uses POST to submit filters.",
19
+ )
20
+ _CHART_BUILD_USAGE_NOTES = _CHART_USAGE_NOTES + (
21
+ "This request can create a transient compute job, so global read-only mode blocks it.",
22
+ )
23
+
24
+ _COMMON_CHART_PROPS = {
25
+ "space_id": {"type": "integer", "description": "Space ID"},
26
+ "date_from": {"type": "string", "description": "Start date (ISO 8601)"},
27
+ "date_to": {"type": "string", "description": "End date (ISO 8601)"},
28
+ "tags": {
29
+ "type": "array",
30
+ "items": {"type": "integer"},
31
+ "description": "Filter by tag IDs",
32
+ },
33
+ "only_asap_cards": {"type": "boolean", "description": "Include only ASAP (expedite) cards"},
34
+ "card_types": {
35
+ "type": "array",
36
+ "items": {"type": "integer"},
37
+ "description": "Filter by card type IDs",
38
+ },
39
+ "group_by": {"type": "string", "description": "Grouping mode"},
40
+ }
41
+
42
+ _CONTROL_EXTRA_PROPS = {
43
+ "start_columns": {
44
+ "type": "array",
45
+ "items": {"type": "integer"},
46
+ "description": "Start column IDs (required)",
47
+ },
48
+ "end_columns": {
49
+ "type": "array",
50
+ "items": {"type": "integer"},
51
+ "description": "End column IDs (required)",
52
+ },
53
+ "start_column_lanes": {
54
+ "type": "object",
55
+ "description": 'Mapping of start column ID to array of lane IDs, e.g. {"10": [1, 2]}',
56
+ },
57
+ "end_column_lanes": {
58
+ "type": "object",
59
+ "description": 'Mapping of end column ID to array of lane IDs, e.g. {"20": [3, 4]}',
60
+ },
61
+ }
62
+
63
+ _CONTROL_EXTRA_KEYS = (
64
+ "start_columns",
65
+ "end_columns",
66
+ "start_column_lanes",
67
+ "end_column_lanes",
68
+ )
69
+
70
+
71
+ def _chart_create(
72
+ *,
73
+ canonical_name: str,
74
+ mcp_alias: str,
75
+ description: str,
76
+ path_template: str,
77
+ properties: dict,
78
+ required: tuple[str, ...],
79
+ body_fields: tuple[str, ...],
80
+ ) -> tuple:
81
+ return (
82
+ make_tool(
83
+ canonical_name=canonical_name,
84
+ mcp_alias=mcp_alias,
85
+ description=description,
86
+ input_schema={"type": "object", "properties": properties, "required": list(required)},
87
+ operation=OperationSpec(
88
+ method="POST", path_template=path_template, body_fields=body_fields
89
+ ),
90
+ response_policy=_HEAVY,
91
+ examples=(
92
+ ExampleSpec(
93
+ command=f"kaiten --json {' '.join(canonical_name.split('.'))}",
94
+ description=description,
95
+ ),
96
+ ),
97
+ usage_notes=_CHART_BUILD_USAGE_NOTES,
98
+ ),
99
+ )
100
+
101
+
102
+ TOOLS = (
103
+ make_tool(
104
+ canonical_name="charts.boards.get",
105
+ mcp_alias="kaiten_get_chart_boards",
106
+ description="Get board structure for chart configuration in a space.",
107
+ input_schema={
108
+ "type": "object",
109
+ "properties": {"space_id": {"type": "integer", "description": "Space ID"}},
110
+ "required": ["space_id"],
111
+ },
112
+ operation=OperationSpec(
113
+ method="GET", path_template="/charts/{space_id}/boards", path_fields=("space_id",)
114
+ ),
115
+ examples=(
116
+ ExampleSpec(
117
+ command="kaiten --json charts boards get --space-id 1",
118
+ description="Get chart board structure.",
119
+ ),
120
+ ),
121
+ ),
122
+ make_tool(
123
+ canonical_name="charts.summary.get",
124
+ mcp_alias="kaiten_chart_summary",
125
+ description="Get done-card summary for a space within a date range.",
126
+ input_schema={
127
+ "type": "object",
128
+ "properties": {
129
+ "space_id": {"type": "integer", "description": "Space ID"},
130
+ "date_from": {"type": "string", "description": "Start date (ISO 8601)"},
131
+ "date_to": {"type": "string", "description": "End date (ISO 8601)"},
132
+ "done_columns": {
133
+ "type": "array",
134
+ "items": {"type": "integer"},
135
+ "description": "Array of done column IDs",
136
+ },
137
+ },
138
+ "required": ["space_id", "date_from", "date_to", "done_columns"],
139
+ },
140
+ operation=OperationSpec(
141
+ method="POST",
142
+ path_template="/charts/summary",
143
+ body_fields=("space_id", "date_from", "date_to", "done_columns"),
144
+ ),
145
+ response_policy=_HEAVY,
146
+ runtime_behavior=_READ_ONLY_ANALYTICS,
147
+ examples=(
148
+ ExampleSpec(
149
+ command="kaiten --json charts summary get --space-id 1 --date-from 2026-01-01 --date-to 2026-01-31 --done-columns '[10,11]'",
150
+ description="Get a done-card summary.",
151
+ ),
152
+ ),
153
+ usage_notes=_POST_READ_USAGE_NOTES,
154
+ ),
155
+ make_tool(
156
+ canonical_name="charts.block-resolution.get",
157
+ mcp_alias="kaiten_chart_block_resolution",
158
+ description="Get blocker resolution time data for a space.",
159
+ input_schema={
160
+ "type": "object",
161
+ "properties": {
162
+ "space_id": {"type": "integer", "description": "Space ID"},
163
+ "category_ids": {
164
+ "type": "array",
165
+ "items": {"type": "integer"},
166
+ "description": "Filter by blocker category IDs",
167
+ },
168
+ },
169
+ "required": ["space_id"],
170
+ },
171
+ operation=OperationSpec(
172
+ method="POST",
173
+ path_template="/charts/block-resolution-time-chart",
174
+ body_fields=("space_id", "category_ids"),
175
+ ),
176
+ response_policy=_HEAVY,
177
+ runtime_behavior=_READ_ONLY_ANALYTICS,
178
+ examples=(
179
+ ExampleSpec(
180
+ command="kaiten --json charts block-resolution get --space-id 1",
181
+ description="Get blocker resolution data.",
182
+ ),
183
+ ),
184
+ usage_notes=_POST_READ_USAGE_NOTES,
185
+ ),
186
+ make_tool(
187
+ canonical_name="charts.due-dates.get",
188
+ mcp_alias="kaiten_chart_due_dates",
189
+ description="Get due dates analysis for a space.",
190
+ input_schema={
191
+ "type": "object",
192
+ "properties": {
193
+ "space_id": {"type": "integer", "description": "Space ID"},
194
+ "card_date_from": {
195
+ "type": "string",
196
+ "description": "Card date range start (ISO 8601)",
197
+ },
198
+ "card_date_to": {"type": "string", "description": "Card date range end (ISO 8601)"},
199
+ "checklist_item_date_from": {
200
+ "type": "string",
201
+ "description": "Checklist item date range start (ISO 8601)",
202
+ },
203
+ "checklist_item_date_to": {
204
+ "type": "string",
205
+ "description": "Checklist item date range end (ISO 8601)",
206
+ },
207
+ "due_date": {"type": "string", "description": "Due date filter (ISO 8601)"},
208
+ "responsible_id": {"type": "integer", "description": "Responsible user ID"},
209
+ "tz_offset": {"type": "integer", "description": "Timezone offset in minutes"},
210
+ "lane_ids": {
211
+ "type": "array",
212
+ "items": {"type": "integer"},
213
+ "description": "Filter by lane IDs",
214
+ },
215
+ "column_ids": {
216
+ "type": "array",
217
+ "items": {"type": "integer"},
218
+ "description": "Filter by column IDs",
219
+ },
220
+ "card_type_ids": {
221
+ "type": "array",
222
+ "items": {"type": "integer"},
223
+ "description": "Filter by card type IDs",
224
+ },
225
+ "tag_ids": {
226
+ "type": "array",
227
+ "items": {"type": "integer"},
228
+ "description": "Filter by tag IDs",
229
+ },
230
+ },
231
+ "required": [
232
+ "space_id",
233
+ "card_date_from",
234
+ "card_date_to",
235
+ "checklist_item_date_from",
236
+ "checklist_item_date_to",
237
+ ],
238
+ },
239
+ operation=OperationSpec(
240
+ method="POST",
241
+ path_template="/charts/due-dates",
242
+ body_fields=(
243
+ "space_id",
244
+ "card_date_from",
245
+ "card_date_to",
246
+ "checklist_item_date_from",
247
+ "checklist_item_date_to",
248
+ "due_date",
249
+ "responsible_id",
250
+ "tz_offset",
251
+ "lane_ids",
252
+ "column_ids",
253
+ "card_type_ids",
254
+ "tag_ids",
255
+ ),
256
+ ),
257
+ response_policy=_HEAVY,
258
+ runtime_behavior=_READ_ONLY_ANALYTICS,
259
+ examples=(
260
+ ExampleSpec(
261
+ command="kaiten --json charts due-dates get --space-id 1 --card-date-from 2026-01-01 --card-date-to 2026-01-31 --checklist-item-date-from 2026-01-01 --checklist-item-date-to 2026-01-31",
262
+ description="Get due-date analysis.",
263
+ ),
264
+ ),
265
+ usage_notes=_POST_READ_USAGE_NOTES,
266
+ ),
267
+ *_chart_create(
268
+ canonical_name="charts.cfd.create",
269
+ mcp_alias="kaiten_chart_cfd",
270
+ description="Build a Cumulative Flow Diagram (CFD) for a space.",
271
+ path_template="/charts/cfd",
272
+ properties={
273
+ **_COMMON_CHART_PROPS,
274
+ "cardTypes": {
275
+ "type": "array",
276
+ "items": {"type": "integer"},
277
+ "description": "Filter by card type IDs (alternative field name used by CFD)",
278
+ },
279
+ "selectedLanes": {
280
+ "type": "array",
281
+ "items": {"type": "integer"},
282
+ "description": "Filter by lane IDs",
283
+ },
284
+ },
285
+ required=("space_id", "date_from", "date_to"),
286
+ body_fields=(
287
+ "space_id",
288
+ "date_from",
289
+ "date_to",
290
+ "tags",
291
+ "only_asap_cards",
292
+ "card_types",
293
+ "cardTypes",
294
+ "group_by",
295
+ "selectedLanes",
296
+ ),
297
+ ),
298
+ *_chart_create(
299
+ canonical_name="charts.control.create",
300
+ mcp_alias="kaiten_chart_control",
301
+ description="Build a Control Chart for a space.",
302
+ path_template="/charts/control-chart",
303
+ properties={**_COMMON_CHART_PROPS, **_CONTROL_EXTRA_PROPS},
304
+ required=(
305
+ "space_id",
306
+ "date_from",
307
+ "date_to",
308
+ "start_columns",
309
+ "end_columns",
310
+ "start_column_lanes",
311
+ "end_column_lanes",
312
+ ),
313
+ body_fields=(
314
+ "space_id",
315
+ "date_from",
316
+ "date_to",
317
+ "tags",
318
+ "only_asap_cards",
319
+ "card_types",
320
+ "group_by",
321
+ *_CONTROL_EXTRA_KEYS,
322
+ ),
323
+ ),
324
+ *_chart_create(
325
+ canonical_name="charts.spectral.create",
326
+ mcp_alias="kaiten_chart_spectral",
327
+ description="Build a Spectral Chart for a space.",
328
+ path_template="/charts/spectral-chart",
329
+ properties={**_COMMON_CHART_PROPS, **_CONTROL_EXTRA_PROPS},
330
+ required=(
331
+ "space_id",
332
+ "date_from",
333
+ "date_to",
334
+ "start_columns",
335
+ "end_columns",
336
+ "start_column_lanes",
337
+ "end_column_lanes",
338
+ ),
339
+ body_fields=(
340
+ "space_id",
341
+ "date_from",
342
+ "date_to",
343
+ "tags",
344
+ "only_asap_cards",
345
+ "card_types",
346
+ "group_by",
347
+ *_CONTROL_EXTRA_KEYS,
348
+ ),
349
+ ),
350
+ *_chart_create(
351
+ canonical_name="charts.lead-time.create",
352
+ mcp_alias="kaiten_chart_lead_time",
353
+ description="Build a Lead Time Chart for a space.",
354
+ path_template="/charts/lead-time",
355
+ properties={**_COMMON_CHART_PROPS, **_CONTROL_EXTRA_PROPS},
356
+ required=(
357
+ "space_id",
358
+ "date_from",
359
+ "date_to",
360
+ "start_columns",
361
+ "end_columns",
362
+ "start_column_lanes",
363
+ "end_column_lanes",
364
+ ),
365
+ body_fields=(
366
+ "space_id",
367
+ "date_from",
368
+ "date_to",
369
+ "tags",
370
+ "only_asap_cards",
371
+ "card_types",
372
+ "group_by",
373
+ *_CONTROL_EXTRA_KEYS,
374
+ ),
375
+ ),
376
+ *_chart_create(
377
+ canonical_name="charts.throughput-capacity.create",
378
+ mcp_alias="kaiten_chart_throughput_capacity",
379
+ description="Build a Throughput Capacity Chart for a space.",
380
+ path_template="/charts/throughput-capacity-chart",
381
+ properties={
382
+ **_COMMON_CHART_PROPS,
383
+ "end_column": {"type": "integer", "description": "End (done) column ID"},
384
+ },
385
+ required=("space_id", "date_from", "end_column"),
386
+ body_fields=(
387
+ "space_id",
388
+ "date_from",
389
+ "date_to",
390
+ "tags",
391
+ "only_asap_cards",
392
+ "card_types",
393
+ "group_by",
394
+ "end_column",
395
+ ),
396
+ ),
397
+ *_chart_create(
398
+ canonical_name="charts.throughput-demand.create",
399
+ mcp_alias="kaiten_chart_throughput_demand",
400
+ description="Build a Throughput Demand Chart for a space.",
401
+ path_template="/charts/throughput-demand-chart",
402
+ properties={
403
+ **_COMMON_CHART_PROPS,
404
+ "start_column": {"type": "integer", "description": "Start (input) column ID"},
405
+ },
406
+ required=("space_id", "date_from", "start_column"),
407
+ body_fields=(
408
+ "space_id",
409
+ "date_from",
410
+ "date_to",
411
+ "tags",
412
+ "only_asap_cards",
413
+ "card_types",
414
+ "group_by",
415
+ "start_column",
416
+ ),
417
+ ),
418
+ *_chart_create(
419
+ canonical_name="charts.task-distribution.create",
420
+ mcp_alias="kaiten_chart_task_distribution",
421
+ description="Build a Task Distribution Chart for a space.",
422
+ path_template="/charts/task-distribution-chart",
423
+ properties={
424
+ "space_id": {"type": "integer", "description": "Space ID"},
425
+ "timezone": {"type": "string", "description": "Timezone name (e.g. Europe/Moscow)"},
426
+ "includeArchivedCards": {"type": "boolean", "description": "Include archived cards"},
427
+ "only_asap_cards": {
428
+ "type": "boolean",
429
+ "description": "Include only ASAP (expedite) cards",
430
+ },
431
+ "card_types": {
432
+ "type": "array",
433
+ "items": {"type": "integer"},
434
+ "description": "Filter by card type IDs",
435
+ },
436
+ "itemsFilter": {"type": "object", "description": "Additional filter object for items"},
437
+ },
438
+ required=("space_id",),
439
+ body_fields=(
440
+ "space_id",
441
+ "timezone",
442
+ "includeArchivedCards",
443
+ "only_asap_cards",
444
+ "card_types",
445
+ "itemsFilter",
446
+ ),
447
+ ),
448
+ *_chart_create(
449
+ canonical_name="charts.cycle-time.create",
450
+ mcp_alias="kaiten_chart_cycle_time",
451
+ description="Build a Cycle Time Chart for a space.",
452
+ path_template="/charts/cycle-time-chart",
453
+ properties={
454
+ **_COMMON_CHART_PROPS,
455
+ "start_column": {"type": "integer", "description": "Start column ID"},
456
+ "end_column": {"type": "integer", "description": "End column ID"},
457
+ },
458
+ required=("space_id", "date_from", "date_to", "start_column", "end_column"),
459
+ body_fields=(
460
+ "space_id",
461
+ "date_from",
462
+ "date_to",
463
+ "tags",
464
+ "only_asap_cards",
465
+ "card_types",
466
+ "group_by",
467
+ "start_column",
468
+ "end_column",
469
+ ),
470
+ ),
471
+ *_chart_create(
472
+ canonical_name="charts.sales-funnel.create",
473
+ mcp_alias="kaiten_chart_sales_funnel",
474
+ description="Build a Sales Funnel Chart for a space.",
475
+ path_template="/charts/sales-funnel",
476
+ properties={
477
+ **_COMMON_CHART_PROPS,
478
+ "board_configs": {
479
+ "type": "array",
480
+ "items": {"type": "object"},
481
+ "description": "Array of board configuration objects.",
482
+ },
483
+ },
484
+ required=("space_id", "date_from", "date_to", "board_configs"),
485
+ body_fields=(
486
+ "space_id",
487
+ "date_from",
488
+ "date_to",
489
+ "tags",
490
+ "only_asap_cards",
491
+ "card_types",
492
+ "group_by",
493
+ "board_configs",
494
+ ),
495
+ ),
496
+ make_tool(
497
+ canonical_name="compute-jobs.get",
498
+ mcp_alias="kaiten_get_compute_job",
499
+ description="Get the status and result of an asynchronous compute job.",
500
+ input_schema={
501
+ "type": "object",
502
+ "properties": {"job_id": {"type": "integer", "description": "Compute job ID"}},
503
+ "required": ["job_id"],
504
+ },
505
+ operation=OperationSpec(
506
+ method="GET",
507
+ path_template="/users/current/compute-jobs/{job_id}",
508
+ path_fields=("job_id",),
509
+ ),
510
+ runtime_behavior=RuntimeBehavior(cache_policy="none"),
511
+ examples=(
512
+ ExampleSpec(
513
+ command="kaiten --json compute-jobs get --job-id 1",
514
+ description="Get compute job status.",
515
+ ),
516
+ ),
517
+ ),
518
+ make_tool(
519
+ canonical_name="compute-jobs.cancel",
520
+ mcp_alias="kaiten_cancel_compute_job",
521
+ description="Cancel a running or queued compute job.",
522
+ input_schema={
523
+ "type": "object",
524
+ "properties": {"job_id": {"type": "integer", "description": "Compute job ID"}},
525
+ "required": ["job_id"],
526
+ },
527
+ operation=OperationSpec(
528
+ method="DELETE",
529
+ path_template="/users/current/compute-jobs/{job_id}",
530
+ path_fields=("job_id",),
531
+ ),
532
+ examples=(
533
+ ExampleSpec(
534
+ command="kaiten --json compute-jobs cancel --job-id 1",
535
+ description="Cancel a compute job.",
536
+ ),
537
+ ),
538
+ ),
539
+ )