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.
- kaiten_cli/__init__.py +5 -0
- kaiten_cli/__main__.py +9 -0
- kaiten_cli/agent_gateway.py +577 -0
- kaiten_cli/app.py +1636 -0
- kaiten_cli/completion.py +570 -0
- kaiten_cli/discovery.py +39 -0
- kaiten_cli/errors.py +79 -0
- kaiten_cli/i18n.py +92 -0
- kaiten_cli/locales/ru.json +2967 -0
- kaiten_cli/localized_click.py +160 -0
- kaiten_cli/models.py +202 -0
- kaiten_cli/profiles.py +316 -0
- kaiten_cli/registry/__init__.py +260 -0
- kaiten_cli/registry/addons.py +392 -0
- kaiten_cli/registry/audit_and_analytics.py +451 -0
- kaiten_cli/registry/automation_schema.py +44 -0
- kaiten_cli/registry/automation_schemas.json +7417 -0
- kaiten_cli/registry/automations.py +342 -0
- kaiten_cli/registry/base.py +62 -0
- kaiten_cli/registry/blockers.py +320 -0
- kaiten_cli/registry/boards.py +520 -0
- kaiten_cli/registry/card_relations.py +376 -0
- kaiten_cli/registry/card_types.py +363 -0
- kaiten_cli/registry/cards.py +1329 -0
- kaiten_cli/registry/charts.py +539 -0
- kaiten_cli/registry/checklists.py +600 -0
- kaiten_cli/registry/columns.py +558 -0
- kaiten_cli/registry/comments.py +224 -0
- kaiten_cli/registry/custom_directories.py +980 -0
- kaiten_cli/registry/custom_properties.py +1460 -0
- kaiten_cli/registry/dashboards.py +564 -0
- kaiten_cli/registry/documents.py +761 -0
- kaiten_cli/registry/external_links.py +128 -0
- kaiten_cli/registry/files.py +738 -0
- kaiten_cli/registry/github_addon.py +613 -0
- kaiten_cli/registry/iterations.py +397 -0
- kaiten_cli/registry/lanes.py +205 -0
- kaiten_cli/registry/live_contracts.py +361 -0
- kaiten_cli/registry/members.py +336 -0
- kaiten_cli/registry/module_docs.py +108 -0
- kaiten_cli/registry/projects.py +369 -0
- kaiten_cli/registry/query.py +129 -0
- kaiten_cli/registry/restrictions.py +249 -0
- kaiten_cli/registry/roles_and_groups.py +1102 -0
- kaiten_cli/registry/scim.py +263 -0
- kaiten_cli/registry/service_desk.py +1270 -0
- kaiten_cli/registry/snapshot.py +187 -0
- kaiten_cli/registry/spaces.py +272 -0
- kaiten_cli/registry/subscribers.py +168 -0
- kaiten_cli/registry/tags.py +193 -0
- kaiten_cli/registry/time_logs.py +353 -0
- kaiten_cli/registry/tree.py +352 -0
- kaiten_cli/registry/utilities.py +287 -0
- kaiten_cli/registry/webhooks.py +265 -0
- kaiten_cli/runtime/__init__.py +1 -0
- kaiten_cli/runtime/automation_validation.py +115 -0
- kaiten_cli/runtime/behaviors.py +787 -0
- kaiten_cli/runtime/cache.py +733 -0
- kaiten_cli/runtime/client.py +387 -0
- kaiten_cli/runtime/endpoints.py +59 -0
- kaiten_cli/runtime/executor.py +269 -0
- kaiten_cli/runtime/fs_security.py +168 -0
- kaiten_cli/runtime/input.py +310 -0
- kaiten_cli/runtime/output.py +59 -0
- kaiten_cli/runtime/public_validation.py +35 -0
- kaiten_cli/runtime/snapshot_build.py +527 -0
- kaiten_cli/runtime/snapshot_common.py +363 -0
- kaiten_cli/runtime/snapshot_query.py +306 -0
- kaiten_cli/runtime/snapshot_store.py +1192 -0
- kaiten_cli/runtime/snapshots.py +62 -0
- kaiten_cli/runtime/sqlite_errors.py +23 -0
- kaiten_cli/runtime/support/__init__.py +1 -0
- kaiten_cli/runtime/support/addons.py +953 -0
- kaiten_cli/runtime/support/audit.py +70 -0
- kaiten_cli/runtime/support/batch.py +234 -0
- kaiten_cli/runtime/support/card_move_url.py +213 -0
- kaiten_cli/runtime/support/cards.py +174 -0
- kaiten_cli/runtime/support/checklists.py +21 -0
- kaiten_cli/runtime/support/company_users.py +117 -0
- kaiten_cli/runtime/support/dashboards.py +35 -0
- kaiten_cli/runtime/support/documents.py +175 -0
- kaiten_cli/runtime/support/files.py +561 -0
- kaiten_cli/runtime/support/markdown_export.py +525 -0
- kaiten_cli/runtime/support/pagination.py +167 -0
- kaiten_cli/runtime/support/projects.py +66 -0
- kaiten_cli/runtime/support/relations.py +86 -0
- kaiten_cli/runtime/support/restrictions.py +62 -0
- kaiten_cli/runtime/support/spaces.py +20 -0
- kaiten_cli/runtime/support/time_logs.py +61 -0
- kaiten_cli/runtime/support/tree.py +140 -0
- kaiten_cli/runtime/support/tree_sharing.py +447 -0
- kaiten_cli/runtime/trace.py +500 -0
- kaiten_cli/runtime/transforms.py +128 -0
- kaiten_cli/schema_docs.py +22 -0
- kaiten_cli/update_check.py +519 -0
- kaiten_cli-0.3.3.dist-info/METADATA +1110 -0
- kaiten_cli-0.3.3.dist-info/RECORD +99 -0
- kaiten_cli-0.3.3.dist-info/WHEEL +4 -0
- kaiten_cli-0.3.3.dist-info/entry_points.txt +3 -0
|
@@ -0,0 +1,1270 @@
|
|
|
1
|
+
"""Service desk 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
|
+
from kaiten_cli.runtime.behaviors import archive_service_request, service_desk_stats_query_request
|
|
8
|
+
from kaiten_cli.runtime.transforms import DEFAULT_LIMIT
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
TOOLS = (
|
|
12
|
+
make_tool(
|
|
13
|
+
canonical_name="service-desk.requests.list",
|
|
14
|
+
mcp_alias="kaiten_list_sd_requests",
|
|
15
|
+
description="List Service Desk requests.",
|
|
16
|
+
input_schema={
|
|
17
|
+
"type": "object",
|
|
18
|
+
"properties": {
|
|
19
|
+
"query": {"type": "string", "description": "Search filter"},
|
|
20
|
+
"limit": {"type": "integer", "description": "Max results"},
|
|
21
|
+
"offset": {"type": "integer", "description": "Pagination offset"},
|
|
22
|
+
},
|
|
23
|
+
},
|
|
24
|
+
operation=OperationSpec(
|
|
25
|
+
method="GET",
|
|
26
|
+
path_template="/service-desk/requests",
|
|
27
|
+
query_fields=("query", "limit", "offset"),
|
|
28
|
+
),
|
|
29
|
+
response_policy=ResponsePolicy(default_limit=DEFAULT_LIMIT, result_kind="list"),
|
|
30
|
+
examples=(
|
|
31
|
+
ExampleSpec(
|
|
32
|
+
command="kaiten --json service-desk requests list",
|
|
33
|
+
description="List Service Desk requests.",
|
|
34
|
+
),
|
|
35
|
+
),
|
|
36
|
+
),
|
|
37
|
+
make_tool(
|
|
38
|
+
canonical_name="service-desk.requests.create",
|
|
39
|
+
mcp_alias="kaiten_create_sd_request",
|
|
40
|
+
description="Create a new Service Desk request.",
|
|
41
|
+
input_schema={
|
|
42
|
+
"type": "object",
|
|
43
|
+
"properties": {
|
|
44
|
+
"title": {"type": "string", "description": "Request title"},
|
|
45
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
46
|
+
"description": {"type": "string", "description": "Request description"},
|
|
47
|
+
"priority": {"type": "string", "description": "Request priority"},
|
|
48
|
+
},
|
|
49
|
+
"required": ["title", "service_id"],
|
|
50
|
+
},
|
|
51
|
+
operation=OperationSpec(
|
|
52
|
+
method="POST",
|
|
53
|
+
path_template="/service-desk/requests",
|
|
54
|
+
body_fields=("title", "service_id", "description", "priority"),
|
|
55
|
+
),
|
|
56
|
+
examples=(
|
|
57
|
+
ExampleSpec(
|
|
58
|
+
command='kaiten --json service-desk requests create --title "Help" --service-id 1',
|
|
59
|
+
description="Create a request.",
|
|
60
|
+
),
|
|
61
|
+
),
|
|
62
|
+
),
|
|
63
|
+
make_tool(
|
|
64
|
+
canonical_name="service-desk.requests.get",
|
|
65
|
+
mcp_alias="kaiten_get_sd_request",
|
|
66
|
+
description="Get a Service Desk request by ID.",
|
|
67
|
+
input_schema={
|
|
68
|
+
"type": "object",
|
|
69
|
+
"properties": {"request_id": {"type": "integer", "description": "Request ID"}},
|
|
70
|
+
"required": ["request_id"],
|
|
71
|
+
},
|
|
72
|
+
operation=OperationSpec(
|
|
73
|
+
method="GET",
|
|
74
|
+
path_template="/service-desk/requests/{request_id}",
|
|
75
|
+
path_fields=("request_id",),
|
|
76
|
+
),
|
|
77
|
+
examples=(
|
|
78
|
+
ExampleSpec(
|
|
79
|
+
command="kaiten --json service-desk requests get --request-id 1",
|
|
80
|
+
description="Get a request.",
|
|
81
|
+
),
|
|
82
|
+
),
|
|
83
|
+
),
|
|
84
|
+
make_tool(
|
|
85
|
+
canonical_name="service-desk.requests.update",
|
|
86
|
+
mcp_alias="kaiten_update_sd_request",
|
|
87
|
+
description="Update a Service Desk request.",
|
|
88
|
+
input_schema={
|
|
89
|
+
"type": "object",
|
|
90
|
+
"properties": {
|
|
91
|
+
"request_id": {"type": "integer", "description": "Request ID"},
|
|
92
|
+
"title": {"type": "string", "description": "Request title"},
|
|
93
|
+
"description": {"type": "string", "description": "Request description"},
|
|
94
|
+
"priority": {"type": "string", "description": "Request priority"},
|
|
95
|
+
},
|
|
96
|
+
"required": ["request_id"],
|
|
97
|
+
},
|
|
98
|
+
operation=OperationSpec(
|
|
99
|
+
method="PATCH",
|
|
100
|
+
path_template="/service-desk/requests/{request_id}",
|
|
101
|
+
path_fields=("request_id",),
|
|
102
|
+
body_fields=("title", "description", "priority"),
|
|
103
|
+
),
|
|
104
|
+
examples=(
|
|
105
|
+
ExampleSpec(
|
|
106
|
+
command="kaiten --json service-desk requests update --request-id 1 --priority high",
|
|
107
|
+
description="Update a request.",
|
|
108
|
+
),
|
|
109
|
+
),
|
|
110
|
+
),
|
|
111
|
+
make_tool(
|
|
112
|
+
canonical_name="service-desk.requests.delete",
|
|
113
|
+
mcp_alias="kaiten_delete_sd_request",
|
|
114
|
+
description="Delete a Service Desk request.",
|
|
115
|
+
input_schema={
|
|
116
|
+
"type": "object",
|
|
117
|
+
"properties": {"request_id": {"type": "integer", "description": "Request ID"}},
|
|
118
|
+
"required": ["request_id"],
|
|
119
|
+
},
|
|
120
|
+
operation=OperationSpec(
|
|
121
|
+
method="DELETE",
|
|
122
|
+
path_template="/service-desk/requests/{request_id}",
|
|
123
|
+
path_fields=("request_id",),
|
|
124
|
+
),
|
|
125
|
+
examples=(
|
|
126
|
+
ExampleSpec(
|
|
127
|
+
command="kaiten --json service-desk requests delete --request-id 1",
|
|
128
|
+
description="Delete a request.",
|
|
129
|
+
),
|
|
130
|
+
),
|
|
131
|
+
),
|
|
132
|
+
make_tool(
|
|
133
|
+
canonical_name="service-desk.services.list",
|
|
134
|
+
mcp_alias="kaiten_list_sd_services",
|
|
135
|
+
description="List Service Desk services.",
|
|
136
|
+
input_schema={
|
|
137
|
+
"type": "object",
|
|
138
|
+
"properties": {
|
|
139
|
+
"query": {"type": "string", "description": "Search filter"},
|
|
140
|
+
"include_archived": {"type": "boolean", "description": "Include archived services"},
|
|
141
|
+
"limit": {"type": "integer", "description": "Max results"},
|
|
142
|
+
"offset": {"type": "integer", "description": "Pagination offset"},
|
|
143
|
+
},
|
|
144
|
+
},
|
|
145
|
+
operation=OperationSpec(
|
|
146
|
+
method="GET",
|
|
147
|
+
path_template="/service-desk/services",
|
|
148
|
+
query_fields=("query", "include_archived", "limit", "offset"),
|
|
149
|
+
),
|
|
150
|
+
response_policy=ResponsePolicy(default_limit=DEFAULT_LIMIT, result_kind="list"),
|
|
151
|
+
examples=(
|
|
152
|
+
ExampleSpec(
|
|
153
|
+
command="kaiten --json service-desk services list", description="List services."
|
|
154
|
+
),
|
|
155
|
+
),
|
|
156
|
+
),
|
|
157
|
+
make_tool(
|
|
158
|
+
canonical_name="service-desk.services.get",
|
|
159
|
+
mcp_alias="kaiten_get_sd_service",
|
|
160
|
+
description="Get a Service Desk service by ID.",
|
|
161
|
+
input_schema={
|
|
162
|
+
"type": "object",
|
|
163
|
+
"properties": {"service_id": {"type": "integer", "description": "Service ID"}},
|
|
164
|
+
"required": ["service_id"],
|
|
165
|
+
},
|
|
166
|
+
operation=OperationSpec(
|
|
167
|
+
method="GET",
|
|
168
|
+
path_template="/service-desk/services/{service_id}",
|
|
169
|
+
path_fields=("service_id",),
|
|
170
|
+
),
|
|
171
|
+
examples=(
|
|
172
|
+
ExampleSpec(
|
|
173
|
+
command="kaiten --json service-desk services get --service-id 1",
|
|
174
|
+
description="Get a service.",
|
|
175
|
+
),
|
|
176
|
+
),
|
|
177
|
+
),
|
|
178
|
+
make_tool(
|
|
179
|
+
canonical_name="service-desk.services.create",
|
|
180
|
+
mcp_alias="kaiten_create_sd_service",
|
|
181
|
+
description="Create a new Service Desk service.",
|
|
182
|
+
input_schema={
|
|
183
|
+
"type": "object",
|
|
184
|
+
"properties": {
|
|
185
|
+
"name": {"type": "string", "description": "Service name"},
|
|
186
|
+
"board_id": {"type": "integer", "description": "Board ID"},
|
|
187
|
+
"position": {"type": "integer", "description": "Sort position"},
|
|
188
|
+
"description": {"type": "string", "description": "Service description"},
|
|
189
|
+
"template_description": {
|
|
190
|
+
"type": "string",
|
|
191
|
+
"description": "Default description template",
|
|
192
|
+
},
|
|
193
|
+
"lng": {"type": "string", "enum": ["en", "ru"], "description": "Language code"},
|
|
194
|
+
"display_status": {
|
|
195
|
+
"type": "string",
|
|
196
|
+
"enum": ["by_column", "by_state"],
|
|
197
|
+
"description": "How status is displayed",
|
|
198
|
+
},
|
|
199
|
+
"column_id": {"type": "integer", "description": "Default column ID"},
|
|
200
|
+
"lane_id": {"type": "integer", "description": "Default lane ID"},
|
|
201
|
+
"type_id": {"type": "integer", "description": "Card type ID"},
|
|
202
|
+
"email_settings": {"type": "integer", "description": "Email settings bitmask"},
|
|
203
|
+
"fields_settings": {
|
|
204
|
+
"type": "object",
|
|
205
|
+
"description": "Request form fields configuration",
|
|
206
|
+
},
|
|
207
|
+
"settings": {"type": "object", "description": "Additional settings"},
|
|
208
|
+
"allow_to_add_external_recipients": {
|
|
209
|
+
"type": "boolean",
|
|
210
|
+
"description": "Allow external recipients",
|
|
211
|
+
},
|
|
212
|
+
"hide_in_list": {"type": "boolean", "description": "Hide service in list"},
|
|
213
|
+
"is_default": {"type": "boolean", "description": "Set as default service"},
|
|
214
|
+
},
|
|
215
|
+
"required": ["name", "board_id", "position", "lng"],
|
|
216
|
+
},
|
|
217
|
+
operation=OperationSpec(
|
|
218
|
+
method="POST",
|
|
219
|
+
path_template="/service-desk/services",
|
|
220
|
+
body_fields=(
|
|
221
|
+
"name",
|
|
222
|
+
"board_id",
|
|
223
|
+
"position",
|
|
224
|
+
"description",
|
|
225
|
+
"template_description",
|
|
226
|
+
"lng",
|
|
227
|
+
"display_status",
|
|
228
|
+
"column_id",
|
|
229
|
+
"lane_id",
|
|
230
|
+
"type_id",
|
|
231
|
+
"email_settings",
|
|
232
|
+
"fields_settings",
|
|
233
|
+
"settings",
|
|
234
|
+
"allow_to_add_external_recipients",
|
|
235
|
+
"hide_in_list",
|
|
236
|
+
"is_default",
|
|
237
|
+
),
|
|
238
|
+
),
|
|
239
|
+
examples=(
|
|
240
|
+
ExampleSpec(
|
|
241
|
+
command="kaiten --json service-desk services create --name Support --board-id 1 --position 1 --lng en",
|
|
242
|
+
description="Create a service.",
|
|
243
|
+
),
|
|
244
|
+
),
|
|
245
|
+
),
|
|
246
|
+
make_tool(
|
|
247
|
+
canonical_name="service-desk.services.update",
|
|
248
|
+
mcp_alias="kaiten_update_sd_service",
|
|
249
|
+
description="Update a Service Desk service.",
|
|
250
|
+
input_schema={
|
|
251
|
+
"type": "object",
|
|
252
|
+
"properties": {
|
|
253
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
254
|
+
"name": {"type": "string", "description": "Service name"},
|
|
255
|
+
"description": {"type": "string", "description": "Service description"},
|
|
256
|
+
"template_description": {
|
|
257
|
+
"type": "string",
|
|
258
|
+
"description": "Default description template",
|
|
259
|
+
},
|
|
260
|
+
"lng": {"type": "string", "description": "Language code"},
|
|
261
|
+
"display_status": {
|
|
262
|
+
"type": "string",
|
|
263
|
+
"enum": ["by_column", "by_state"],
|
|
264
|
+
"description": "How status is displayed",
|
|
265
|
+
},
|
|
266
|
+
"board_id": {"type": "integer", "description": "Board ID"},
|
|
267
|
+
"column_id": {"type": "integer", "description": "Default column ID"},
|
|
268
|
+
"lane_id": {"type": "integer", "description": "Default lane ID"},
|
|
269
|
+
"type_id": {"type": "integer", "description": "Card type ID"},
|
|
270
|
+
"position": {"type": "integer", "description": "Sort position"},
|
|
271
|
+
"email_settings": {"type": "integer", "description": "Email settings bitmask"},
|
|
272
|
+
"fields_settings": {
|
|
273
|
+
"type": "object",
|
|
274
|
+
"description": "Request form fields configuration",
|
|
275
|
+
},
|
|
276
|
+
"settings": {"type": "object", "description": "Additional settings"},
|
|
277
|
+
"archived": {"type": "boolean", "description": "Archive or unarchive service"},
|
|
278
|
+
"allow_to_add_external_recipients": {
|
|
279
|
+
"type": "boolean",
|
|
280
|
+
"description": "Allow external recipients",
|
|
281
|
+
},
|
|
282
|
+
"hide_in_list": {"type": "boolean", "description": "Hide service in list"},
|
|
283
|
+
},
|
|
284
|
+
"required": ["service_id"],
|
|
285
|
+
},
|
|
286
|
+
operation=OperationSpec(
|
|
287
|
+
method="PATCH",
|
|
288
|
+
path_template="/service-desk/services/{service_id}",
|
|
289
|
+
path_fields=("service_id",),
|
|
290
|
+
body_fields=(
|
|
291
|
+
"name",
|
|
292
|
+
"description",
|
|
293
|
+
"template_description",
|
|
294
|
+
"lng",
|
|
295
|
+
"display_status",
|
|
296
|
+
"board_id",
|
|
297
|
+
"column_id",
|
|
298
|
+
"lane_id",
|
|
299
|
+
"type_id",
|
|
300
|
+
"position",
|
|
301
|
+
"email_settings",
|
|
302
|
+
"fields_settings",
|
|
303
|
+
"settings",
|
|
304
|
+
"archived",
|
|
305
|
+
"allow_to_add_external_recipients",
|
|
306
|
+
"hide_in_list",
|
|
307
|
+
),
|
|
308
|
+
),
|
|
309
|
+
examples=(
|
|
310
|
+
ExampleSpec(
|
|
311
|
+
command="kaiten --json service-desk services update --service-id 1 --archived",
|
|
312
|
+
description="Update a service.",
|
|
313
|
+
),
|
|
314
|
+
),
|
|
315
|
+
),
|
|
316
|
+
make_tool(
|
|
317
|
+
canonical_name="service-desk.services.delete",
|
|
318
|
+
mcp_alias="kaiten_delete_sd_service",
|
|
319
|
+
description="Archive a Service Desk service.",
|
|
320
|
+
input_schema={
|
|
321
|
+
"type": "object",
|
|
322
|
+
"properties": {"service_id": {"type": "integer", "description": "Service ID"}},
|
|
323
|
+
"required": ["service_id"],
|
|
324
|
+
},
|
|
325
|
+
operation=OperationSpec(
|
|
326
|
+
method="PATCH",
|
|
327
|
+
path_template="/service-desk/services/{service_id}",
|
|
328
|
+
path_fields=("service_id",),
|
|
329
|
+
),
|
|
330
|
+
runtime_behavior=RuntimeBehavior(request_shaper=archive_service_request),
|
|
331
|
+
examples=(
|
|
332
|
+
ExampleSpec(
|
|
333
|
+
command="kaiten --json service-desk services delete --service-id 1",
|
|
334
|
+
description="Archive a service.",
|
|
335
|
+
),
|
|
336
|
+
),
|
|
337
|
+
),
|
|
338
|
+
make_tool(
|
|
339
|
+
canonical_name="service-desk.organizations.list",
|
|
340
|
+
mcp_alias="kaiten_list_sd_organizations",
|
|
341
|
+
description="List Service Desk organizations.",
|
|
342
|
+
input_schema={
|
|
343
|
+
"type": "object",
|
|
344
|
+
"properties": {
|
|
345
|
+
"query": {"type": "string", "description": "Search filter"},
|
|
346
|
+
"includeUsers": {"type": "boolean", "description": "Include organization users"},
|
|
347
|
+
"limit": {"type": "integer", "description": "Max results"},
|
|
348
|
+
"offset": {"type": "integer", "description": "Pagination offset"},
|
|
349
|
+
},
|
|
350
|
+
},
|
|
351
|
+
operation=OperationSpec(
|
|
352
|
+
method="GET",
|
|
353
|
+
path_template="/service-desk/organizations",
|
|
354
|
+
query_fields=("query", "includeUsers", "limit", "offset"),
|
|
355
|
+
),
|
|
356
|
+
response_policy=ResponsePolicy(default_limit=DEFAULT_LIMIT, result_kind="list"),
|
|
357
|
+
examples=(
|
|
358
|
+
ExampleSpec(
|
|
359
|
+
command="kaiten --json service-desk organizations list",
|
|
360
|
+
description="List organizations.",
|
|
361
|
+
),
|
|
362
|
+
),
|
|
363
|
+
),
|
|
364
|
+
make_tool(
|
|
365
|
+
canonical_name="service-desk.organizations.create",
|
|
366
|
+
mcp_alias="kaiten_create_sd_organization",
|
|
367
|
+
description="Create a Service Desk organization.",
|
|
368
|
+
input_schema={
|
|
369
|
+
"type": "object",
|
|
370
|
+
"properties": {
|
|
371
|
+
"name": {"type": "string", "description": "Organization name"},
|
|
372
|
+
"description": {"type": "string", "description": "Organization description"},
|
|
373
|
+
},
|
|
374
|
+
"required": ["name"],
|
|
375
|
+
},
|
|
376
|
+
operation=OperationSpec(
|
|
377
|
+
method="POST",
|
|
378
|
+
path_template="/service-desk/organizations",
|
|
379
|
+
body_fields=("name", "description"),
|
|
380
|
+
),
|
|
381
|
+
examples=(
|
|
382
|
+
ExampleSpec(
|
|
383
|
+
command="kaiten --json service-desk organizations create --name Org",
|
|
384
|
+
description="Create an organization.",
|
|
385
|
+
),
|
|
386
|
+
),
|
|
387
|
+
),
|
|
388
|
+
make_tool(
|
|
389
|
+
canonical_name="service-desk.organizations.get",
|
|
390
|
+
mcp_alias="kaiten_get_sd_organization",
|
|
391
|
+
description="Get a Service Desk organization by ID.",
|
|
392
|
+
input_schema={
|
|
393
|
+
"type": "object",
|
|
394
|
+
"properties": {
|
|
395
|
+
"organization_id": {"type": "integer", "description": "Organization ID"}
|
|
396
|
+
},
|
|
397
|
+
"required": ["organization_id"],
|
|
398
|
+
},
|
|
399
|
+
operation=OperationSpec(
|
|
400
|
+
method="GET",
|
|
401
|
+
path_template="/service-desk/organizations/{organization_id}",
|
|
402
|
+
path_fields=("organization_id",),
|
|
403
|
+
),
|
|
404
|
+
examples=(
|
|
405
|
+
ExampleSpec(
|
|
406
|
+
command="kaiten --json service-desk organizations get --organization-id 1",
|
|
407
|
+
description="Get an organization.",
|
|
408
|
+
),
|
|
409
|
+
),
|
|
410
|
+
),
|
|
411
|
+
make_tool(
|
|
412
|
+
canonical_name="service-desk.organizations.update",
|
|
413
|
+
mcp_alias="kaiten_update_sd_organization",
|
|
414
|
+
description="Update a Service Desk organization.",
|
|
415
|
+
input_schema={
|
|
416
|
+
"type": "object",
|
|
417
|
+
"properties": {
|
|
418
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
419
|
+
"name": {"type": "string", "description": "Organization name"},
|
|
420
|
+
"description": {"type": "string", "description": "Organization description"},
|
|
421
|
+
},
|
|
422
|
+
"required": ["organization_id"],
|
|
423
|
+
},
|
|
424
|
+
operation=OperationSpec(
|
|
425
|
+
method="PATCH",
|
|
426
|
+
path_template="/service-desk/organizations/{organization_id}",
|
|
427
|
+
path_fields=("organization_id",),
|
|
428
|
+
body_fields=("name", "description"),
|
|
429
|
+
),
|
|
430
|
+
examples=(
|
|
431
|
+
ExampleSpec(
|
|
432
|
+
command="kaiten --json service-desk organizations update --organization-id 1 --name Org2",
|
|
433
|
+
description="Update an organization.",
|
|
434
|
+
),
|
|
435
|
+
),
|
|
436
|
+
),
|
|
437
|
+
make_tool(
|
|
438
|
+
canonical_name="service-desk.organizations.delete",
|
|
439
|
+
mcp_alias="kaiten_delete_sd_organization",
|
|
440
|
+
description="Delete a Service Desk organization.",
|
|
441
|
+
input_schema={
|
|
442
|
+
"type": "object",
|
|
443
|
+
"properties": {
|
|
444
|
+
"organization_id": {"type": "integer", "description": "Organization ID"}
|
|
445
|
+
},
|
|
446
|
+
"required": ["organization_id"],
|
|
447
|
+
},
|
|
448
|
+
operation=OperationSpec(
|
|
449
|
+
method="DELETE",
|
|
450
|
+
path_template="/service-desk/organizations/{organization_id}",
|
|
451
|
+
path_fields=("organization_id",),
|
|
452
|
+
),
|
|
453
|
+
examples=(
|
|
454
|
+
ExampleSpec(
|
|
455
|
+
command="kaiten --json service-desk organizations delete --organization-id 1",
|
|
456
|
+
description="Delete an organization.",
|
|
457
|
+
),
|
|
458
|
+
),
|
|
459
|
+
),
|
|
460
|
+
make_tool(
|
|
461
|
+
canonical_name="service-desk.sla.list",
|
|
462
|
+
mcp_alias="kaiten_list_sd_sla",
|
|
463
|
+
description="List Service Desk SLA policies.",
|
|
464
|
+
input_schema={
|
|
465
|
+
"type": "object",
|
|
466
|
+
"properties": {
|
|
467
|
+
"limit": {"type": "integer", "description": "Max results"},
|
|
468
|
+
"offset": {"type": "integer", "description": "Pagination offset"},
|
|
469
|
+
},
|
|
470
|
+
},
|
|
471
|
+
operation=OperationSpec(
|
|
472
|
+
method="GET", path_template="/service-desk/sla", query_fields=("limit", "offset")
|
|
473
|
+
),
|
|
474
|
+
response_policy=ResponsePolicy(default_limit=DEFAULT_LIMIT, result_kind="list"),
|
|
475
|
+
examples=(
|
|
476
|
+
ExampleSpec(
|
|
477
|
+
command="kaiten --json service-desk sla list", description="List SLA policies."
|
|
478
|
+
),
|
|
479
|
+
),
|
|
480
|
+
),
|
|
481
|
+
make_tool(
|
|
482
|
+
canonical_name="service-desk.sla.get",
|
|
483
|
+
mcp_alias="kaiten_get_sd_sla",
|
|
484
|
+
description="Get a Service Desk SLA policy by ID.",
|
|
485
|
+
input_schema={
|
|
486
|
+
"type": "object",
|
|
487
|
+
"properties": {"sla_id": {"type": "string", "description": "SLA ID (UUID)"}},
|
|
488
|
+
"required": ["sla_id"],
|
|
489
|
+
},
|
|
490
|
+
operation=OperationSpec(
|
|
491
|
+
method="GET", path_template="/service-desk/sla/{sla_id}", path_fields=("sla_id",)
|
|
492
|
+
),
|
|
493
|
+
examples=(
|
|
494
|
+
ExampleSpec(
|
|
495
|
+
command="kaiten --json service-desk sla get --sla-id sla-1",
|
|
496
|
+
description="Get an SLA policy.",
|
|
497
|
+
),
|
|
498
|
+
),
|
|
499
|
+
),
|
|
500
|
+
make_tool(
|
|
501
|
+
canonical_name="service-desk.sla.create",
|
|
502
|
+
mcp_alias="kaiten_create_sd_sla",
|
|
503
|
+
description="Create a Service Desk SLA policy.",
|
|
504
|
+
input_schema={
|
|
505
|
+
"type": "object",
|
|
506
|
+
"properties": {
|
|
507
|
+
"name": {"type": "string", "description": "SLA policy name"},
|
|
508
|
+
"rules": {"type": "array", "items": {"type": "object"}, "description": "SLA rules"},
|
|
509
|
+
"notification_settings": {
|
|
510
|
+
"type": "object",
|
|
511
|
+
"description": "Notification configuration",
|
|
512
|
+
},
|
|
513
|
+
"v2": {"type": "boolean", "description": "Use v2 SLA format"},
|
|
514
|
+
},
|
|
515
|
+
"required": ["name", "rules"],
|
|
516
|
+
},
|
|
517
|
+
operation=OperationSpec(
|
|
518
|
+
method="POST",
|
|
519
|
+
path_template="/service-desk/sla",
|
|
520
|
+
body_fields=("name", "rules", "notification_settings", "v2"),
|
|
521
|
+
),
|
|
522
|
+
examples=(
|
|
523
|
+
ExampleSpec(
|
|
524
|
+
command="kaiten --json service-desk sla create --name SLA --rules '[]'",
|
|
525
|
+
description="Create an SLA policy.",
|
|
526
|
+
),
|
|
527
|
+
),
|
|
528
|
+
),
|
|
529
|
+
make_tool(
|
|
530
|
+
canonical_name="service-desk.sla.update",
|
|
531
|
+
mcp_alias="kaiten_update_sd_sla",
|
|
532
|
+
description="Update a Service Desk SLA policy.",
|
|
533
|
+
input_schema={
|
|
534
|
+
"type": "object",
|
|
535
|
+
"properties": {
|
|
536
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
537
|
+
"name": {"type": "string", "description": "SLA policy name"},
|
|
538
|
+
"status": {"type": "string", "description": "SLA status"},
|
|
539
|
+
"notification_settings": {
|
|
540
|
+
"type": "object",
|
|
541
|
+
"description": "Notification configuration",
|
|
542
|
+
},
|
|
543
|
+
"should_delete_sla_from_cards": {
|
|
544
|
+
"type": "boolean",
|
|
545
|
+
"description": "Remove SLA from cards when deactivating",
|
|
546
|
+
},
|
|
547
|
+
},
|
|
548
|
+
"required": ["sla_id"],
|
|
549
|
+
},
|
|
550
|
+
operation=OperationSpec(
|
|
551
|
+
method="PATCH",
|
|
552
|
+
path_template="/service-desk/sla/{sla_id}",
|
|
553
|
+
path_fields=("sla_id",),
|
|
554
|
+
body_fields=("name", "status", "notification_settings", "should_delete_sla_from_cards"),
|
|
555
|
+
),
|
|
556
|
+
examples=(
|
|
557
|
+
ExampleSpec(
|
|
558
|
+
command="kaiten --json service-desk sla update --sla-id sla-1 --status inactive",
|
|
559
|
+
description="Update an SLA policy.",
|
|
560
|
+
),
|
|
561
|
+
),
|
|
562
|
+
),
|
|
563
|
+
make_tool(
|
|
564
|
+
canonical_name="service-desk.sla.delete",
|
|
565
|
+
mcp_alias="kaiten_delete_sd_sla",
|
|
566
|
+
description="Delete a Service Desk SLA policy.",
|
|
567
|
+
input_schema={
|
|
568
|
+
"type": "object",
|
|
569
|
+
"properties": {"sla_id": {"type": "string", "description": "SLA ID (UUID)"}},
|
|
570
|
+
"required": ["sla_id"],
|
|
571
|
+
},
|
|
572
|
+
operation=OperationSpec(
|
|
573
|
+
method="DELETE", path_template="/service-desk/sla/{sla_id}", path_fields=("sla_id",)
|
|
574
|
+
),
|
|
575
|
+
examples=(
|
|
576
|
+
ExampleSpec(
|
|
577
|
+
command="kaiten --json service-desk sla delete --sla-id sla-1",
|
|
578
|
+
description="Delete an SLA policy.",
|
|
579
|
+
),
|
|
580
|
+
),
|
|
581
|
+
),
|
|
582
|
+
make_tool(
|
|
583
|
+
canonical_name="service-desk.template-answers.list",
|
|
584
|
+
mcp_alias="kaiten_list_sd_template_answers",
|
|
585
|
+
description="List Service Desk template answers.",
|
|
586
|
+
input_schema={"type": "object", "properties": {}},
|
|
587
|
+
operation=OperationSpec(method="GET", path_template="/service-desk/template-answers"),
|
|
588
|
+
examples=(
|
|
589
|
+
ExampleSpec(
|
|
590
|
+
command="kaiten --json service-desk template-answers list",
|
|
591
|
+
description="List template answers.",
|
|
592
|
+
),
|
|
593
|
+
),
|
|
594
|
+
),
|
|
595
|
+
make_tool(
|
|
596
|
+
canonical_name="service-desk.template-answers.get",
|
|
597
|
+
mcp_alias="kaiten_get_sd_template_answer",
|
|
598
|
+
description="Get a Service Desk template answer by ID.",
|
|
599
|
+
input_schema={
|
|
600
|
+
"type": "object",
|
|
601
|
+
"properties": {
|
|
602
|
+
"template_answer_id": {"type": "string", "description": "Template answer ID (UUID)"}
|
|
603
|
+
},
|
|
604
|
+
"required": ["template_answer_id"],
|
|
605
|
+
},
|
|
606
|
+
operation=OperationSpec(
|
|
607
|
+
method="GET",
|
|
608
|
+
path_template="/service-desk/template-answers/{template_answer_id}",
|
|
609
|
+
path_fields=("template_answer_id",),
|
|
610
|
+
),
|
|
611
|
+
examples=(
|
|
612
|
+
ExampleSpec(
|
|
613
|
+
command="kaiten --json service-desk template-answers get --template-answer-id ta-1",
|
|
614
|
+
description="Get a template answer.",
|
|
615
|
+
),
|
|
616
|
+
),
|
|
617
|
+
),
|
|
618
|
+
make_tool(
|
|
619
|
+
canonical_name="service-desk.template-answers.create",
|
|
620
|
+
mcp_alias="kaiten_create_sd_template_answer",
|
|
621
|
+
description="Create a Service Desk template answer.",
|
|
622
|
+
input_schema={
|
|
623
|
+
"type": "object",
|
|
624
|
+
"properties": {
|
|
625
|
+
"name": {"type": "string", "description": "Template name"},
|
|
626
|
+
"text": {"type": "string", "description": "Template answer text"},
|
|
627
|
+
},
|
|
628
|
+
"required": ["name", "text"],
|
|
629
|
+
},
|
|
630
|
+
operation=OperationSpec(
|
|
631
|
+
method="POST",
|
|
632
|
+
path_template="/service-desk/template-answers",
|
|
633
|
+
body_fields=("name", "text"),
|
|
634
|
+
),
|
|
635
|
+
examples=(
|
|
636
|
+
ExampleSpec(
|
|
637
|
+
command='kaiten --json service-desk template-answers create --name Hello --text "Hi"',
|
|
638
|
+
description="Create a template answer.",
|
|
639
|
+
),
|
|
640
|
+
),
|
|
641
|
+
),
|
|
642
|
+
make_tool(
|
|
643
|
+
canonical_name="service-desk.template-answers.update",
|
|
644
|
+
mcp_alias="kaiten_update_sd_template_answer",
|
|
645
|
+
description="Update a Service Desk template answer.",
|
|
646
|
+
input_schema={
|
|
647
|
+
"type": "object",
|
|
648
|
+
"properties": {
|
|
649
|
+
"template_answer_id": {
|
|
650
|
+
"type": "string",
|
|
651
|
+
"description": "Template answer ID (UUID)",
|
|
652
|
+
},
|
|
653
|
+
"name": {"type": "string", "description": "Template name"},
|
|
654
|
+
"text": {"type": "string", "description": "Template answer text"},
|
|
655
|
+
},
|
|
656
|
+
"required": ["template_answer_id"],
|
|
657
|
+
},
|
|
658
|
+
operation=OperationSpec(
|
|
659
|
+
method="PATCH",
|
|
660
|
+
path_template="/service-desk/template-answers/{template_answer_id}",
|
|
661
|
+
path_fields=("template_answer_id",),
|
|
662
|
+
body_fields=("name", "text"),
|
|
663
|
+
),
|
|
664
|
+
examples=(
|
|
665
|
+
ExampleSpec(
|
|
666
|
+
command='kaiten --json service-desk template-answers update --template-answer-id ta-1 --text "Hello"',
|
|
667
|
+
description="Update a template answer.",
|
|
668
|
+
),
|
|
669
|
+
),
|
|
670
|
+
),
|
|
671
|
+
make_tool(
|
|
672
|
+
canonical_name="service-desk.template-answers.delete",
|
|
673
|
+
mcp_alias="kaiten_delete_sd_template_answer",
|
|
674
|
+
description="Delete a Service Desk template answer.",
|
|
675
|
+
input_schema={
|
|
676
|
+
"type": "object",
|
|
677
|
+
"properties": {
|
|
678
|
+
"template_answer_id": {"type": "string", "description": "Template answer ID (UUID)"}
|
|
679
|
+
},
|
|
680
|
+
"required": ["template_answer_id"],
|
|
681
|
+
},
|
|
682
|
+
operation=OperationSpec(
|
|
683
|
+
method="DELETE",
|
|
684
|
+
path_template="/service-desk/template-answers/{template_answer_id}",
|
|
685
|
+
path_fields=("template_answer_id",),
|
|
686
|
+
),
|
|
687
|
+
examples=(
|
|
688
|
+
ExampleSpec(
|
|
689
|
+
command="kaiten --json service-desk template-answers delete --template-answer-id ta-1",
|
|
690
|
+
description="Delete a template answer.",
|
|
691
|
+
),
|
|
692
|
+
),
|
|
693
|
+
),
|
|
694
|
+
make_tool(
|
|
695
|
+
canonical_name="service-desk.sla-rules.create",
|
|
696
|
+
mcp_alias="kaiten_create_sla_rule",
|
|
697
|
+
description="Create a rule within an SLA policy.",
|
|
698
|
+
input_schema={
|
|
699
|
+
"type": "object",
|
|
700
|
+
"properties": {
|
|
701
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
702
|
+
"type": {"type": "string", "description": "Rule type"},
|
|
703
|
+
"calendar_id": {"type": "string", "description": "Calendar ID"},
|
|
704
|
+
"start_column_uid": {"type": "string", "description": "Start column UID"},
|
|
705
|
+
"finish_column_uid": {"type": "string", "description": "Finish column UID"},
|
|
706
|
+
"estimated_time": {"type": "integer", "description": "Target time in seconds"},
|
|
707
|
+
"notification_settings": {
|
|
708
|
+
"type": "object",
|
|
709
|
+
"description": "Notification configuration",
|
|
710
|
+
},
|
|
711
|
+
},
|
|
712
|
+
"required": ["sla_id"],
|
|
713
|
+
},
|
|
714
|
+
operation=OperationSpec(
|
|
715
|
+
method="POST",
|
|
716
|
+
path_template="/service-desk/sla/{sla_id}/rules",
|
|
717
|
+
path_fields=("sla_id",),
|
|
718
|
+
body_fields=(
|
|
719
|
+
"type",
|
|
720
|
+
"calendar_id",
|
|
721
|
+
"start_column_uid",
|
|
722
|
+
"finish_column_uid",
|
|
723
|
+
"estimated_time",
|
|
724
|
+
"notification_settings",
|
|
725
|
+
),
|
|
726
|
+
),
|
|
727
|
+
examples=(
|
|
728
|
+
ExampleSpec(
|
|
729
|
+
command="kaiten --json service-desk sla-rules create --sla-id sla-1 --type response",
|
|
730
|
+
description="Create an SLA rule.",
|
|
731
|
+
),
|
|
732
|
+
),
|
|
733
|
+
),
|
|
734
|
+
make_tool(
|
|
735
|
+
canonical_name="service-desk.sla-rules.update",
|
|
736
|
+
mcp_alias="kaiten_update_sla_rule",
|
|
737
|
+
description="Update a rule within an SLA policy.",
|
|
738
|
+
input_schema={
|
|
739
|
+
"type": "object",
|
|
740
|
+
"properties": {
|
|
741
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
742
|
+
"rule_id": {"type": "string", "description": "Rule ID"},
|
|
743
|
+
"type": {"type": "string", "description": "Rule type"},
|
|
744
|
+
"calendar_id": {"type": "string", "description": "Calendar ID"},
|
|
745
|
+
"start_column_uid": {"type": "string", "description": "Start column UID"},
|
|
746
|
+
"finish_column_uid": {"type": "string", "description": "Finish column UID"},
|
|
747
|
+
"estimated_time": {"type": "integer", "description": "Target time in seconds"},
|
|
748
|
+
"notification_settings": {
|
|
749
|
+
"type": "object",
|
|
750
|
+
"description": "Notification configuration",
|
|
751
|
+
},
|
|
752
|
+
},
|
|
753
|
+
"required": ["sla_id", "rule_id"],
|
|
754
|
+
},
|
|
755
|
+
operation=OperationSpec(
|
|
756
|
+
method="PATCH",
|
|
757
|
+
path_template="/service-desk/sla/{sla_id}/rules/{rule_id}",
|
|
758
|
+
path_fields=("sla_id", "rule_id"),
|
|
759
|
+
body_fields=(
|
|
760
|
+
"type",
|
|
761
|
+
"calendar_id",
|
|
762
|
+
"start_column_uid",
|
|
763
|
+
"finish_column_uid",
|
|
764
|
+
"estimated_time",
|
|
765
|
+
"notification_settings",
|
|
766
|
+
),
|
|
767
|
+
),
|
|
768
|
+
examples=(
|
|
769
|
+
ExampleSpec(
|
|
770
|
+
command="kaiten --json service-desk sla-rules update --sla-id sla-1 --rule-id rule-1 --estimated-time 60",
|
|
771
|
+
description="Update an SLA rule.",
|
|
772
|
+
),
|
|
773
|
+
),
|
|
774
|
+
),
|
|
775
|
+
make_tool(
|
|
776
|
+
canonical_name="service-desk.sla-rules.delete",
|
|
777
|
+
mcp_alias="kaiten_delete_sla_rule",
|
|
778
|
+
description="Delete a rule from an SLA policy.",
|
|
779
|
+
input_schema={
|
|
780
|
+
"type": "object",
|
|
781
|
+
"properties": {
|
|
782
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
783
|
+
"rule_id": {"type": "string", "description": "Rule ID"},
|
|
784
|
+
},
|
|
785
|
+
"required": ["sla_id", "rule_id"],
|
|
786
|
+
},
|
|
787
|
+
operation=OperationSpec(
|
|
788
|
+
method="DELETE",
|
|
789
|
+
path_template="/service-desk/sla/{sla_id}/rules/{rule_id}",
|
|
790
|
+
path_fields=("sla_id", "rule_id"),
|
|
791
|
+
),
|
|
792
|
+
examples=(
|
|
793
|
+
ExampleSpec(
|
|
794
|
+
command="kaiten --json service-desk sla-rules delete --sla-id sla-1 --rule-id rule-1",
|
|
795
|
+
description="Delete an SLA rule.",
|
|
796
|
+
),
|
|
797
|
+
),
|
|
798
|
+
),
|
|
799
|
+
make_tool(
|
|
800
|
+
canonical_name="service-desk.sla.recalculate",
|
|
801
|
+
mcp_alias="kaiten_recalculate_sla",
|
|
802
|
+
description="Trigger recalculation of SLA measurements.",
|
|
803
|
+
input_schema={
|
|
804
|
+
"type": "object",
|
|
805
|
+
"properties": {"sla_id": {"type": "string", "description": "SLA ID (UUID)"}},
|
|
806
|
+
"required": ["sla_id"],
|
|
807
|
+
},
|
|
808
|
+
operation=OperationSpec(
|
|
809
|
+
method="POST",
|
|
810
|
+
path_template="/service-desk/sla/{sla_id}/recalculate-measurements",
|
|
811
|
+
path_fields=("sla_id",),
|
|
812
|
+
),
|
|
813
|
+
examples=(
|
|
814
|
+
ExampleSpec(
|
|
815
|
+
command="kaiten --json service-desk sla recalculate --sla-id sla-1",
|
|
816
|
+
description="Recalculate SLA measurements.",
|
|
817
|
+
),
|
|
818
|
+
),
|
|
819
|
+
),
|
|
820
|
+
make_tool(
|
|
821
|
+
canonical_name="service-desk.users.list",
|
|
822
|
+
mcp_alias="kaiten_list_sd_users",
|
|
823
|
+
description="List Service Desk users.",
|
|
824
|
+
input_schema={
|
|
825
|
+
"type": "object",
|
|
826
|
+
"properties": {
|
|
827
|
+
"query": {"type": "string", "description": "Search filter"},
|
|
828
|
+
"limit": {"type": "integer", "description": "Max results"},
|
|
829
|
+
"offset": {"type": "integer", "description": "Pagination offset"},
|
|
830
|
+
"include_paid_users": {"type": "boolean", "description": "Include paid users"},
|
|
831
|
+
"include_all_sd_users": {"type": "boolean", "description": "Include all SD users"},
|
|
832
|
+
},
|
|
833
|
+
},
|
|
834
|
+
operation=OperationSpec(
|
|
835
|
+
method="GET",
|
|
836
|
+
path_template="/service-desk/users",
|
|
837
|
+
query_fields=("query", "limit", "offset", "include_paid_users", "include_all_sd_users"),
|
|
838
|
+
),
|
|
839
|
+
response_policy=ResponsePolicy(default_limit=DEFAULT_LIMIT, result_kind="list"),
|
|
840
|
+
examples=(
|
|
841
|
+
ExampleSpec(
|
|
842
|
+
command="kaiten --json service-desk users list",
|
|
843
|
+
description="List Service Desk users.",
|
|
844
|
+
),
|
|
845
|
+
),
|
|
846
|
+
),
|
|
847
|
+
make_tool(
|
|
848
|
+
canonical_name="service-desk.users.update",
|
|
849
|
+
mcp_alias="kaiten_update_sd_user",
|
|
850
|
+
description="Update a Service Desk user profile.",
|
|
851
|
+
input_schema={
|
|
852
|
+
"type": "object",
|
|
853
|
+
"properties": {
|
|
854
|
+
"user_id": {"type": "integer", "description": "User ID"},
|
|
855
|
+
"full_name": {"type": "string", "description": "User full name"},
|
|
856
|
+
"lng": {"type": "string", "description": "Language code"},
|
|
857
|
+
},
|
|
858
|
+
"required": ["user_id"],
|
|
859
|
+
},
|
|
860
|
+
operation=OperationSpec(
|
|
861
|
+
method="PATCH",
|
|
862
|
+
path_template="/service-desk/users/{user_id}",
|
|
863
|
+
path_fields=("user_id",),
|
|
864
|
+
body_fields=("full_name", "lng"),
|
|
865
|
+
),
|
|
866
|
+
examples=(
|
|
867
|
+
ExampleSpec(
|
|
868
|
+
command='kaiten --json service-desk users update --user-id 1 --full-name "Alice"',
|
|
869
|
+
description="Update a Service Desk user.",
|
|
870
|
+
),
|
|
871
|
+
),
|
|
872
|
+
),
|
|
873
|
+
make_tool(
|
|
874
|
+
canonical_name="service-desk.users.set-temp-password",
|
|
875
|
+
mcp_alias="kaiten_set_sd_user_temp_password",
|
|
876
|
+
description="Generate a temporary password for a Service Desk user.",
|
|
877
|
+
input_schema={
|
|
878
|
+
"type": "object",
|
|
879
|
+
"properties": {"user_id": {"type": "integer", "description": "User ID"}},
|
|
880
|
+
"required": ["user_id"],
|
|
881
|
+
},
|
|
882
|
+
operation=OperationSpec(
|
|
883
|
+
method="PATCH",
|
|
884
|
+
path_template="/service-desk/users/set-temporary-password/{user_id}",
|
|
885
|
+
path_fields=("user_id",),
|
|
886
|
+
),
|
|
887
|
+
examples=(
|
|
888
|
+
ExampleSpec(
|
|
889
|
+
command="kaiten --json service-desk users set-temp-password --user-id 1",
|
|
890
|
+
description="Generate a temporary password.",
|
|
891
|
+
),
|
|
892
|
+
),
|
|
893
|
+
),
|
|
894
|
+
make_tool(
|
|
895
|
+
canonical_name="service-desk.organization-users.add",
|
|
896
|
+
mcp_alias="kaiten_add_sd_org_user",
|
|
897
|
+
description="Add a user to a Service Desk organization.",
|
|
898
|
+
input_schema={
|
|
899
|
+
"type": "object",
|
|
900
|
+
"properties": {
|
|
901
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
902
|
+
"user_id": {"type": "integer", "description": "User ID"},
|
|
903
|
+
"permissions": {"type": "integer", "description": "Permission bitmask"},
|
|
904
|
+
},
|
|
905
|
+
"required": ["organization_id", "user_id"],
|
|
906
|
+
},
|
|
907
|
+
operation=OperationSpec(
|
|
908
|
+
method="POST",
|
|
909
|
+
path_template="/service-desk/organizations/{organization_id}/users",
|
|
910
|
+
path_fields=("organization_id",),
|
|
911
|
+
body_fields=("user_id", "permissions"),
|
|
912
|
+
),
|
|
913
|
+
examples=(
|
|
914
|
+
ExampleSpec(
|
|
915
|
+
command="kaiten --json service-desk organization-users add --organization-id 1 --user-id 2",
|
|
916
|
+
description="Add an organization user.",
|
|
917
|
+
),
|
|
918
|
+
),
|
|
919
|
+
),
|
|
920
|
+
make_tool(
|
|
921
|
+
canonical_name="service-desk.organization-users.update",
|
|
922
|
+
mcp_alias="kaiten_update_sd_org_user",
|
|
923
|
+
description="Update a user's permissions in a Service Desk organization.",
|
|
924
|
+
input_schema={
|
|
925
|
+
"type": "object",
|
|
926
|
+
"properties": {
|
|
927
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
928
|
+
"user_id": {"type": "integer", "description": "User ID"},
|
|
929
|
+
"permissions": {"type": "integer", "description": "Permission bitmask"},
|
|
930
|
+
},
|
|
931
|
+
"required": ["organization_id", "user_id"],
|
|
932
|
+
},
|
|
933
|
+
operation=OperationSpec(
|
|
934
|
+
method="PATCH",
|
|
935
|
+
path_template="/service-desk/organizations/{organization_id}/users/{user_id}",
|
|
936
|
+
path_fields=("organization_id", "user_id"),
|
|
937
|
+
body_fields=("permissions",),
|
|
938
|
+
),
|
|
939
|
+
examples=(
|
|
940
|
+
ExampleSpec(
|
|
941
|
+
command="kaiten --json service-desk organization-users update --organization-id 1 --user-id 2 --permissions 7",
|
|
942
|
+
description="Update organization-user permissions.",
|
|
943
|
+
),
|
|
944
|
+
),
|
|
945
|
+
),
|
|
946
|
+
make_tool(
|
|
947
|
+
canonical_name="service-desk.organization-users.remove",
|
|
948
|
+
mcp_alias="kaiten_remove_sd_org_user",
|
|
949
|
+
description="Remove a user from a Service Desk organization.",
|
|
950
|
+
input_schema={
|
|
951
|
+
"type": "object",
|
|
952
|
+
"properties": {
|
|
953
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
954
|
+
"user_id": {"type": "integer", "description": "User ID"},
|
|
955
|
+
},
|
|
956
|
+
"required": ["organization_id", "user_id"],
|
|
957
|
+
},
|
|
958
|
+
operation=OperationSpec(
|
|
959
|
+
method="DELETE",
|
|
960
|
+
path_template="/service-desk/organizations/{organization_id}/users/{user_id}",
|
|
961
|
+
path_fields=("organization_id", "user_id"),
|
|
962
|
+
),
|
|
963
|
+
examples=(
|
|
964
|
+
ExampleSpec(
|
|
965
|
+
command="kaiten --json service-desk organization-users remove --organization-id 1 --user-id 2",
|
|
966
|
+
description="Remove an organization user.",
|
|
967
|
+
),
|
|
968
|
+
),
|
|
969
|
+
),
|
|
970
|
+
make_tool(
|
|
971
|
+
canonical_name="service-desk.organization-users.batch-add",
|
|
972
|
+
mcp_alias="kaiten_batch_add_sd_org_users",
|
|
973
|
+
description="Add multiple users to a Service Desk organization.",
|
|
974
|
+
input_schema={
|
|
975
|
+
"type": "object",
|
|
976
|
+
"properties": {
|
|
977
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
978
|
+
"user_ids": {
|
|
979
|
+
"type": "array",
|
|
980
|
+
"items": {"type": "integer"},
|
|
981
|
+
"description": "User IDs",
|
|
982
|
+
},
|
|
983
|
+
},
|
|
984
|
+
"required": ["organization_id", "user_ids"],
|
|
985
|
+
},
|
|
986
|
+
operation=OperationSpec(
|
|
987
|
+
method="PATCH",
|
|
988
|
+
path_template="/service-desk/organizations/{organization_id}/users",
|
|
989
|
+
path_fields=("organization_id",),
|
|
990
|
+
body_fields=("user_ids",),
|
|
991
|
+
),
|
|
992
|
+
examples=(
|
|
993
|
+
ExampleSpec(
|
|
994
|
+
command="kaiten --json service-desk organization-users batch-add --organization-id 1 --user-ids '[1,2]'",
|
|
995
|
+
description="Batch-add organization users.",
|
|
996
|
+
),
|
|
997
|
+
),
|
|
998
|
+
),
|
|
999
|
+
make_tool(
|
|
1000
|
+
canonical_name="service-desk.organization-users.batch-remove",
|
|
1001
|
+
mcp_alias="kaiten_batch_remove_sd_org_users",
|
|
1002
|
+
description="Remove multiple users from a Service Desk organization.",
|
|
1003
|
+
input_schema={
|
|
1004
|
+
"type": "object",
|
|
1005
|
+
"properties": {
|
|
1006
|
+
"organization_id": {"type": "integer", "description": "Organization ID"},
|
|
1007
|
+
"user_ids": {
|
|
1008
|
+
"type": "array",
|
|
1009
|
+
"items": {"type": "integer"},
|
|
1010
|
+
"description": "User IDs",
|
|
1011
|
+
},
|
|
1012
|
+
},
|
|
1013
|
+
"required": ["organization_id", "user_ids"],
|
|
1014
|
+
},
|
|
1015
|
+
operation=OperationSpec(
|
|
1016
|
+
method="DELETE",
|
|
1017
|
+
path_template="/service-desk/organizations/{organization_id}/users",
|
|
1018
|
+
path_fields=("organization_id",),
|
|
1019
|
+
body_fields=("user_ids",),
|
|
1020
|
+
),
|
|
1021
|
+
examples=(
|
|
1022
|
+
ExampleSpec(
|
|
1023
|
+
command="kaiten --json service-desk organization-users batch-remove --organization-id 1 --user-ids '[1,2]'",
|
|
1024
|
+
description="Batch-remove organization users.",
|
|
1025
|
+
),
|
|
1026
|
+
),
|
|
1027
|
+
),
|
|
1028
|
+
make_tool(
|
|
1029
|
+
canonical_name="service-desk.settings.get",
|
|
1030
|
+
mcp_alias="kaiten_get_sd_settings",
|
|
1031
|
+
description="Get current Service Desk settings.",
|
|
1032
|
+
input_schema={"type": "object", "properties": {}},
|
|
1033
|
+
operation=OperationSpec(method="GET", path_template="/sd-settings/current"),
|
|
1034
|
+
examples=(
|
|
1035
|
+
ExampleSpec(
|
|
1036
|
+
command="kaiten --json service-desk settings get",
|
|
1037
|
+
description="Get Service Desk settings.",
|
|
1038
|
+
),
|
|
1039
|
+
),
|
|
1040
|
+
),
|
|
1041
|
+
make_tool(
|
|
1042
|
+
canonical_name="service-desk.settings.update",
|
|
1043
|
+
mcp_alias="kaiten_update_sd_settings",
|
|
1044
|
+
description="Update Service Desk settings.",
|
|
1045
|
+
input_schema={
|
|
1046
|
+
"type": "object",
|
|
1047
|
+
"properties": {
|
|
1048
|
+
"service_desk_settings": {
|
|
1049
|
+
"type": "object",
|
|
1050
|
+
"description": "Service Desk configuration object",
|
|
1051
|
+
}
|
|
1052
|
+
},
|
|
1053
|
+
"required": ["service_desk_settings"],
|
|
1054
|
+
},
|
|
1055
|
+
operation=OperationSpec(
|
|
1056
|
+
method="PATCH",
|
|
1057
|
+
path_template="/sd-settings/current",
|
|
1058
|
+
body_fields=("service_desk_settings",),
|
|
1059
|
+
),
|
|
1060
|
+
examples=(
|
|
1061
|
+
ExampleSpec(
|
|
1062
|
+
command="kaiten --json service-desk settings update --service-desk-settings '{}'",
|
|
1063
|
+
description="Update Service Desk settings.",
|
|
1064
|
+
),
|
|
1065
|
+
),
|
|
1066
|
+
),
|
|
1067
|
+
make_tool(
|
|
1068
|
+
canonical_name="service-desk.stats.get",
|
|
1069
|
+
mcp_alias="kaiten_get_sd_stats",
|
|
1070
|
+
description="Get Service Desk statistics.",
|
|
1071
|
+
input_schema={
|
|
1072
|
+
"type": "object",
|
|
1073
|
+
"properties": {
|
|
1074
|
+
"date_from": {"type": "string", "description": "Start date (ISO format)"},
|
|
1075
|
+
"date_to": {"type": "string", "description": "End date (ISO format)"},
|
|
1076
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
1077
|
+
"report": {"type": "boolean", "description": "Enable report mode"},
|
|
1078
|
+
},
|
|
1079
|
+
},
|
|
1080
|
+
operation=OperationSpec(
|
|
1081
|
+
method="GET",
|
|
1082
|
+
path_template="/service-desk/stats",
|
|
1083
|
+
query_fields=("date_from", "date_to", "service_id", "report"),
|
|
1084
|
+
),
|
|
1085
|
+
runtime_behavior=RuntimeBehavior(request_shaper=service_desk_stats_query_request),
|
|
1086
|
+
examples=(
|
|
1087
|
+
ExampleSpec(
|
|
1088
|
+
command="kaiten --json service-desk stats get --date-from 2026-01-01",
|
|
1089
|
+
description="Get Service Desk statistics.",
|
|
1090
|
+
),
|
|
1091
|
+
),
|
|
1092
|
+
),
|
|
1093
|
+
make_tool(
|
|
1094
|
+
canonical_name="service-desk.sla.stats",
|
|
1095
|
+
mcp_alias="kaiten_get_sd_sla_stats",
|
|
1096
|
+
description="Get Service Desk SLA statistics.",
|
|
1097
|
+
input_schema={
|
|
1098
|
+
"type": "object",
|
|
1099
|
+
"properties": {
|
|
1100
|
+
"date_from": {"type": "string", "description": "Start date (ISO format)"},
|
|
1101
|
+
"date_to": {"type": "string", "description": "End date (ISO format)"},
|
|
1102
|
+
"sla_id": {"type": "string", "description": "SLA ID"},
|
|
1103
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
1104
|
+
"responsible_id": {"type": "integer", "description": "Responsible user ID"},
|
|
1105
|
+
"card_type_ids": {"type": "string", "description": "JSON array of card type IDs"},
|
|
1106
|
+
"tag_ids": {"type": "string", "description": "JSON array of tag IDs"},
|
|
1107
|
+
},
|
|
1108
|
+
},
|
|
1109
|
+
operation=OperationSpec(
|
|
1110
|
+
method="GET",
|
|
1111
|
+
path_template="/service-desk/sla-stats",
|
|
1112
|
+
query_fields=(
|
|
1113
|
+
"date_from",
|
|
1114
|
+
"date_to",
|
|
1115
|
+
"sla_id",
|
|
1116
|
+
"service_id",
|
|
1117
|
+
"responsible_id",
|
|
1118
|
+
"card_type_ids",
|
|
1119
|
+
"tag_ids",
|
|
1120
|
+
),
|
|
1121
|
+
),
|
|
1122
|
+
response_policy=ResponsePolicy(heavy=True),
|
|
1123
|
+
examples=(
|
|
1124
|
+
ExampleSpec(
|
|
1125
|
+
command="kaiten --json service-desk sla stats --sla-id sla-1",
|
|
1126
|
+
description="Get Service Desk SLA statistics.",
|
|
1127
|
+
),
|
|
1128
|
+
),
|
|
1129
|
+
),
|
|
1130
|
+
make_tool(
|
|
1131
|
+
canonical_name="service-desk.vote-properties.add",
|
|
1132
|
+
mcp_alias="kaiten_add_service_vote_property",
|
|
1133
|
+
description="Add a custom property as a vote property for a Service Desk service.",
|
|
1134
|
+
input_schema={
|
|
1135
|
+
"type": "object",
|
|
1136
|
+
"properties": {
|
|
1137
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
1138
|
+
"id": {"type": "integer", "description": "Custom property ID"},
|
|
1139
|
+
},
|
|
1140
|
+
"required": ["service_id", "id"],
|
|
1141
|
+
},
|
|
1142
|
+
operation=OperationSpec(
|
|
1143
|
+
method="POST",
|
|
1144
|
+
path_template="/service-desk/services/{service_id}/vote-properties",
|
|
1145
|
+
path_fields=("service_id",),
|
|
1146
|
+
body_fields=("id",),
|
|
1147
|
+
),
|
|
1148
|
+
examples=(
|
|
1149
|
+
ExampleSpec(
|
|
1150
|
+
command="kaiten --json service-desk vote-properties add --service-id 1 --id 2",
|
|
1151
|
+
description="Add a vote property.",
|
|
1152
|
+
),
|
|
1153
|
+
),
|
|
1154
|
+
),
|
|
1155
|
+
make_tool(
|
|
1156
|
+
canonical_name="service-desk.vote-properties.remove",
|
|
1157
|
+
mcp_alias="kaiten_remove_service_vote_property",
|
|
1158
|
+
description="Remove a vote property from a Service Desk service.",
|
|
1159
|
+
input_schema={
|
|
1160
|
+
"type": "object",
|
|
1161
|
+
"properties": {
|
|
1162
|
+
"service_id": {"type": "integer", "description": "Service ID"},
|
|
1163
|
+
"property_id": {"type": "integer", "description": "Vote property ID"},
|
|
1164
|
+
},
|
|
1165
|
+
"required": ["service_id", "property_id"],
|
|
1166
|
+
},
|
|
1167
|
+
operation=OperationSpec(
|
|
1168
|
+
method="DELETE",
|
|
1169
|
+
path_template="/service-desk/services/{service_id}/vote-properties/{property_id}",
|
|
1170
|
+
path_fields=("service_id", "property_id"),
|
|
1171
|
+
),
|
|
1172
|
+
examples=(
|
|
1173
|
+
ExampleSpec(
|
|
1174
|
+
command="kaiten --json service-desk vote-properties remove --service-id 1 --property-id 2",
|
|
1175
|
+
description="Remove a vote property.",
|
|
1176
|
+
),
|
|
1177
|
+
),
|
|
1178
|
+
),
|
|
1179
|
+
make_tool(
|
|
1180
|
+
canonical_name="card-slas.attach",
|
|
1181
|
+
mcp_alias="kaiten_attach_card_sla",
|
|
1182
|
+
description="Attach an SLA policy to a card.",
|
|
1183
|
+
input_schema={
|
|
1184
|
+
"type": "object",
|
|
1185
|
+
"properties": {
|
|
1186
|
+
"card_id": {"type": "integer", "description": "Card ID"},
|
|
1187
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
1188
|
+
},
|
|
1189
|
+
"required": ["card_id", "sla_id"],
|
|
1190
|
+
},
|
|
1191
|
+
operation=OperationSpec(
|
|
1192
|
+
method="POST",
|
|
1193
|
+
path_template="/cards/{card_id}/slas",
|
|
1194
|
+
path_fields=("card_id",),
|
|
1195
|
+
body_fields=("sla_id",),
|
|
1196
|
+
),
|
|
1197
|
+
examples=(
|
|
1198
|
+
ExampleSpec(
|
|
1199
|
+
command="kaiten --json card-slas attach --card-id 1 --sla-id sla-1",
|
|
1200
|
+
description="Attach an SLA to a card.",
|
|
1201
|
+
),
|
|
1202
|
+
),
|
|
1203
|
+
),
|
|
1204
|
+
make_tool(
|
|
1205
|
+
canonical_name="card-slas.detach",
|
|
1206
|
+
mcp_alias="kaiten_detach_card_sla",
|
|
1207
|
+
description="Detach an SLA policy from a card.",
|
|
1208
|
+
input_schema={
|
|
1209
|
+
"type": "object",
|
|
1210
|
+
"properties": {
|
|
1211
|
+
"card_id": {"type": "integer", "description": "Card ID"},
|
|
1212
|
+
"sla_id": {"type": "string", "description": "SLA ID (UUID)"},
|
|
1213
|
+
},
|
|
1214
|
+
"required": ["card_id", "sla_id"],
|
|
1215
|
+
},
|
|
1216
|
+
operation=OperationSpec(
|
|
1217
|
+
method="DELETE",
|
|
1218
|
+
path_template="/cards/{card_id}/slas/{sla_id}",
|
|
1219
|
+
path_fields=("card_id", "sla_id"),
|
|
1220
|
+
),
|
|
1221
|
+
examples=(
|
|
1222
|
+
ExampleSpec(
|
|
1223
|
+
command="kaiten --json card-slas detach --card-id 1 --sla-id sla-1",
|
|
1224
|
+
description="Detach an SLA from a card.",
|
|
1225
|
+
),
|
|
1226
|
+
),
|
|
1227
|
+
),
|
|
1228
|
+
make_tool(
|
|
1229
|
+
canonical_name="card-sla-measurements.get",
|
|
1230
|
+
mcp_alias="kaiten_get_card_sla_measurements",
|
|
1231
|
+
description="Get SLA rule measurements for a card.",
|
|
1232
|
+
input_schema={
|
|
1233
|
+
"type": "object",
|
|
1234
|
+
"properties": {"card_id": {"type": "integer", "description": "Card ID"}},
|
|
1235
|
+
"required": ["card_id"],
|
|
1236
|
+
},
|
|
1237
|
+
operation=OperationSpec(
|
|
1238
|
+
method="GET",
|
|
1239
|
+
path_template="/cards/{card_id}/sla-rules-measurements",
|
|
1240
|
+
path_fields=("card_id",),
|
|
1241
|
+
),
|
|
1242
|
+
examples=(
|
|
1243
|
+
ExampleSpec(
|
|
1244
|
+
command="kaiten --json card-sla-measurements get --card-id 1",
|
|
1245
|
+
description="Get card SLA measurements.",
|
|
1246
|
+
),
|
|
1247
|
+
),
|
|
1248
|
+
),
|
|
1249
|
+
make_tool(
|
|
1250
|
+
canonical_name="space-sla-measurements.get",
|
|
1251
|
+
mcp_alias="kaiten_get_space_sla_measurements",
|
|
1252
|
+
description="Get SLA rule measurements for all cards in a space.",
|
|
1253
|
+
input_schema={
|
|
1254
|
+
"type": "object",
|
|
1255
|
+
"properties": {"space_id": {"type": "integer", "description": "Space ID"}},
|
|
1256
|
+
"required": ["space_id"],
|
|
1257
|
+
},
|
|
1258
|
+
operation=OperationSpec(
|
|
1259
|
+
method="GET",
|
|
1260
|
+
path_template="/spaces/{space_id}/sla-rules-measurements",
|
|
1261
|
+
path_fields=("space_id",),
|
|
1262
|
+
),
|
|
1263
|
+
examples=(
|
|
1264
|
+
ExampleSpec(
|
|
1265
|
+
command="kaiten --json space-sla-measurements get --space-id 1",
|
|
1266
|
+
description="Get space SLA measurements.",
|
|
1267
|
+
),
|
|
1268
|
+
),
|
|
1269
|
+
),
|
|
1270
|
+
)
|