@probelabs/visor 0.1.173 → 0.1.174-ee

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 (105) hide show
  1. package/dist/docs/dashboards/README.md +73 -26
  2. package/dist/docs/dashboards/grafana-visor-overview.json +435 -15
  3. package/dist/docs/telemetry-reference.md +387 -0
  4. package/dist/docs/telemetry-setup.md +2 -0
  5. package/dist/generated/config-schema.d.ts +277 -7
  6. package/dist/generated/config-schema.d.ts.map +1 -1
  7. package/dist/generated/config-schema.json +3803 -0
  8. package/dist/index.js +2202 -51
  9. package/dist/sdk/{a2a-frontend-VHOQ45CR.mjs → a2a-frontend-FUJRKHJB.mjs} +3 -3
  10. package/dist/sdk/{check-provider-registry-65GO3SCO.mjs → check-provider-registry-53C2ZIXJ.mjs} +7 -7
  11. package/dist/sdk/{check-provider-registry-75O5XJMA.mjs → check-provider-registry-UPQNHHFF.mjs} +7 -7
  12. package/dist/sdk/{chunk-Y5MEQW2W.mjs → chunk-2PL2YH3B.mjs} +19 -19
  13. package/dist/sdk/{chunk-4TV2CVVI.mjs → chunk-34QX63WK.mjs} +16 -14
  14. package/dist/sdk/chunk-34QX63WK.mjs.map +1 -0
  15. package/dist/sdk/{chunk-2HXOGRAS.mjs → chunk-65SHRIQF.mjs} +3 -3
  16. package/dist/sdk/{chunk-2HXOGRAS.mjs.map → chunk-65SHRIQF.mjs.map} +1 -1
  17. package/dist/sdk/{chunk-VVHALCWV.mjs → chunk-EFNNJIMY.mjs} +3 -3
  18. package/dist/sdk/{chunk-7CWJNSL2.mjs → chunk-GKSSG5IM.mjs} +20 -20
  19. package/dist/sdk/{chunk-7CWJNSL2.mjs.map → chunk-GKSSG5IM.mjs.map} +1 -1
  20. package/dist/sdk/{chunk-HZEXCJGA.mjs → chunk-W4KCJM6J.mjs} +282 -8
  21. package/dist/sdk/chunk-W4KCJM6J.mjs.map +1 -0
  22. package/dist/sdk/{chunk-GVPMO6QD.mjs → chunk-WJIV7MKY.mjs} +3 -3
  23. package/dist/sdk/{config-UXRHADSE.mjs → config-BVL3KFMB.mjs} +2 -2
  24. package/dist/sdk/{failure-condition-evaluator-Q4KNMX6F.mjs → failure-condition-evaluator-DL6H57NX.mjs} +4 -4
  25. package/dist/sdk/{github-frontend-56UQTA47.mjs → github-frontend-F2YCPK6H.mjs} +4 -4
  26. package/dist/sdk/{host-QRGXXRDA.mjs → host-6TBS44ER.mjs} +3 -3
  27. package/dist/sdk/{host-VYPJ2UGQ.mjs → host-LRWIKURZ.mjs} +3 -3
  28. package/dist/sdk/knex-store-QCEW4I4R.mjs +527 -0
  29. package/dist/sdk/knex-store-QCEW4I4R.mjs.map +1 -0
  30. package/dist/sdk/loader-Q7K76ZIY.mjs +89 -0
  31. package/dist/sdk/loader-Q7K76ZIY.mjs.map +1 -0
  32. package/dist/sdk/{metrics-FU2G5SZ2.mjs → metrics-JTOG2HNO.mjs} +2 -2
  33. package/dist/sdk/opa-policy-engine-QCSSIMUF.mjs +655 -0
  34. package/dist/sdk/opa-policy-engine-QCSSIMUF.mjs.map +1 -0
  35. package/dist/sdk/{routing-DBQHPP2O.mjs → routing-GF2CF3JT.mjs} +5 -5
  36. package/dist/sdk/{schedule-tool-MHICRNCI.mjs → schedule-tool-5KDBDCFO.mjs} +7 -7
  37. package/dist/sdk/{schedule-tool-VRLX54J5.mjs → schedule-tool-UMDRCNO5.mjs} +7 -7
  38. package/dist/sdk/{schedule-tool-handler-3ES4WON7.mjs → schedule-tool-handler-5EPTHBLS.mjs} +7 -7
  39. package/dist/sdk/{schedule-tool-handler-FQGAWC5N.mjs → schedule-tool-handler-MUF5V36L.mjs} +7 -7
  40. package/dist/sdk/sdk.d.mts +137 -133
  41. package/dist/sdk/sdk.d.ts +137 -133
  42. package/dist/sdk/sdk.js +1952 -302
  43. package/dist/sdk/sdk.js.map +1 -1
  44. package/dist/sdk/sdk.mjs +6 -6
  45. package/dist/sdk/{trace-helpers-UKMYHQIK.mjs → trace-helpers-FKM2MEDW.mjs} +3 -3
  46. package/dist/sdk/validator-XTZJZZJH.mjs +134 -0
  47. package/dist/sdk/validator-XTZJZZJH.mjs.map +1 -0
  48. package/dist/sdk/{workflow-check-provider-F5DTEX6E.mjs → workflow-check-provider-EWMZEEES.mjs} +7 -7
  49. package/dist/sdk/{workflow-check-provider-VEOVTCVU.mjs → workflow-check-provider-RQUCBAYY.mjs} +7 -7
  50. package/dist/telemetry/metrics.d.ts.map +1 -1
  51. package/dist/types/config.d.ts +5 -4
  52. package/dist/types/config.d.ts.map +1 -1
  53. package/package.json +2 -2
  54. package/dist/output/traces/run-2026-03-09T15-21-25-122Z.ndjson +0 -138
  55. package/dist/output/traces/run-2026-03-09T15-22-05-255Z.ndjson +0 -2280
  56. package/dist/sdk/a2a-frontend-7CYN3X7M.mjs +0 -1658
  57. package/dist/sdk/a2a-frontend-VHOQ45CR.mjs.map +0 -1
  58. package/dist/sdk/check-provider-registry-DBTS7OXY.mjs +0 -30
  59. package/dist/sdk/chunk-4TV2CVVI.mjs.map +0 -1
  60. package/dist/sdk/chunk-AV6KML52.mjs +0 -45016
  61. package/dist/sdk/chunk-AV6KML52.mjs.map +0 -1
  62. package/dist/sdk/chunk-HZEXCJGA.mjs.map +0 -1
  63. package/dist/sdk/chunk-LTHHE6Z5.mjs +0 -516
  64. package/dist/sdk/chunk-LTHHE6Z5.mjs.map +0 -1
  65. package/dist/sdk/chunk-VK7FUBBU.mjs +0 -739
  66. package/dist/sdk/chunk-VVHALCWV.mjs.map +0 -1
  67. package/dist/sdk/chunk-WYFQQ445.mjs +0 -1502
  68. package/dist/sdk/chunk-WYFQQ445.mjs.map +0 -1
  69. package/dist/sdk/failure-condition-evaluator-SNR5XLGN.mjs +0 -18
  70. package/dist/sdk/github-frontend-OOP26667.mjs +0 -1386
  71. package/dist/sdk/github-frontend-OOP26667.mjs.map +0 -1
  72. package/dist/sdk/routing-ZAUCS3HJ.mjs +0 -26
  73. package/dist/sdk/schedule-tool-2FIVKPVJ.mjs +0 -36
  74. package/dist/sdk/schedule-tool-handler-FQGAWC5N.mjs.map +0 -1
  75. package/dist/sdk/schedule-tool-handler-KYUHU4JR.mjs +0 -40
  76. package/dist/sdk/schedule-tool-handler-KYUHU4JR.mjs.map +0 -1
  77. package/dist/sdk/trace-helpers-UKMYHQIK.mjs.map +0 -1
  78. package/dist/sdk/trace-helpers-ZFDJ55SH.mjs +0 -29
  79. package/dist/sdk/trace-helpers-ZFDJ55SH.mjs.map +0 -1
  80. package/dist/sdk/workflow-check-provider-5KQTXKWS.mjs +0 -30
  81. package/dist/sdk/workflow-check-provider-5KQTXKWS.mjs.map +0 -1
  82. package/dist/sdk/workflow-check-provider-F5DTEX6E.mjs.map +0 -1
  83. package/dist/sdk/workflow-check-provider-VEOVTCVU.mjs.map +0 -1
  84. package/dist/traces/run-2026-03-09T15-21-25-122Z.ndjson +0 -138
  85. package/dist/traces/run-2026-03-09T15-22-05-255Z.ndjson +0 -2280
  86. /package/dist/sdk/{a2a-frontend-7CYN3X7M.mjs.map → a2a-frontend-FUJRKHJB.mjs.map} +0 -0
  87. /package/dist/sdk/{check-provider-registry-65GO3SCO.mjs.map → check-provider-registry-53C2ZIXJ.mjs.map} +0 -0
  88. /package/dist/sdk/{check-provider-registry-75O5XJMA.mjs.map → check-provider-registry-UPQNHHFF.mjs.map} +0 -0
  89. /package/dist/sdk/{chunk-Y5MEQW2W.mjs.map → chunk-2PL2YH3B.mjs.map} +0 -0
  90. /package/dist/sdk/{chunk-VK7FUBBU.mjs.map → chunk-EFNNJIMY.mjs.map} +0 -0
  91. /package/dist/sdk/{chunk-GVPMO6QD.mjs.map → chunk-WJIV7MKY.mjs.map} +0 -0
  92. /package/dist/sdk/{check-provider-registry-DBTS7OXY.mjs.map → config-BVL3KFMB.mjs.map} +0 -0
  93. /package/dist/sdk/{config-UXRHADSE.mjs.map → failure-condition-evaluator-DL6H57NX.mjs.map} +0 -0
  94. /package/dist/sdk/{github-frontend-56UQTA47.mjs.map → github-frontend-F2YCPK6H.mjs.map} +0 -0
  95. /package/dist/sdk/{host-QRGXXRDA.mjs.map → host-6TBS44ER.mjs.map} +0 -0
  96. /package/dist/sdk/{host-VYPJ2UGQ.mjs.map → host-LRWIKURZ.mjs.map} +0 -0
  97. /package/dist/sdk/{failure-condition-evaluator-Q4KNMX6F.mjs.map → metrics-JTOG2HNO.mjs.map} +0 -0
  98. /package/dist/sdk/{failure-condition-evaluator-SNR5XLGN.mjs.map → routing-GF2CF3JT.mjs.map} +0 -0
  99. /package/dist/sdk/{metrics-FU2G5SZ2.mjs.map → schedule-tool-5KDBDCFO.mjs.map} +0 -0
  100. /package/dist/sdk/{routing-DBQHPP2O.mjs.map → schedule-tool-UMDRCNO5.mjs.map} +0 -0
  101. /package/dist/sdk/{routing-ZAUCS3HJ.mjs.map → schedule-tool-handler-5EPTHBLS.mjs.map} +0 -0
  102. /package/dist/sdk/{schedule-tool-2FIVKPVJ.mjs.map → schedule-tool-handler-MUF5V36L.mjs.map} +0 -0
  103. /package/dist/sdk/{schedule-tool-MHICRNCI.mjs.map → trace-helpers-FKM2MEDW.mjs.map} +0 -0
  104. /package/dist/sdk/{schedule-tool-VRLX54J5.mjs.map → workflow-check-provider-EWMZEEES.mjs.map} +0 -0
  105. /package/dist/sdk/{schedule-tool-handler-3ES4WON7.mjs.map → workflow-check-provider-RQUCBAYY.mjs.map} +0 -0
@@ -0,0 +1,3803 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$ref": "#/definitions/VisorConfigSchema",
4
+ "definitions": {
5
+ "VisorConfigSchema": {
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "properties": {
9
+ "hooks": {
10
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
11
+ },
12
+ "version": {
13
+ "type": "string",
14
+ "description": "Configuration version"
15
+ },
16
+ "extends": {
17
+ "anyOf": [
18
+ {
19
+ "type": "string"
20
+ },
21
+ {
22
+ "type": "array",
23
+ "items": {
24
+ "type": "string"
25
+ }
26
+ }
27
+ ],
28
+ "description": "Extends from other configurations - can be file path, HTTP(S) URL, or \"default\""
29
+ },
30
+ "include": {
31
+ "anyOf": [
32
+ {
33
+ "type": "string"
34
+ },
35
+ {
36
+ "type": "array",
37
+ "items": {
38
+ "type": "string"
39
+ }
40
+ }
41
+ ],
42
+ "description": "Alias for extends - include from other configurations (backward compatibility)"
43
+ },
44
+ "tools": {
45
+ "$ref": "#/definitions/Record%3Cstring%2CCustomToolDefinition%3E",
46
+ "description": "Custom tool definitions that can be used in MCP blocks"
47
+ },
48
+ "imports": {
49
+ "type": "array",
50
+ "items": {
51
+ "type": "string"
52
+ },
53
+ "description": "Import workflow definitions from external files or URLs"
54
+ },
55
+ "inputs": {
56
+ "type": "array",
57
+ "items": {
58
+ "$ref": "#/definitions/WorkflowInput"
59
+ },
60
+ "description": "Workflow inputs (for standalone reusable workflows)"
61
+ },
62
+ "outputs": {
63
+ "type": "array",
64
+ "items": {
65
+ "$ref": "#/definitions/WorkflowOutput"
66
+ },
67
+ "description": "Workflow outputs (for standalone reusable workflows)"
68
+ },
69
+ "steps": {
70
+ "$ref": "#/definitions/Record%3Cstring%2CCheckConfig%3E",
71
+ "description": "Step configurations (recommended)"
72
+ },
73
+ "checks": {
74
+ "$ref": "#/definitions/Record%3Cstring%2CCheckConfig%3E",
75
+ "description": "Check configurations (legacy, use 'steps' instead) - always populated after normalization"
76
+ },
77
+ "output": {
78
+ "$ref": "#/definitions/OutputConfig",
79
+ "description": "Output configuration (optional - defaults provided)"
80
+ },
81
+ "http_server": {
82
+ "$ref": "#/definitions/HttpServerConfig",
83
+ "description": "HTTP server configuration for receiving webhooks"
84
+ },
85
+ "memory": {
86
+ "$ref": "#/definitions/MemoryConfig",
87
+ "description": "Memory storage configuration"
88
+ },
89
+ "env": {
90
+ "$ref": "#/definitions/EnvConfig",
91
+ "description": "Global environment variables"
92
+ },
93
+ "ai_model": {
94
+ "type": "string",
95
+ "description": "Global AI model setting"
96
+ },
97
+ "ai_provider": {
98
+ "type": "string",
99
+ "description": "Global AI provider setting"
100
+ },
101
+ "ai_mcp_servers": {
102
+ "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
103
+ "description": "Global MCP servers configuration for AI checks"
104
+ },
105
+ "max_parallelism": {
106
+ "type": "number",
107
+ "description": "Maximum number of checks to run in parallel (default: 3)"
108
+ },
109
+ "max_ai_concurrency": {
110
+ "type": "number",
111
+ "description": "Maximum total concurrent AI API calls across all checks (default: unlimited). When set, creates a shared concurrency limiter that gates every LLM request across all ProbeAgent instances in this run."
112
+ },
113
+ "fail_fast": {
114
+ "type": "boolean",
115
+ "description": "Stop execution when any check fails (default: false)"
116
+ },
117
+ "fail_if": {
118
+ "type": "string",
119
+ "description": "Simple global fail condition - fails if expression evaluates to true"
120
+ },
121
+ "failure_conditions": {
122
+ "$ref": "#/definitions/FailureConditions",
123
+ "description": "Global failure conditions - optional (deprecated, use fail_if)"
124
+ },
125
+ "tag_filter": {
126
+ "$ref": "#/definitions/TagFilter",
127
+ "description": "Tag filter for selective check execution"
128
+ },
129
+ "routing": {
130
+ "$ref": "#/definitions/RoutingDefaults",
131
+ "description": "Optional routing defaults for retry/goto/run policies"
132
+ },
133
+ "limits": {
134
+ "$ref": "#/definitions/LimitsConfig",
135
+ "description": "Global execution limits"
136
+ },
137
+ "frontends": {
138
+ "type": "array",
139
+ "items": {
140
+ "type": "object",
141
+ "properties": {
142
+ "name": {
143
+ "type": "string",
144
+ "description": "Frontend name, e.g., 'ndjson-sink', 'github'"
145
+ },
146
+ "config": {
147
+ "description": "Frontend-specific configuration"
148
+ }
149
+ },
150
+ "required": [
151
+ "name"
152
+ ],
153
+ "additionalProperties": false
154
+ },
155
+ "description": "Optional integrations: event-driven frontends (e.g., ndjson-sink, github)"
156
+ },
157
+ "workspace": {
158
+ "$ref": "#/definitions/WorkspaceConfig",
159
+ "description": "Workspace isolation configuration for sandboxed execution"
160
+ },
161
+ "sandbox": {
162
+ "type": "string",
163
+ "description": "Workspace-level default sandbox name (all checks use this unless overridden)"
164
+ },
165
+ "sandboxes": {
166
+ "$ref": "#/definitions/Record%3Cstring%2CSandboxConfig%3E",
167
+ "description": "Named sandbox environment definitions"
168
+ },
169
+ "sandbox_defaults": {
170
+ "$ref": "#/definitions/SandboxDefaults",
171
+ "description": "Workspace-level sandbox defaults (env allowlist, etc.)"
172
+ },
173
+ "slack": {
174
+ "$ref": "#/definitions/SlackConfig",
175
+ "description": "Slack configuration"
176
+ },
177
+ "telegram": {
178
+ "$ref": "#/definitions/TelegramConfig",
179
+ "description": "Telegram bot configuration"
180
+ },
181
+ "email": {
182
+ "$ref": "#/definitions/EmailConfig",
183
+ "description": "Email integration configuration"
184
+ },
185
+ "whatsapp": {
186
+ "$ref": "#/definitions/WhatsAppConfig",
187
+ "description": "WhatsApp bot configuration"
188
+ },
189
+ "teams": {
190
+ "$ref": "#/definitions/TeamsConfig",
191
+ "description": "Microsoft Teams bot configuration"
192
+ },
193
+ "scheduler": {
194
+ "$ref": "#/definitions/SchedulerConfig",
195
+ "description": "Scheduler configuration for scheduled workflow execution"
196
+ },
197
+ "policy": {
198
+ "$ref": "#/definitions/PolicyConfig",
199
+ "description": "Enterprise policy engine configuration"
200
+ },
201
+ "agent_protocol": {
202
+ "$ref": "#/definitions/AgentProtocolConfig",
203
+ "description": "Agent protocol (A2A) server configuration"
204
+ },
205
+ "task_tracking": {
206
+ "type": "boolean",
207
+ "description": "Enable cross-frontend task tracking (default: false). When true, all workflow executions (CLI, Slack, TUI, Scheduler) are recorded in a shared SQLite TaskStore visible via `visor tasks`."
208
+ }
209
+ },
210
+ "required": [
211
+ "version"
212
+ ],
213
+ "patternProperties": {
214
+ "^x-": {}
215
+ }
216
+ },
217
+ "Record<string,unknown>": {
218
+ "type": "object",
219
+ "additionalProperties": {}
220
+ },
221
+ "Record<string,CustomToolDefinition>": {
222
+ "type": "object",
223
+ "additionalProperties": {
224
+ "$ref": "#/definitions/CustomToolDefinition"
225
+ }
226
+ },
227
+ "CustomToolDefinition": {
228
+ "type": "object",
229
+ "properties": {
230
+ "type": {
231
+ "type": "string",
232
+ "enum": [
233
+ "command",
234
+ "api",
235
+ "workflow"
236
+ ],
237
+ "description": "Tool implementation type (defaults to 'command')"
238
+ },
239
+ "name": {
240
+ "type": "string",
241
+ "description": "Tool name - used to reference the tool in MCP blocks"
242
+ },
243
+ "description": {
244
+ "type": "string",
245
+ "description": "Description of what the tool does"
246
+ },
247
+ "inputSchema": {
248
+ "type": "object",
249
+ "properties": {
250
+ "type": {
251
+ "type": "string",
252
+ "const": "object"
253
+ },
254
+ "properties": {
255
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
256
+ },
257
+ "required": {
258
+ "type": "array",
259
+ "items": {
260
+ "type": "string"
261
+ }
262
+ },
263
+ "additionalProperties": {
264
+ "type": "boolean"
265
+ }
266
+ },
267
+ "required": [
268
+ "type"
269
+ ],
270
+ "additionalProperties": false,
271
+ "description": "Input schema for the tool (JSON Schema format)",
272
+ "patternProperties": {
273
+ "^x-": {}
274
+ }
275
+ },
276
+ "exec": {
277
+ "type": "string",
278
+ "description": "Command to execute - supports Liquid template (required for type: 'command')"
279
+ },
280
+ "stdin": {
281
+ "type": "string",
282
+ "description": "Optional stdin input - supports Liquid template"
283
+ },
284
+ "transform": {
285
+ "type": "string",
286
+ "description": "Transform the raw output - supports Liquid template"
287
+ },
288
+ "transform_js": {
289
+ "type": "string",
290
+ "description": "Transform the output using JavaScript - alternative to transform"
291
+ },
292
+ "cwd": {
293
+ "type": "string",
294
+ "description": "Working directory for command execution"
295
+ },
296
+ "env": {
297
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
298
+ "description": "Environment variables for the command"
299
+ },
300
+ "timeout": {
301
+ "type": "number",
302
+ "description": "Timeout in milliseconds"
303
+ },
304
+ "parseJson": {
305
+ "type": "boolean",
306
+ "description": "Whether to parse output as JSON automatically"
307
+ },
308
+ "outputSchema": {
309
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
310
+ "description": "Expected output schema for validation"
311
+ },
312
+ "spec": {
313
+ "anyOf": [
314
+ {
315
+ "type": "string"
316
+ },
317
+ {
318
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
319
+ }
320
+ ],
321
+ "description": "OpenAPI specification path/URL or inline object (required for type: 'api')"
322
+ },
323
+ "overlays": {
324
+ "anyOf": [
325
+ {
326
+ "type": "string"
327
+ },
328
+ {
329
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
330
+ },
331
+ {
332
+ "type": "array",
333
+ "items": {
334
+ "anyOf": [
335
+ {
336
+ "type": "string"
337
+ },
338
+ {
339
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
340
+ }
341
+ ]
342
+ }
343
+ }
344
+ ],
345
+ "description": "Overlay path/URL, inline object, or a mixed array applied in order"
346
+ },
347
+ "targetUrl": {
348
+ "type": "string",
349
+ "description": "Override API base URL instead of OpenAPI servers"
350
+ },
351
+ "target_url": {
352
+ "type": "string",
353
+ "description": "Alias for targetUrl (snake_case)"
354
+ },
355
+ "whitelist": {
356
+ "anyOf": [
357
+ {
358
+ "type": "array",
359
+ "items": {
360
+ "type": "string"
361
+ }
362
+ },
363
+ {
364
+ "type": "string"
365
+ }
366
+ ],
367
+ "description": "Include only operations matching these glob patterns (operationId or METHOD:/path)"
368
+ },
369
+ "blacklist": {
370
+ "anyOf": [
371
+ {
372
+ "type": "array",
373
+ "items": {
374
+ "type": "string"
375
+ }
376
+ },
377
+ {
378
+ "type": "string"
379
+ }
380
+ ],
381
+ "description": "Exclude operations matching these glob patterns (ignored when whitelist is set)"
382
+ },
383
+ "headers": {
384
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
385
+ "description": "Extra headers added to all API requests"
386
+ },
387
+ "disableXMcp": {
388
+ "type": "boolean",
389
+ "description": "Disable X-MCP: 1 request header"
390
+ },
391
+ "disable_x_mcp": {
392
+ "type": "boolean",
393
+ "description": "Alias for disableXMcp (snake_case)"
394
+ },
395
+ "apiKey": {
396
+ "type": "string",
397
+ "description": "API key fallback credential used by security schemes"
398
+ },
399
+ "api_key": {
400
+ "type": "string",
401
+ "description": "Alias for apiKey (snake_case)"
402
+ },
403
+ "securitySchemeName": {
404
+ "type": "string",
405
+ "description": "Preferred security scheme name (optional hint)"
406
+ },
407
+ "security_scheme_name": {
408
+ "type": "string",
409
+ "description": "Alias for securitySchemeName (snake_case)"
410
+ },
411
+ "securityCredentials": {
412
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
413
+ "description": "Credentials by OpenAPI security scheme name"
414
+ },
415
+ "security_credentials": {
416
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
417
+ "description": "Alias for securityCredentials (snake_case)"
418
+ },
419
+ "namePrefix": {
420
+ "type": "string",
421
+ "description": "Optional prefix prepended to generated operation tool names"
422
+ },
423
+ "name_prefix": {
424
+ "type": "string",
425
+ "description": "Alias for namePrefix (snake_case)"
426
+ },
427
+ "requestTimeoutMs": {
428
+ "type": "number",
429
+ "description": "Request timeout in milliseconds for API calls"
430
+ },
431
+ "request_timeout_ms": {
432
+ "type": "number",
433
+ "description": "Alias for requestTimeoutMs (snake_case)"
434
+ },
435
+ "workflow": {
436
+ "type": "string",
437
+ "description": "Workflow ID (registry lookup) or file path (for type: 'workflow')"
438
+ },
439
+ "inputs": {
440
+ "type": "array",
441
+ "items": {
442
+ "$ref": "#/definitions/WorkflowInput"
443
+ },
444
+ "description": "Inline workflow inputs (for type: 'workflow' with inline steps)"
445
+ },
446
+ "outputs": {
447
+ "type": "array",
448
+ "items": {
449
+ "$ref": "#/definitions/WorkflowOutput"
450
+ },
451
+ "description": "Inline workflow outputs (for type: 'workflow' with inline steps)"
452
+ },
453
+ "steps": {
454
+ "$ref": "#/definitions/Record%3Cstring%2CCheckConfig%3E",
455
+ "description": "Inline workflow steps (for type: 'workflow' with inline definition)"
456
+ }
457
+ },
458
+ "required": [
459
+ "name"
460
+ ],
461
+ "additionalProperties": false,
462
+ "description": "Custom tool definition for use in MCP blocks",
463
+ "patternProperties": {
464
+ "^x-": {}
465
+ }
466
+ },
467
+ "Record<string,string>": {
468
+ "type": "object",
469
+ "additionalProperties": {
470
+ "type": "string"
471
+ }
472
+ },
473
+ "WorkflowInput": {
474
+ "type": "object",
475
+ "properties": {
476
+ "name": {
477
+ "type": "string",
478
+ "description": "Input parameter name"
479
+ },
480
+ "schema": {
481
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
482
+ "description": "JSON Schema for the input"
483
+ },
484
+ "required": {
485
+ "type": "boolean",
486
+ "description": "Whether this input is required"
487
+ },
488
+ "default": {
489
+ "description": "Default value if not provided"
490
+ },
491
+ "description": {
492
+ "type": "string",
493
+ "description": "Human-readable description"
494
+ }
495
+ },
496
+ "required": [
497
+ "name"
498
+ ],
499
+ "additionalProperties": false,
500
+ "description": "Workflow input definition for standalone reusable workflows",
501
+ "patternProperties": {
502
+ "^x-": {}
503
+ }
504
+ },
505
+ "WorkflowOutput": {
506
+ "type": "object",
507
+ "properties": {
508
+ "name": {
509
+ "type": "string",
510
+ "description": "Output name"
511
+ },
512
+ "description": {
513
+ "type": "string",
514
+ "description": "Human-readable description"
515
+ },
516
+ "value": {
517
+ "type": "string",
518
+ "description": "Value using Liquid template syntax (references step outputs)"
519
+ },
520
+ "value_js": {
521
+ "type": "string",
522
+ "description": "Value using JavaScript expression (alternative to value)"
523
+ }
524
+ },
525
+ "required": [
526
+ "name"
527
+ ],
528
+ "additionalProperties": false,
529
+ "description": "Workflow output definition for standalone reusable workflows",
530
+ "patternProperties": {
531
+ "^x-": {}
532
+ }
533
+ },
534
+ "Record<string,CheckConfig>": {
535
+ "type": "object",
536
+ "additionalProperties": {
537
+ "$ref": "#/definitions/CheckConfig"
538
+ }
539
+ },
540
+ "CheckConfig": {
541
+ "type": "object",
542
+ "properties": {
543
+ "type": {
544
+ "$ref": "#/definitions/ConfigCheckType",
545
+ "description": "Type of check to perform (defaults to 'ai' if not specified)"
546
+ },
547
+ "prompt": {
548
+ "type": "string",
549
+ "description": "AI prompt for the check - can be inline string or file path (auto-detected) - required for AI checks"
550
+ },
551
+ "appendPrompt": {
552
+ "type": "string",
553
+ "description": "Additional prompt to append when extending configurations - merged with parent prompt"
554
+ },
555
+ "exec": {
556
+ "type": "string",
557
+ "description": "Command execution with Liquid template support - required for command checks"
558
+ },
559
+ "stdin": {
560
+ "type": "string",
561
+ "description": "Stdin input for tools with Liquid template support - optional for tool checks"
562
+ },
563
+ "url": {
564
+ "type": "string",
565
+ "description": "HTTP URL - required for http output checks"
566
+ },
567
+ "body": {
568
+ "type": "string",
569
+ "description": "HTTP body template (Liquid) - required for http output checks"
570
+ },
571
+ "method": {
572
+ "type": "string",
573
+ "description": "HTTP method (defaults to POST)"
574
+ },
575
+ "headers": {
576
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
577
+ "description": "HTTP headers"
578
+ },
579
+ "endpoint": {
580
+ "type": "string",
581
+ "description": "HTTP endpoint path - required for http_input checks"
582
+ },
583
+ "transform": {
584
+ "type": "string",
585
+ "description": "Transform template for http_input data (Liquid) - optional"
586
+ },
587
+ "transform_js": {
588
+ "type": "string",
589
+ "description": "Transform using JavaScript expressions (evaluated in secure sandbox) - optional"
590
+ },
591
+ "content": {
592
+ "type": "string",
593
+ "description": "Script content to execute for script checks"
594
+ },
595
+ "tools": {
596
+ "type": "array",
597
+ "items": {
598
+ "anyOf": [
599
+ {
600
+ "type": "string"
601
+ },
602
+ {
603
+ "type": "object",
604
+ "properties": {
605
+ "workflow": {
606
+ "type": "string"
607
+ },
608
+ "args": {
609
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
610
+ }
611
+ },
612
+ "required": [
613
+ "workflow"
614
+ ],
615
+ "additionalProperties": false
616
+ }
617
+ ]
618
+ },
619
+ "description": "Tool names to expose inside script checks (string names or workflow references)"
620
+ },
621
+ "tools_js": {
622
+ "type": "string",
623
+ "description": "JavaScript expression to dynamically compute tools for script checks"
624
+ },
625
+ "mcp_servers": {
626
+ "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
627
+ "description": "MCP servers whose tools are exposed inside script checks"
628
+ },
629
+ "enable_fetch": {
630
+ "type": "boolean",
631
+ "description": "Enable fetch() function in script checks (default: false)"
632
+ },
633
+ "enable_bash": {
634
+ "type": "boolean",
635
+ "description": "Enable bash() function in script checks (default: false)"
636
+ },
637
+ "schedule": {
638
+ "type": "string",
639
+ "description": "Cron schedule expression (e.g., \"0 2 * * *\") - optional for any check type"
640
+ },
641
+ "focus": {
642
+ "type": "string",
643
+ "description": "Focus area for the check (security/performance/style/architecture/all) - optional"
644
+ },
645
+ "command": {
646
+ "type": "string",
647
+ "description": "Command that triggers this check (e.g., \"review\", \"security-scan\") - optional"
648
+ },
649
+ "on": {
650
+ "type": "array",
651
+ "items": {
652
+ "$ref": "#/definitions/EventTrigger"
653
+ },
654
+ "description": "Events that trigger this check (defaults to ['manual'] if not specified)"
655
+ },
656
+ "triggers": {
657
+ "type": "array",
658
+ "items": {
659
+ "type": "string"
660
+ },
661
+ "description": "File patterns that trigger this check (optional)"
662
+ },
663
+ "ai": {
664
+ "$ref": "#/definitions/AIProviderConfig",
665
+ "description": "AI provider configuration (optional)"
666
+ },
667
+ "ai_model": {
668
+ "type": "string",
669
+ "description": "AI model to use for this check - overrides global setting"
670
+ },
671
+ "ai_provider": {
672
+ "type": "string",
673
+ "description": "AI provider to use for this check - overrides global setting"
674
+ },
675
+ "ai_persona": {
676
+ "type": "string",
677
+ "description": "Optional persona hint, prepended to the prompt as 'Persona: <value>'"
678
+ },
679
+ "ai_prompt_type": {
680
+ "type": "string",
681
+ "description": "Probe promptType for this check (underscore style)"
682
+ },
683
+ "ai_max_iterations": {
684
+ "type": "number",
685
+ "description": "Maximum tool iterations for ProbeAgent (underscore style)"
686
+ },
687
+ "ai_system_prompt": {
688
+ "type": "string",
689
+ "description": "System prompt for this check (underscore style)"
690
+ },
691
+ "ai_custom_prompt": {
692
+ "type": "string",
693
+ "description": "Legacy customPrompt (underscore style) — deprecated, use ai_system_prompt"
694
+ },
695
+ "ai_mcp_servers": {
696
+ "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
697
+ "description": "MCP servers for this AI check - overrides global setting"
698
+ },
699
+ "ai_mcp_servers_js": {
700
+ "type": "string",
701
+ "description": "JavaScript expression to dynamically compute MCP servers for this AI check. Expression has access to: outputs, inputs, pr, files, env, memory Must return an object mapping server names to McpServerConfig objects.\n\nExample: ``` const servers = {}; const tags = outputs['route-intent']?.tags || []; if (tags.includes('jira')) { servers.jira = { command: \"npx\", args: [\"-y\", \"@aashari/mcp-server-atlassian-jira\"], env: { ATLASSIAN_SITE_NAME: \"mysite\" } }; } return servers; ```"
702
+ },
703
+ "ai_custom_tools": {
704
+ "type": "array",
705
+ "items": {
706
+ "type": "string"
707
+ },
708
+ "description": "List of custom tool names to expose to this AI check via ephemeral SSE MCP server"
709
+ },
710
+ "ai_custom_tools_js": {
711
+ "type": "string",
712
+ "description": "JavaScript expression to dynamically compute custom tools for this AI check. Expression has access to: outputs, inputs, pr, files, env, memory Must return an array of tool names (strings) or WorkflowToolReference objects ({ workflow: string, args?: Record<string, unknown> })\n\nExample: ``` const tools = []; if (outputs['route-intent'].intent === 'engineer') { tools.push({ workflow: 'engineer', args: { projects: ['tyk'] } }); } return tools; ```"
713
+ },
714
+ "ai_bash_config_js": {
715
+ "type": "string",
716
+ "description": "JavaScript expression to dynamically compute bash configuration for this AI check. Expression has access to: outputs, inputs, pr, files, env, memory Must return a BashConfig object with allow/deny arrays.\n\nExample: ``` return outputs['build-config']?.bash_config ?? {}; ```"
717
+ },
718
+ "claude_code": {
719
+ "$ref": "#/definitions/ClaudeCodeConfig",
720
+ "description": "Claude Code configuration (for claude-code type checks)"
721
+ },
722
+ "env": {
723
+ "$ref": "#/definitions/EnvConfig",
724
+ "description": "Environment variables for this check"
725
+ },
726
+ "timeout": {
727
+ "type": "number",
728
+ "description": "Timeout in milliseconds for command execution (default: 60000, i.e., 60 seconds)"
729
+ },
730
+ "depends_on": {
731
+ "anyOf": [
732
+ {
733
+ "type": "string"
734
+ },
735
+ {
736
+ "type": "array",
737
+ "items": {
738
+ "type": "string"
739
+ }
740
+ }
741
+ ],
742
+ "description": "Check IDs that this check depends on (optional). Accepts single string or array."
743
+ },
744
+ "group": {
745
+ "type": "string",
746
+ "description": "Group name for comment separation (e.g., \"code-review\", \"pr-overview\") - optional"
747
+ },
748
+ "schema": {
749
+ "anyOf": [
750
+ {
751
+ "type": "string"
752
+ },
753
+ {
754
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
755
+ }
756
+ ],
757
+ "description": "Schema type for template rendering (e.g., \"code-review\", \"markdown\") or inline JSON schema object - optional"
758
+ },
759
+ "output_schema": {
760
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
761
+ "description": "Optional JSON Schema to validate the produced output. If omitted and `schema` is an object, the engine will treat that object as the output_schema for validation purposes while still using string schemas (e.g., 'code-review') for template selection."
762
+ },
763
+ "template": {
764
+ "$ref": "#/definitions/CustomTemplateConfig",
765
+ "description": "Custom template configuration - optional"
766
+ },
767
+ "if": {
768
+ "type": "string",
769
+ "description": "Condition to determine if check should run - runs if expression evaluates to true"
770
+ },
771
+ "reuse_ai_session": {
772
+ "type": [
773
+ "string",
774
+ "boolean"
775
+ ],
776
+ "description": "Check name to reuse AI session from, or true to use first dependency (only works with depends_on)"
777
+ },
778
+ "session_mode": {
779
+ "type": "string",
780
+ "enum": [
781
+ "clone",
782
+ "append"
783
+ ],
784
+ "description": "How to reuse AI session: 'clone' (default, copy history) or 'append' (share history)"
785
+ },
786
+ "fail_if": {
787
+ "type": "string",
788
+ "description": "Simple fail condition - fails check if expression evaluates to true"
789
+ },
790
+ "failure_conditions": {
791
+ "$ref": "#/definitions/FailureConditions",
792
+ "description": "Check-specific failure conditions - optional (deprecated, use fail_if)"
793
+ },
794
+ "tags": {
795
+ "type": "array",
796
+ "items": {
797
+ "type": "string"
798
+ },
799
+ "description": "Tags for categorizing and filtering checks (e.g., [\"local\", \"fast\", \"security\"])"
800
+ },
801
+ "criticality": {
802
+ "type": "string",
803
+ "enum": [
804
+ "external",
805
+ "internal",
806
+ "policy",
807
+ "info"
808
+ ],
809
+ "description": "Operational criticality of this step. Drives default safety policies (contracts, retries, loop budgets) at load time. Behavior can still be overridden explicitly per step via on_*, fail_if, assume/guarantee, etc.\n\n- 'external': interacts with external systems (side effects). Highest safety.\n- 'internal': modifies CI/config/state but not prod. High safety.\n- 'policy': organizational checks (linting, style, doc). Moderate safety.\n- 'info': informational checks. Lowest safety."
810
+ },
811
+ "continue_on_failure": {
812
+ "type": "boolean",
813
+ "description": "Allow dependents to run even if this step fails. Defaults to false (dependents are gated when this step fails). Similar to GitHub Actions' continue-on-error."
814
+ },
815
+ "forEach": {
816
+ "type": "boolean",
817
+ "description": "Process output as array and run dependent checks for each item"
818
+ },
819
+ "fanout": {
820
+ "type": "string",
821
+ "enum": [
822
+ "map",
823
+ "reduce"
824
+ ],
825
+ "description": "Control scheduling behavior when this check is triggered via routing (run/goto) from a forEach scope.\n- 'map': schedule once per item (fan-out) using item scopes.\n- 'reduce': schedule a single run at the parent scope (aggregation). If unset, the current default is a single run (reduce) for backward compatibility."
826
+ },
827
+ "reduce": {
828
+ "type": "boolean",
829
+ "description": "Alias for fanout: 'reduce'"
830
+ },
831
+ "on_init": {
832
+ "$ref": "#/definitions/OnInitConfig",
833
+ "description": "Init routing configuration for this check (runs before execution/preprocessing)"
834
+ },
835
+ "on_fail": {
836
+ "$ref": "#/definitions/OnFailConfig",
837
+ "description": "Failure routing configuration for this check (retry/goto/run)"
838
+ },
839
+ "on_success": {
840
+ "$ref": "#/definitions/OnSuccessConfig",
841
+ "description": "Success routing configuration for this check (post-actions and optional goto)"
842
+ },
843
+ "on_finish": {
844
+ "$ref": "#/definitions/OnFinishConfig",
845
+ "description": "Finish routing configuration for forEach checks (runs after ALL iterations complete)"
846
+ },
847
+ "assume": {
848
+ "anyOf": [
849
+ {
850
+ "type": "string"
851
+ },
852
+ {
853
+ "type": "array",
854
+ "items": {
855
+ "type": "string"
856
+ }
857
+ }
858
+ ],
859
+ "description": "Preconditions that must hold before executing the check. If any expression evaluates to false, the check is skipped (skipReason='assume')."
860
+ },
861
+ "guarantee": {
862
+ "anyOf": [
863
+ {
864
+ "type": "string"
865
+ },
866
+ {
867
+ "type": "array",
868
+ "items": {
869
+ "type": "string"
870
+ }
871
+ }
872
+ ],
873
+ "description": "Postconditions that should hold after executing the check. Expressions are evaluated against the produced result/output; violations are recorded as error issues with ruleId \"contract/guarantee_failed\"."
874
+ },
875
+ "max_runs": {
876
+ "type": "number",
877
+ "description": "Hard cap on how many times this check may execute within a single engine run. Overrides global limits.max_runs_per_check. Set to 0 or negative to disable for this step."
878
+ },
879
+ "message": {
880
+ "type": "string",
881
+ "description": "Message template for log checks"
882
+ },
883
+ "level": {
884
+ "type": "string",
885
+ "enum": [
886
+ "debug",
887
+ "info",
888
+ "warn",
889
+ "error"
890
+ ],
891
+ "description": "Log level for log checks"
892
+ },
893
+ "include_pr_context": {
894
+ "type": "boolean",
895
+ "description": "Include PR context in log output"
896
+ },
897
+ "include_dependencies": {
898
+ "type": "boolean",
899
+ "description": "Include dependency summaries in log output"
900
+ },
901
+ "include_metadata": {
902
+ "type": "boolean",
903
+ "description": "Include execution metadata in log output"
904
+ },
905
+ "output_format": {
906
+ "type": "string",
907
+ "enum": [
908
+ "json",
909
+ "text"
910
+ ],
911
+ "description": "Output parsing hint for command provider (optional) When set to 'json', command stdout is expected to be JSON. When 'text', treat as plain text. Note: command provider attempts JSON parsing heuristically; this flag mainly suppresses schema warnings and may be used by providers to alter parsing behavior in the future."
912
+ },
913
+ "operation": {
914
+ "type": "string",
915
+ "enum": [
916
+ "get",
917
+ "set",
918
+ "append",
919
+ "increment",
920
+ "delete",
921
+ "clear",
922
+ "list"
923
+ ],
924
+ "description": "Memory operation to perform. Use `type: 'script'` for custom JavaScript."
925
+ },
926
+ "key": {
927
+ "type": "string",
928
+ "description": "Key for memory operation"
929
+ },
930
+ "value": {
931
+ "description": "Value for set/append operations"
932
+ },
933
+ "value_js": {
934
+ "type": "string",
935
+ "description": "JavaScript expression to compute value dynamically"
936
+ },
937
+ "namespace": {
938
+ "type": "string",
939
+ "description": "Override namespace for this check"
940
+ },
941
+ "op": {
942
+ "type": "string",
943
+ "description": "GitHub operation to perform (e.g., 'labels.add', 'labels.remove', 'comment.create')"
944
+ },
945
+ "values": {
946
+ "anyOf": [
947
+ {
948
+ "type": "array",
949
+ "items": {
950
+ "type": "string"
951
+ }
952
+ },
953
+ {
954
+ "type": "string"
955
+ }
956
+ ],
957
+ "description": "Values for GitHub operations (can be array or single value)"
958
+ },
959
+ "transport": {
960
+ "type": "string",
961
+ "enum": [
962
+ "stdio",
963
+ "sse",
964
+ "http"
965
+ ],
966
+ "description": "Transport type for MCP: stdio (default), sse (legacy), or http (streamable HTTP)"
967
+ },
968
+ "methodArgs": {
969
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
970
+ "description": "Arguments to pass to the MCP method (supports Liquid templates)"
971
+ },
972
+ "argsTransform": {
973
+ "type": "string",
974
+ "description": "Transform template for method arguments (Liquid)"
975
+ },
976
+ "sessionId": {
977
+ "type": "string",
978
+ "description": "Session ID for HTTP transport (optional, server may generate one)"
979
+ },
980
+ "command_args": {
981
+ "type": "array",
982
+ "items": {
983
+ "type": "string"
984
+ },
985
+ "description": "Command arguments (for stdio transport in MCP checks)"
986
+ },
987
+ "workingDirectory": {
988
+ "type": "string",
989
+ "description": "Working directory (for stdio transport in MCP checks)"
990
+ },
991
+ "placeholder": {
992
+ "type": "string",
993
+ "description": "Placeholder text to show in input field"
994
+ },
995
+ "allow_empty": {
996
+ "type": "boolean",
997
+ "description": "Allow empty input (default: false)"
998
+ },
999
+ "multiline": {
1000
+ "type": "boolean",
1001
+ "description": "Support multiline input (default: false)"
1002
+ },
1003
+ "default": {
1004
+ "type": "string",
1005
+ "description": "Default value if timeout occurs or empty input when allow_empty is true"
1006
+ },
1007
+ "workflow": {
1008
+ "type": "string",
1009
+ "description": "Workflow ID or path to workflow file"
1010
+ },
1011
+ "args": {
1012
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1013
+ "description": "Arguments/inputs for the workflow"
1014
+ },
1015
+ "overrides": {
1016
+ "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833%3E%3E",
1017
+ "description": "Override specific step configurations in the workflow"
1018
+ },
1019
+ "output_mapping": {
1020
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
1021
+ "description": "Map workflow outputs to check outputs"
1022
+ },
1023
+ "workflow_inputs": {
1024
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1025
+ "description": "Alias for args - workflow inputs (backward compatibility)"
1026
+ },
1027
+ "config": {
1028
+ "type": "string",
1029
+ "description": "Config file path - alternative to workflow ID (loads a Visor config file as workflow)"
1030
+ },
1031
+ "workflow_overrides": {
1032
+ "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833%3E%3E",
1033
+ "description": "Alias for overrides - workflow step overrides (backward compatibility)"
1034
+ },
1035
+ "ref": {
1036
+ "type": "string",
1037
+ "description": "Git reference to checkout (branch, tag, commit SHA) - supports templates"
1038
+ },
1039
+ "repository": {
1040
+ "type": "string",
1041
+ "description": "Repository URL or owner/repo format (defaults to current repository)"
1042
+ },
1043
+ "token": {
1044
+ "type": "string",
1045
+ "description": "GitHub token for private repositories (defaults to GITHUB_TOKEN env)"
1046
+ },
1047
+ "fetch_depth": {
1048
+ "type": "number",
1049
+ "description": "Number of commits to fetch (0 for full history, default: 1)"
1050
+ },
1051
+ "fetch_tags": {
1052
+ "type": "boolean",
1053
+ "description": "Whether to fetch tags (default: false)"
1054
+ },
1055
+ "submodules": {
1056
+ "anyOf": [
1057
+ {
1058
+ "type": "boolean"
1059
+ },
1060
+ {
1061
+ "type": "string",
1062
+ "const": "recursive"
1063
+ }
1064
+ ],
1065
+ "description": "Checkout submodules: false, true, or 'recursive'"
1066
+ },
1067
+ "working_directory": {
1068
+ "type": "string",
1069
+ "description": "Working directory for the checkout (defaults to temp directory)"
1070
+ },
1071
+ "use_worktree": {
1072
+ "type": "boolean",
1073
+ "description": "Use git worktree for efficient parallel checkouts (default: true)"
1074
+ },
1075
+ "clean": {
1076
+ "type": "boolean",
1077
+ "description": "Clean the working directory before checkout (default: true)"
1078
+ },
1079
+ "sparse_checkout": {
1080
+ "type": "array",
1081
+ "items": {
1082
+ "type": "string"
1083
+ },
1084
+ "description": "Sparse checkout paths - only checkout specific directories/files"
1085
+ },
1086
+ "lfs": {
1087
+ "type": "boolean",
1088
+ "description": "Enable Git LFS (Large File Storage)"
1089
+ },
1090
+ "clone_timeout_ms": {
1091
+ "type": "number",
1092
+ "description": "Timeout in ms for cloning the bare repository (default: 300000 = 5 min)"
1093
+ },
1094
+ "cleanup_on_failure": {
1095
+ "type": "boolean",
1096
+ "description": "Clean up worktree on failure (default: true)"
1097
+ },
1098
+ "persist_worktree": {
1099
+ "type": "boolean",
1100
+ "description": "Keep worktree after workflow completion (default: false)"
1101
+ },
1102
+ "sandbox": {
1103
+ "type": "string",
1104
+ "description": "Sandbox name to use for this check (overrides workspace-level default)"
1105
+ },
1106
+ "policy": {
1107
+ "$ref": "#/definitions/StepPolicyOverride",
1108
+ "description": "Per-step policy override (enterprise)"
1109
+ }
1110
+ },
1111
+ "additionalProperties": false,
1112
+ "description": "Configuration for a single check",
1113
+ "patternProperties": {
1114
+ "^x-": {}
1115
+ }
1116
+ },
1117
+ "ConfigCheckType": {
1118
+ "type": "string",
1119
+ "enum": [
1120
+ "ai",
1121
+ "command",
1122
+ "script",
1123
+ "http",
1124
+ "http_input",
1125
+ "http_client",
1126
+ "noop",
1127
+ "log",
1128
+ "memory",
1129
+ "github",
1130
+ "claude-code",
1131
+ "mcp",
1132
+ "human-input",
1133
+ "workflow",
1134
+ "git-checkout",
1135
+ "a2a"
1136
+ ],
1137
+ "description": "Valid check types in configuration"
1138
+ },
1139
+ "Record<string,McpServerConfig>": {
1140
+ "type": "object",
1141
+ "additionalProperties": {
1142
+ "$ref": "#/definitions/McpServerConfig"
1143
+ }
1144
+ },
1145
+ "McpServerConfig": {
1146
+ "type": "object",
1147
+ "properties": {
1148
+ "command": {
1149
+ "type": "string",
1150
+ "description": "Command to execute (presence indicates stdio server)"
1151
+ },
1152
+ "args": {
1153
+ "type": "array",
1154
+ "items": {
1155
+ "type": "string"
1156
+ },
1157
+ "description": "Arguments to pass to the command"
1158
+ },
1159
+ "env": {
1160
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
1161
+ "description": "Environment variables for the MCP server"
1162
+ },
1163
+ "url": {
1164
+ "type": "string",
1165
+ "description": "URL endpoint (presence indicates external server)"
1166
+ },
1167
+ "transport": {
1168
+ "type": "string",
1169
+ "enum": [
1170
+ "stdio",
1171
+ "sse",
1172
+ "http"
1173
+ ],
1174
+ "description": "Transport type"
1175
+ },
1176
+ "workflow": {
1177
+ "type": "string",
1178
+ "description": "Workflow ID or path (presence indicates workflow tool)"
1179
+ },
1180
+ "inputs": {
1181
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1182
+ "description": "Inputs to pass to workflow"
1183
+ },
1184
+ "description": {
1185
+ "type": "string",
1186
+ "description": "Tool description for AI"
1187
+ },
1188
+ "allowedMethods": {
1189
+ "type": "array",
1190
+ "items": {
1191
+ "type": "string"
1192
+ },
1193
+ "description": "Whitelist specific methods from this MCP server (supports wildcards like \"search_*\")"
1194
+ },
1195
+ "blockedMethods": {
1196
+ "type": "array",
1197
+ "items": {
1198
+ "type": "string"
1199
+ },
1200
+ "description": "Block specific methods from this MCP server (supports wildcards like \"*_delete\")"
1201
+ }
1202
+ },
1203
+ "additionalProperties": false,
1204
+ "description": "Unified MCP server/tool entry - type detected by which properties are present\n\nDetection logic (priority order): 1. Has `command` → stdio MCP server (external process) 2. Has `url` → SSE/HTTP MCP server (external endpoint) 3. Has `workflow` → workflow tool reference 4. Empty `{}` or just key → auto-detect from `tools:` section",
1205
+ "patternProperties": {
1206
+ "^x-": {}
1207
+ }
1208
+ },
1209
+ "EventTrigger": {
1210
+ "type": "string",
1211
+ "enum": [
1212
+ "pr_opened",
1213
+ "pr_updated",
1214
+ "pr_closed",
1215
+ "issue_opened",
1216
+ "issue_comment",
1217
+ "manual",
1218
+ "schedule",
1219
+ "webhook_received",
1220
+ "slack_message",
1221
+ "telegram_message",
1222
+ "email_message",
1223
+ "whatsapp_message",
1224
+ "teams_message"
1225
+ ],
1226
+ "description": "Valid event triggers for checks"
1227
+ },
1228
+ "AIProviderConfig": {
1229
+ "type": "object",
1230
+ "properties": {
1231
+ "provider": {
1232
+ "type": "string",
1233
+ "enum": [
1234
+ "google",
1235
+ "anthropic",
1236
+ "openai",
1237
+ "bedrock",
1238
+ "mock"
1239
+ ],
1240
+ "description": "AI provider to use"
1241
+ },
1242
+ "model": {
1243
+ "type": "string",
1244
+ "description": "Model name to use"
1245
+ },
1246
+ "apiKey": {
1247
+ "type": "string",
1248
+ "description": "API key (usually from environment variables)"
1249
+ },
1250
+ "timeout": {
1251
+ "type": "number",
1252
+ "description": "Request timeout in milliseconds"
1253
+ },
1254
+ "max_iterations": {
1255
+ "type": "number",
1256
+ "description": "Maximum tool iterations for ProbeAgent"
1257
+ },
1258
+ "debug": {
1259
+ "type": "boolean",
1260
+ "description": "Enable debug mode"
1261
+ },
1262
+ "prompt_type": {
1263
+ "type": "string",
1264
+ "description": "Probe promptType to use (e.g., engineer, code-review, architect)"
1265
+ },
1266
+ "system_prompt": {
1267
+ "type": "string",
1268
+ "description": "System prompt (baseline preamble). Replaces legacy custom_prompt."
1269
+ },
1270
+ "custom_prompt": {
1271
+ "type": "string",
1272
+ "description": "Probe customPrompt (baseline/system prompt) — deprecated, use system_prompt"
1273
+ },
1274
+ "skip_code_context": {
1275
+ "type": "boolean",
1276
+ "description": "Skip adding code context (diffs, files, PR info) to the prompt"
1277
+ },
1278
+ "skip_slack_context": {
1279
+ "type": "boolean",
1280
+ "description": "Skip adding Slack conversation context to the prompt (when running under Slack)"
1281
+ },
1282
+ "skip_transport_context": {
1283
+ "type": "boolean",
1284
+ "description": "Skip adding transport-specific context (e.g., GitHub PR/issue XML, Slack conversation XML) to the prompt. When true, this behaves like setting both skip_code_context and skip_slack_context to true, unless those are explicitly overridden."
1285
+ },
1286
+ "mcpServers": {
1287
+ "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
1288
+ "description": "MCP servers configuration"
1289
+ },
1290
+ "enableDelegate": {
1291
+ "type": "boolean",
1292
+ "description": "Enable the delegate tool for task distribution to subagents"
1293
+ },
1294
+ "enableTasks": {
1295
+ "type": "boolean",
1296
+ "description": "Enable task management for tracking multi-goal requests"
1297
+ },
1298
+ "retry": {
1299
+ "$ref": "#/definitions/AIRetryConfig",
1300
+ "description": "Retry configuration for this provider"
1301
+ },
1302
+ "fallback": {
1303
+ "$ref": "#/definitions/AIFallbackConfig",
1304
+ "description": "Fallback configuration for provider failures"
1305
+ },
1306
+ "allowEdit": {
1307
+ "type": "boolean",
1308
+ "description": "Enable Edit and Create tools for file modification (disabled by default for security)"
1309
+ },
1310
+ "allowedTools": {
1311
+ "type": "array",
1312
+ "items": {
1313
+ "type": "string"
1314
+ },
1315
+ "description": "Filter allowed tools - supports whitelist, exclusion (!prefix), or raw AI mode (empty array)"
1316
+ },
1317
+ "disableTools": {
1318
+ "type": "boolean",
1319
+ "description": "Disable all tools for raw AI mode (alternative to allowedTools: [])"
1320
+ },
1321
+ "allowBash": {
1322
+ "type": "boolean",
1323
+ "description": "Enable bash command execution (shorthand for bashConfig.enabled)"
1324
+ },
1325
+ "search_delegate_provider": {
1326
+ "type": "string",
1327
+ "description": "Override provider for search delegate sub-agents (e.g., 'google' for cheaper search)"
1328
+ },
1329
+ "search_delegate_model": {
1330
+ "type": "string",
1331
+ "description": "Override model for search delegate sub-agents (e.g., 'gemini-2.0-flash')"
1332
+ },
1333
+ "bashConfig": {
1334
+ "$ref": "#/definitions/BashConfig",
1335
+ "description": "Advanced bash command execution configuration"
1336
+ },
1337
+ "completion_prompt": {
1338
+ "type": "string",
1339
+ "description": "Completion prompt for post-completion validation/review (runs after attempt_completion)"
1340
+ },
1341
+ "enable_scheduler": {
1342
+ "type": "boolean",
1343
+ "description": "Enable the schedule tool for scheduling workflow executions (requires scheduler configuration)"
1344
+ },
1345
+ "enableExecutePlan": {
1346
+ "type": "boolean",
1347
+ "description": "Enable the execute_plan DSL orchestration tool (replaces analyze_all when enabled)"
1348
+ }
1349
+ },
1350
+ "additionalProperties": false,
1351
+ "description": "AI provider configuration",
1352
+ "patternProperties": {
1353
+ "^x-": {}
1354
+ }
1355
+ },
1356
+ "AIRetryConfig": {
1357
+ "type": "object",
1358
+ "properties": {
1359
+ "maxRetries": {
1360
+ "type": "number",
1361
+ "description": "Maximum retry attempts (0-50)"
1362
+ },
1363
+ "initialDelay": {
1364
+ "type": "number",
1365
+ "description": "Initial delay in milliseconds (0-60000)"
1366
+ },
1367
+ "maxDelay": {
1368
+ "type": "number",
1369
+ "description": "Maximum delay cap in milliseconds (0-300000)"
1370
+ },
1371
+ "backoffFactor": {
1372
+ "type": "number",
1373
+ "description": "Exponential backoff multiplier (1-10)"
1374
+ },
1375
+ "retryableErrors": {
1376
+ "type": "array",
1377
+ "items": {
1378
+ "type": "string"
1379
+ },
1380
+ "description": "Custom error patterns to retry on"
1381
+ }
1382
+ },
1383
+ "additionalProperties": false,
1384
+ "description": "Retry configuration for AI provider calls",
1385
+ "patternProperties": {
1386
+ "^x-": {}
1387
+ }
1388
+ },
1389
+ "AIFallbackConfig": {
1390
+ "type": "object",
1391
+ "properties": {
1392
+ "strategy": {
1393
+ "type": "string",
1394
+ "enum": [
1395
+ "same-model",
1396
+ "same-provider",
1397
+ "any",
1398
+ "custom"
1399
+ ],
1400
+ "description": "Fallback strategy: 'same-model', 'same-provider', 'any', or 'custom'"
1401
+ },
1402
+ "providers": {
1403
+ "type": "array",
1404
+ "items": {
1405
+ "$ref": "#/definitions/AIFallbackProviderConfig"
1406
+ },
1407
+ "description": "Array of fallback provider configurations"
1408
+ },
1409
+ "maxTotalAttempts": {
1410
+ "type": "number",
1411
+ "description": "Maximum total attempts across all providers"
1412
+ },
1413
+ "auto": {
1414
+ "type": "boolean",
1415
+ "description": "Enable automatic fallback using available environment variables"
1416
+ }
1417
+ },
1418
+ "additionalProperties": false,
1419
+ "description": "Fallback configuration for AI providers",
1420
+ "patternProperties": {
1421
+ "^x-": {}
1422
+ }
1423
+ },
1424
+ "AIFallbackProviderConfig": {
1425
+ "type": "object",
1426
+ "properties": {
1427
+ "provider": {
1428
+ "type": "string",
1429
+ "enum": [
1430
+ "google",
1431
+ "anthropic",
1432
+ "openai",
1433
+ "bedrock"
1434
+ ],
1435
+ "description": "AI provider to use"
1436
+ },
1437
+ "model": {
1438
+ "type": "string",
1439
+ "description": "Model name to use"
1440
+ },
1441
+ "apiKey": {
1442
+ "type": "string",
1443
+ "description": "API key for this provider"
1444
+ },
1445
+ "maxRetries": {
1446
+ "type": "number",
1447
+ "description": "Per-provider retry override"
1448
+ },
1449
+ "region": {
1450
+ "type": "string",
1451
+ "description": "AWS region (for Bedrock)"
1452
+ },
1453
+ "accessKeyId": {
1454
+ "type": "string",
1455
+ "description": "AWS access key ID (for Bedrock)"
1456
+ },
1457
+ "secretAccessKey": {
1458
+ "type": "string",
1459
+ "description": "AWS secret access key (for Bedrock)"
1460
+ }
1461
+ },
1462
+ "required": [
1463
+ "provider",
1464
+ "model"
1465
+ ],
1466
+ "additionalProperties": false,
1467
+ "description": "Fallback provider configuration",
1468
+ "patternProperties": {
1469
+ "^x-": {}
1470
+ }
1471
+ },
1472
+ "BashConfig": {
1473
+ "type": "object",
1474
+ "properties": {
1475
+ "allow": {
1476
+ "type": "array",
1477
+ "items": {
1478
+ "type": "string"
1479
+ },
1480
+ "description": "Array of permitted command patterns (e.g., ['ls', 'git status'])"
1481
+ },
1482
+ "deny": {
1483
+ "type": "array",
1484
+ "items": {
1485
+ "type": "string"
1486
+ },
1487
+ "description": "Array of blocked command patterns (e.g., ['rm -rf', 'sudo'])"
1488
+ },
1489
+ "disableDefaultAllow": {
1490
+ "type": "boolean",
1491
+ "description": "Disable default safe command list (use with caution)"
1492
+ },
1493
+ "disableDefaultDeny": {
1494
+ "type": "boolean",
1495
+ "description": "Disable default dangerous command blocklist (use with extreme caution)"
1496
+ },
1497
+ "timeout": {
1498
+ "type": "number",
1499
+ "description": "Execution timeout in milliseconds"
1500
+ },
1501
+ "workingDirectory": {
1502
+ "type": "string",
1503
+ "description": "Default working directory for command execution"
1504
+ }
1505
+ },
1506
+ "additionalProperties": false,
1507
+ "description": "Bash command execution configuration for ProbeAgent Note: Use 'allowBash: true' in AIProviderConfig to enable bash execution",
1508
+ "patternProperties": {
1509
+ "^x-": {}
1510
+ }
1511
+ },
1512
+ "ClaudeCodeConfig": {
1513
+ "type": "object",
1514
+ "properties": {
1515
+ "allowedTools": {
1516
+ "type": "array",
1517
+ "items": {
1518
+ "type": "string"
1519
+ },
1520
+ "description": "List of allowed tools for Claude Code to use"
1521
+ },
1522
+ "maxTurns": {
1523
+ "type": "number",
1524
+ "description": "Maximum number of turns in conversation"
1525
+ },
1526
+ "systemPrompt": {
1527
+ "type": "string",
1528
+ "description": "System prompt for Claude Code"
1529
+ },
1530
+ "mcpServers": {
1531
+ "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
1532
+ "description": "MCP servers configuration"
1533
+ },
1534
+ "subagent": {
1535
+ "type": "string",
1536
+ "description": "Path to subagent script"
1537
+ },
1538
+ "enableDelegate": {
1539
+ "type": "boolean",
1540
+ "description": "Enable the delegate tool for task distribution to subagents"
1541
+ },
1542
+ "hooks": {
1543
+ "type": "object",
1544
+ "properties": {
1545
+ "onStart": {
1546
+ "type": "string",
1547
+ "description": "Called when check starts"
1548
+ },
1549
+ "onEnd": {
1550
+ "type": "string",
1551
+ "description": "Called when check ends"
1552
+ },
1553
+ "onError": {
1554
+ "type": "string",
1555
+ "description": "Called when check encounters an error"
1556
+ }
1557
+ },
1558
+ "additionalProperties": false,
1559
+ "description": "Event hooks for lifecycle management",
1560
+ "patternProperties": {
1561
+ "^x-": {}
1562
+ }
1563
+ }
1564
+ },
1565
+ "additionalProperties": false,
1566
+ "description": "Claude Code configuration",
1567
+ "patternProperties": {
1568
+ "^x-": {}
1569
+ }
1570
+ },
1571
+ "EnvConfig": {
1572
+ "type": "object",
1573
+ "additionalProperties": {
1574
+ "type": [
1575
+ "string",
1576
+ "number",
1577
+ "boolean"
1578
+ ]
1579
+ },
1580
+ "description": "Environment variable reference configuration"
1581
+ },
1582
+ "CustomTemplateConfig": {
1583
+ "type": "object",
1584
+ "properties": {
1585
+ "file": {
1586
+ "type": "string",
1587
+ "description": "Path to custom template file (relative to config file or absolute)"
1588
+ },
1589
+ "content": {
1590
+ "type": "string",
1591
+ "description": "Raw template content as string"
1592
+ }
1593
+ },
1594
+ "additionalProperties": false,
1595
+ "description": "Custom template configuration",
1596
+ "patternProperties": {
1597
+ "^x-": {}
1598
+ }
1599
+ },
1600
+ "FailureConditions": {
1601
+ "type": "object",
1602
+ "additionalProperties": {
1603
+ "$ref": "#/definitions/FailureCondition"
1604
+ },
1605
+ "description": "Collection of failure conditions"
1606
+ },
1607
+ "FailureCondition": {
1608
+ "anyOf": [
1609
+ {
1610
+ "$ref": "#/definitions/SimpleFailureCondition"
1611
+ },
1612
+ {
1613
+ "$ref": "#/definitions/ComplexFailureCondition"
1614
+ }
1615
+ ],
1616
+ "description": "Failure condition - can be a simple expression string or complex object"
1617
+ },
1618
+ "SimpleFailureCondition": {
1619
+ "type": "string",
1620
+ "description": "Simple failure condition - just an expression string"
1621
+ },
1622
+ "ComplexFailureCondition": {
1623
+ "type": "object",
1624
+ "properties": {
1625
+ "condition": {
1626
+ "type": "string",
1627
+ "description": "Expression to evaluate using Function Constructor"
1628
+ },
1629
+ "message": {
1630
+ "type": "string",
1631
+ "description": "Human-readable message when condition is met"
1632
+ },
1633
+ "severity": {
1634
+ "$ref": "#/definitions/FailureConditionSeverity",
1635
+ "description": "Severity level of the failure"
1636
+ },
1637
+ "halt_execution": {
1638
+ "type": "boolean",
1639
+ "description": "Whether this condition should halt execution"
1640
+ }
1641
+ },
1642
+ "required": [
1643
+ "condition"
1644
+ ],
1645
+ "additionalProperties": false,
1646
+ "description": "Complex failure condition with additional metadata",
1647
+ "patternProperties": {
1648
+ "^x-": {}
1649
+ }
1650
+ },
1651
+ "FailureConditionSeverity": {
1652
+ "type": "string",
1653
+ "enum": [
1654
+ "error",
1655
+ "warning",
1656
+ "info"
1657
+ ],
1658
+ "description": "Failure condition severity levels"
1659
+ },
1660
+ "OnInitConfig": {
1661
+ "type": "object",
1662
+ "properties": {
1663
+ "run": {
1664
+ "type": "array",
1665
+ "items": {
1666
+ "$ref": "#/definitions/OnInitRunItem"
1667
+ },
1668
+ "description": "Items to run before this check executes"
1669
+ },
1670
+ "run_js": {
1671
+ "type": "string",
1672
+ "description": "Dynamic init items: JS expression returning OnInitRunItem[]"
1673
+ },
1674
+ "transitions": {
1675
+ "type": "array",
1676
+ "items": {
1677
+ "$ref": "#/definitions/TransitionRule"
1678
+ },
1679
+ "description": "Declarative transitions (optional, for advanced use cases)"
1680
+ }
1681
+ },
1682
+ "additionalProperties": false,
1683
+ "description": "Init routing configuration per check Runs BEFORE the check executes (preprocessing/setup)",
1684
+ "patternProperties": {
1685
+ "^x-": {}
1686
+ }
1687
+ },
1688
+ "OnInitRunItem": {
1689
+ "anyOf": [
1690
+ {
1691
+ "$ref": "#/definitions/OnInitToolInvocation"
1692
+ },
1693
+ {
1694
+ "$ref": "#/definitions/OnInitStepInvocation"
1695
+ },
1696
+ {
1697
+ "$ref": "#/definitions/OnInitWorkflowInvocation"
1698
+ },
1699
+ {
1700
+ "type": "string"
1701
+ }
1702
+ ],
1703
+ "description": "Unified on_init run item - can be tool, step, workflow, or plain string"
1704
+ },
1705
+ "OnInitToolInvocation": {
1706
+ "type": "object",
1707
+ "properties": {
1708
+ "tool": {
1709
+ "type": "string",
1710
+ "description": "Tool name (must exist in tools: section)"
1711
+ },
1712
+ "with": {
1713
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1714
+ "description": "Arguments to pass to the tool (Liquid templates supported)"
1715
+ },
1716
+ "as": {
1717
+ "type": "string",
1718
+ "description": "Custom output name (defaults to tool name)"
1719
+ }
1720
+ },
1721
+ "required": [
1722
+ "tool"
1723
+ ],
1724
+ "additionalProperties": false,
1725
+ "description": "Invoke a custom tool (from tools: section)",
1726
+ "patternProperties": {
1727
+ "^x-": {}
1728
+ }
1729
+ },
1730
+ "OnInitStepInvocation": {
1731
+ "type": "object",
1732
+ "properties": {
1733
+ "step": {
1734
+ "type": "string",
1735
+ "description": "Step name (must exist in steps: section)"
1736
+ },
1737
+ "with": {
1738
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1739
+ "description": "Arguments to pass to the step (Liquid templates supported)"
1740
+ },
1741
+ "as": {
1742
+ "type": "string",
1743
+ "description": "Custom output name (defaults to step name)"
1744
+ }
1745
+ },
1746
+ "required": [
1747
+ "step"
1748
+ ],
1749
+ "additionalProperties": false,
1750
+ "description": "Invoke a helper step (regular check)",
1751
+ "patternProperties": {
1752
+ "^x-": {}
1753
+ }
1754
+ },
1755
+ "OnInitWorkflowInvocation": {
1756
+ "type": "object",
1757
+ "properties": {
1758
+ "workflow": {
1759
+ "type": "string",
1760
+ "description": "Workflow ID or path"
1761
+ },
1762
+ "with": {
1763
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1764
+ "description": "Workflow inputs (Liquid templates supported)"
1765
+ },
1766
+ "as": {
1767
+ "type": "string",
1768
+ "description": "Custom output name (defaults to workflow name)"
1769
+ },
1770
+ "overrides": {
1771
+ "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833%3E%3E",
1772
+ "description": "Step overrides"
1773
+ },
1774
+ "output_mapping": {
1775
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
1776
+ "description": "Output mapping"
1777
+ }
1778
+ },
1779
+ "required": [
1780
+ "workflow"
1781
+ ],
1782
+ "additionalProperties": false,
1783
+ "description": "Invoke a reusable workflow",
1784
+ "patternProperties": {
1785
+ "^x-": {}
1786
+ }
1787
+ },
1788
+ "Record<string,Partial<interface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833>>": {
1789
+ "type": "object",
1790
+ "additionalProperties": {
1791
+ "$ref": "#/definitions/Partial%3Cinterface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833%3E"
1792
+ }
1793
+ },
1794
+ "Partial<interface-src_types_config.ts-14017-28611-src_types_config.ts-0-56833>": {
1795
+ "type": "object",
1796
+ "additionalProperties": false
1797
+ },
1798
+ "TransitionRule": {
1799
+ "type": "object",
1800
+ "properties": {
1801
+ "when": {
1802
+ "type": "string",
1803
+ "description": "JavaScript expression evaluated in the same sandbox as goto_js; truthy enables the rule."
1804
+ },
1805
+ "to": {
1806
+ "type": [
1807
+ "string",
1808
+ "null"
1809
+ ],
1810
+ "description": "Target step ID, or null to explicitly prevent goto."
1811
+ },
1812
+ "goto_event": {
1813
+ "$ref": "#/definitions/EventTrigger",
1814
+ "description": "Optional event override when performing goto."
1815
+ }
1816
+ },
1817
+ "required": [
1818
+ "when"
1819
+ ],
1820
+ "additionalProperties": false,
1821
+ "description": "Declarative transition rule for on_* blocks.",
1822
+ "patternProperties": {
1823
+ "^x-": {}
1824
+ }
1825
+ },
1826
+ "OnFailConfig": {
1827
+ "type": "object",
1828
+ "properties": {
1829
+ "retry": {
1830
+ "$ref": "#/definitions/RetryPolicy",
1831
+ "description": "Retry policy"
1832
+ },
1833
+ "run": {
1834
+ "type": "array",
1835
+ "items": {
1836
+ "type": "string"
1837
+ },
1838
+ "description": "Remediation steps to run before reattempt"
1839
+ },
1840
+ "goto": {
1841
+ "type": "string",
1842
+ "description": "Jump back to an ancestor step (by id)"
1843
+ },
1844
+ "goto_event": {
1845
+ "$ref": "#/definitions/EventTrigger",
1846
+ "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1847
+ },
1848
+ "goto_js": {
1849
+ "type": "string",
1850
+ "description": "Dynamic goto: JS expression returning step id or null"
1851
+ },
1852
+ "run_js": {
1853
+ "type": "string",
1854
+ "description": "Dynamic remediation list: JS expression returning string[]"
1855
+ },
1856
+ "transitions": {
1857
+ "type": "array",
1858
+ "items": {
1859
+ "$ref": "#/definitions/TransitionRule"
1860
+ },
1861
+ "description": "Declarative transitions. Evaluated in order; first matching rule wins. If a rule's `to` is null, no goto occurs. When omitted or none match, the engine falls back to goto_js/goto for backward compatibility."
1862
+ }
1863
+ },
1864
+ "additionalProperties": false,
1865
+ "description": "Failure routing configuration per check",
1866
+ "patternProperties": {
1867
+ "^x-": {}
1868
+ }
1869
+ },
1870
+ "RetryPolicy": {
1871
+ "type": "object",
1872
+ "properties": {
1873
+ "max": {
1874
+ "type": "number",
1875
+ "description": "Maximum retry attempts (excluding the first attempt)"
1876
+ },
1877
+ "backoff": {
1878
+ "$ref": "#/definitions/BackoffPolicy",
1879
+ "description": "Backoff policy"
1880
+ }
1881
+ },
1882
+ "additionalProperties": false,
1883
+ "description": "Retry policy for a step",
1884
+ "patternProperties": {
1885
+ "^x-": {}
1886
+ }
1887
+ },
1888
+ "BackoffPolicy": {
1889
+ "type": "object",
1890
+ "properties": {
1891
+ "mode": {
1892
+ "type": "string",
1893
+ "enum": [
1894
+ "fixed",
1895
+ "exponential"
1896
+ ],
1897
+ "description": "Backoff mode"
1898
+ },
1899
+ "delay_ms": {
1900
+ "type": "number",
1901
+ "description": "Initial delay in milliseconds"
1902
+ }
1903
+ },
1904
+ "additionalProperties": false,
1905
+ "description": "Backoff policy for retries",
1906
+ "patternProperties": {
1907
+ "^x-": {}
1908
+ }
1909
+ },
1910
+ "OnSuccessConfig": {
1911
+ "type": "object",
1912
+ "properties": {
1913
+ "run": {
1914
+ "type": "array",
1915
+ "items": {
1916
+ "$ref": "#/definitions/OnSuccessRunItem"
1917
+ },
1918
+ "description": "Post-success steps to run - can be step names or rich invocations with arguments"
1919
+ },
1920
+ "goto": {
1921
+ "type": "string",
1922
+ "description": "Optional jump back to ancestor step (by id)"
1923
+ },
1924
+ "goto_event": {
1925
+ "$ref": "#/definitions/EventTrigger",
1926
+ "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1927
+ },
1928
+ "goto_js": {
1929
+ "type": "string",
1930
+ "description": "Dynamic goto: JS expression returning step id or null"
1931
+ },
1932
+ "run_js": {
1933
+ "type": "string",
1934
+ "description": "Dynamic post-success steps: JS expression returning string[]"
1935
+ },
1936
+ "transitions": {
1937
+ "type": "array",
1938
+ "items": {
1939
+ "$ref": "#/definitions/TransitionRule"
1940
+ },
1941
+ "description": "Declarative transitions (see OnFailConfig.transitions)."
1942
+ }
1943
+ },
1944
+ "additionalProperties": false,
1945
+ "description": "Success routing configuration per check",
1946
+ "patternProperties": {
1947
+ "^x-": {}
1948
+ }
1949
+ },
1950
+ "OnSuccessRunItem": {
1951
+ "anyOf": [
1952
+ {
1953
+ "type": "string"
1954
+ },
1955
+ {
1956
+ "$ref": "#/definitions/OnInitStepInvocation"
1957
+ },
1958
+ {
1959
+ "$ref": "#/definitions/OnInitWorkflowInvocation"
1960
+ }
1961
+ ],
1962
+ "description": "Success routing run item - can be step name, step with args, or workflow with args"
1963
+ },
1964
+ "OnFinishConfig": {
1965
+ "type": "object",
1966
+ "properties": {
1967
+ "run": {
1968
+ "type": "array",
1969
+ "items": {
1970
+ "type": "string"
1971
+ },
1972
+ "description": "Post-finish steps to run"
1973
+ },
1974
+ "goto": {
1975
+ "type": "string",
1976
+ "description": "Optional jump back to ancestor step (by id)"
1977
+ },
1978
+ "goto_event": {
1979
+ "$ref": "#/definitions/EventTrigger",
1980
+ "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1981
+ },
1982
+ "goto_js": {
1983
+ "type": "string",
1984
+ "description": "Dynamic goto: JS expression returning step id or null"
1985
+ },
1986
+ "run_js": {
1987
+ "type": "string",
1988
+ "description": "Dynamic post-finish steps: JS expression returning string[]"
1989
+ },
1990
+ "transitions": {
1991
+ "type": "array",
1992
+ "items": {
1993
+ "$ref": "#/definitions/TransitionRule"
1994
+ },
1995
+ "description": "Declarative transitions (see OnFailConfig.transitions)."
1996
+ }
1997
+ },
1998
+ "additionalProperties": false,
1999
+ "description": "Finish routing configuration for forEach checks Runs once after ALL iterations of forEach and ALL dependent checks complete",
2000
+ "patternProperties": {
2001
+ "^x-": {}
2002
+ }
2003
+ },
2004
+ "StepPolicyOverride": {
2005
+ "type": "object",
2006
+ "properties": {
2007
+ "require": {
2008
+ "anyOf": [
2009
+ {
2010
+ "type": "string"
2011
+ },
2012
+ {
2013
+ "type": "array",
2014
+ "items": {
2015
+ "type": "string"
2016
+ }
2017
+ }
2018
+ ],
2019
+ "description": "Required role(s) - any of these roles suffices"
2020
+ },
2021
+ "deny": {
2022
+ "type": "array",
2023
+ "items": {
2024
+ "type": "string"
2025
+ },
2026
+ "description": "Explicit deny for roles"
2027
+ },
2028
+ "rule": {
2029
+ "type": "string",
2030
+ "description": "Custom OPA rule path for this step"
2031
+ }
2032
+ },
2033
+ "additionalProperties": false,
2034
+ "patternProperties": {
2035
+ "^x-": {}
2036
+ }
2037
+ },
2038
+ "OutputConfig": {
2039
+ "type": "object",
2040
+ "properties": {
2041
+ "pr_comment": {
2042
+ "$ref": "#/definitions/PrCommentOutput",
2043
+ "description": "PR comment configuration"
2044
+ },
2045
+ "file_comment": {
2046
+ "$ref": "#/definitions/FileCommentOutput",
2047
+ "description": "File comment configuration (optional)"
2048
+ },
2049
+ "github_checks": {
2050
+ "$ref": "#/definitions/GitHubCheckOutput",
2051
+ "description": "GitHub check runs configuration (optional)"
2052
+ },
2053
+ "suppressionEnabled": {
2054
+ "type": "boolean",
2055
+ "description": "Whether to enable issue suppression via visor-disable comments (default: true)"
2056
+ }
2057
+ },
2058
+ "required": [
2059
+ "pr_comment"
2060
+ ],
2061
+ "additionalProperties": false,
2062
+ "description": "Output configuration",
2063
+ "patternProperties": {
2064
+ "^x-": {}
2065
+ }
2066
+ },
2067
+ "PrCommentOutput": {
2068
+ "type": "object",
2069
+ "properties": {
2070
+ "enabled": {
2071
+ "type": "boolean",
2072
+ "description": "Whether PR comments are enabled"
2073
+ },
2074
+ "format": {
2075
+ "$ref": "#/definitions/ConfigOutputFormat",
2076
+ "description": "Format of the output"
2077
+ },
2078
+ "group_by": {
2079
+ "$ref": "#/definitions/GroupByOption",
2080
+ "description": "How to group the results"
2081
+ },
2082
+ "collapse": {
2083
+ "type": "boolean",
2084
+ "description": "Whether to collapse sections by default"
2085
+ },
2086
+ "debug": {
2087
+ "$ref": "#/definitions/DebugConfig",
2088
+ "description": "Debug mode configuration (optional)"
2089
+ }
2090
+ },
2091
+ "required": [
2092
+ "format",
2093
+ "group_by",
2094
+ "collapse"
2095
+ ],
2096
+ "additionalProperties": false,
2097
+ "description": "PR comment output configuration",
2098
+ "patternProperties": {
2099
+ "^x-": {}
2100
+ }
2101
+ },
2102
+ "ConfigOutputFormat": {
2103
+ "type": "string",
2104
+ "enum": [
2105
+ "table",
2106
+ "json",
2107
+ "markdown",
2108
+ "sarif"
2109
+ ],
2110
+ "description": "Valid output formats"
2111
+ },
2112
+ "GroupByOption": {
2113
+ "type": "string",
2114
+ "enum": [
2115
+ "check",
2116
+ "file",
2117
+ "severity",
2118
+ "group"
2119
+ ],
2120
+ "description": "Valid grouping options"
2121
+ },
2122
+ "DebugConfig": {
2123
+ "type": "object",
2124
+ "properties": {
2125
+ "enabled": {
2126
+ "type": "boolean",
2127
+ "description": "Enable debug mode"
2128
+ },
2129
+ "includePrompts": {
2130
+ "type": "boolean",
2131
+ "description": "Include AI prompts in debug output"
2132
+ },
2133
+ "includeRawResponses": {
2134
+ "type": "boolean",
2135
+ "description": "Include raw AI responses in debug output"
2136
+ },
2137
+ "includeTiming": {
2138
+ "type": "boolean",
2139
+ "description": "Include timing information"
2140
+ },
2141
+ "includeProviderInfo": {
2142
+ "type": "boolean",
2143
+ "description": "Include provider information"
2144
+ }
2145
+ },
2146
+ "required": [
2147
+ "enabled",
2148
+ "includePrompts",
2149
+ "includeRawResponses",
2150
+ "includeTiming",
2151
+ "includeProviderInfo"
2152
+ ],
2153
+ "additionalProperties": false,
2154
+ "description": "Debug mode configuration",
2155
+ "patternProperties": {
2156
+ "^x-": {}
2157
+ }
2158
+ },
2159
+ "FileCommentOutput": {
2160
+ "type": "object",
2161
+ "properties": {
2162
+ "enabled": {
2163
+ "type": "boolean",
2164
+ "description": "Whether file comments are enabled"
2165
+ },
2166
+ "inline": {
2167
+ "type": "boolean",
2168
+ "description": "Whether to show inline comments"
2169
+ }
2170
+ },
2171
+ "required": [
2172
+ "enabled",
2173
+ "inline"
2174
+ ],
2175
+ "additionalProperties": false,
2176
+ "description": "File comment output configuration",
2177
+ "patternProperties": {
2178
+ "^x-": {}
2179
+ }
2180
+ },
2181
+ "GitHubCheckOutput": {
2182
+ "type": "object",
2183
+ "properties": {
2184
+ "enabled": {
2185
+ "type": "boolean",
2186
+ "description": "Whether GitHub check runs are enabled"
2187
+ },
2188
+ "per_check": {
2189
+ "type": "boolean",
2190
+ "description": "Whether to create individual check runs per configured check"
2191
+ },
2192
+ "name_prefix": {
2193
+ "type": "string",
2194
+ "description": "Custom name prefix for check runs"
2195
+ }
2196
+ },
2197
+ "required": [
2198
+ "enabled",
2199
+ "per_check"
2200
+ ],
2201
+ "additionalProperties": false,
2202
+ "description": "GitHub Check Runs output configuration",
2203
+ "patternProperties": {
2204
+ "^x-": {}
2205
+ }
2206
+ },
2207
+ "HttpServerConfig": {
2208
+ "type": "object",
2209
+ "properties": {
2210
+ "enabled": {
2211
+ "type": "boolean",
2212
+ "description": "Whether HTTP server is enabled"
2213
+ },
2214
+ "port": {
2215
+ "type": "number",
2216
+ "description": "Port to listen on"
2217
+ },
2218
+ "host": {
2219
+ "type": "string",
2220
+ "description": "Host/IP to bind to (defaults to 0.0.0.0)"
2221
+ },
2222
+ "tls": {
2223
+ "$ref": "#/definitions/TlsConfig",
2224
+ "description": "TLS/SSL configuration for HTTPS"
2225
+ },
2226
+ "auth": {
2227
+ "$ref": "#/definitions/HttpAuthConfig",
2228
+ "description": "Authentication configuration"
2229
+ },
2230
+ "endpoints": {
2231
+ "type": "array",
2232
+ "items": {
2233
+ "$ref": "#/definitions/HttpEndpointConfig"
2234
+ },
2235
+ "description": "HTTP endpoints configuration"
2236
+ }
2237
+ },
2238
+ "required": [
2239
+ "enabled",
2240
+ "port"
2241
+ ],
2242
+ "additionalProperties": false,
2243
+ "description": "HTTP server configuration for receiving webhooks",
2244
+ "patternProperties": {
2245
+ "^x-": {}
2246
+ }
2247
+ },
2248
+ "TlsConfig": {
2249
+ "type": "object",
2250
+ "properties": {
2251
+ "enabled": {
2252
+ "type": "boolean",
2253
+ "description": "Enable TLS/HTTPS"
2254
+ },
2255
+ "cert": {
2256
+ "type": "string",
2257
+ "description": "Path to TLS certificate file or certificate content"
2258
+ },
2259
+ "key": {
2260
+ "type": "string",
2261
+ "description": "Path to TLS key file or key content"
2262
+ },
2263
+ "ca": {
2264
+ "type": "string",
2265
+ "description": "Path to CA certificate file or CA content (optional)"
2266
+ },
2267
+ "rejectUnauthorized": {
2268
+ "type": "boolean",
2269
+ "description": "Reject unauthorized connections (default: true)"
2270
+ }
2271
+ },
2272
+ "required": [
2273
+ "enabled"
2274
+ ],
2275
+ "additionalProperties": false,
2276
+ "description": "TLS/SSL configuration for HTTPS server",
2277
+ "patternProperties": {
2278
+ "^x-": {}
2279
+ }
2280
+ },
2281
+ "HttpAuthConfig": {
2282
+ "type": "object",
2283
+ "properties": {
2284
+ "type": {
2285
+ "type": "string",
2286
+ "enum": [
2287
+ "bearer_token",
2288
+ "hmac",
2289
+ "basic",
2290
+ "none"
2291
+ ],
2292
+ "description": "Authentication type"
2293
+ },
2294
+ "secret": {
2295
+ "type": "string",
2296
+ "description": "Secret or token for authentication"
2297
+ },
2298
+ "username": {
2299
+ "type": "string",
2300
+ "description": "Username for basic auth"
2301
+ },
2302
+ "password": {
2303
+ "type": "string",
2304
+ "description": "Password for basic auth"
2305
+ }
2306
+ },
2307
+ "required": [
2308
+ "type"
2309
+ ],
2310
+ "additionalProperties": false,
2311
+ "description": "HTTP server authentication configuration",
2312
+ "patternProperties": {
2313
+ "^x-": {}
2314
+ }
2315
+ },
2316
+ "HttpEndpointConfig": {
2317
+ "type": "object",
2318
+ "properties": {
2319
+ "path": {
2320
+ "type": "string",
2321
+ "description": "Path for the webhook endpoint"
2322
+ },
2323
+ "transform": {
2324
+ "type": "string",
2325
+ "description": "Optional transform template (Liquid) for the received data"
2326
+ },
2327
+ "name": {
2328
+ "type": "string",
2329
+ "description": "Optional name/ID for this endpoint"
2330
+ }
2331
+ },
2332
+ "required": [
2333
+ "path"
2334
+ ],
2335
+ "additionalProperties": false,
2336
+ "description": "HTTP server endpoint configuration",
2337
+ "patternProperties": {
2338
+ "^x-": {}
2339
+ }
2340
+ },
2341
+ "MemoryConfig": {
2342
+ "type": "object",
2343
+ "properties": {
2344
+ "storage": {
2345
+ "type": "string",
2346
+ "enum": [
2347
+ "memory",
2348
+ "file"
2349
+ ],
2350
+ "description": "Storage mode: \"memory\" (in-memory, default) or \"file\" (persistent)"
2351
+ },
2352
+ "format": {
2353
+ "type": "string",
2354
+ "enum": [
2355
+ "json",
2356
+ "csv"
2357
+ ],
2358
+ "description": "Storage format (only for file storage, default: json)"
2359
+ },
2360
+ "file": {
2361
+ "type": "string",
2362
+ "description": "File path (required if storage: file)"
2363
+ },
2364
+ "namespace": {
2365
+ "type": "string",
2366
+ "description": "Default namespace (default: \"default\")"
2367
+ },
2368
+ "auto_load": {
2369
+ "type": "boolean",
2370
+ "description": "Auto-load on startup (default: true if storage: file)"
2371
+ },
2372
+ "auto_save": {
2373
+ "type": "boolean",
2374
+ "description": "Auto-save after operations (default: true if storage: file)"
2375
+ }
2376
+ },
2377
+ "additionalProperties": false,
2378
+ "description": "Memory storage configuration",
2379
+ "patternProperties": {
2380
+ "^x-": {}
2381
+ }
2382
+ },
2383
+ "TagFilter": {
2384
+ "type": "object",
2385
+ "properties": {
2386
+ "include": {
2387
+ "type": "array",
2388
+ "items": {
2389
+ "type": "string"
2390
+ },
2391
+ "description": "Tags that checks must have to be included (ANY match)"
2392
+ },
2393
+ "exclude": {
2394
+ "type": "array",
2395
+ "items": {
2396
+ "type": "string"
2397
+ },
2398
+ "description": "Tags that will exclude checks if present (ANY match)"
2399
+ }
2400
+ },
2401
+ "additionalProperties": false,
2402
+ "description": "Tag filter configuration for selective check execution",
2403
+ "patternProperties": {
2404
+ "^x-": {}
2405
+ }
2406
+ },
2407
+ "RoutingDefaults": {
2408
+ "type": "object",
2409
+ "properties": {
2410
+ "max_loops": {
2411
+ "type": "number",
2412
+ "description": "Per-scope cap on routing transitions (success + failure)"
2413
+ },
2414
+ "defaults": {
2415
+ "type": "object",
2416
+ "properties": {
2417
+ "on_fail": {
2418
+ "$ref": "#/definitions/OnFailConfig"
2419
+ }
2420
+ },
2421
+ "additionalProperties": false,
2422
+ "description": "Default policies applied to checks (step-level overrides take precedence)",
2423
+ "patternProperties": {
2424
+ "^x-": {}
2425
+ }
2426
+ }
2427
+ },
2428
+ "additionalProperties": false,
2429
+ "description": "Global routing defaults",
2430
+ "patternProperties": {
2431
+ "^x-": {}
2432
+ }
2433
+ },
2434
+ "LimitsConfig": {
2435
+ "type": "object",
2436
+ "properties": {
2437
+ "max_runs_per_check": {
2438
+ "type": "number",
2439
+ "description": "Maximum number of executions per check within a single engine run. Applies to each distinct scope independently for forEach item executions. Set to 0 or negative to disable. Default: 50."
2440
+ },
2441
+ "max_workflow_depth": {
2442
+ "type": "number",
2443
+ "description": "Maximum nesting depth for workflows executed by the state machine engine. Nested workflows are invoked by the workflow provider; this limit prevents accidental infinite recursion. Default: 3."
2444
+ }
2445
+ },
2446
+ "additionalProperties": false,
2447
+ "description": "Global engine limits",
2448
+ "patternProperties": {
2449
+ "^x-": {}
2450
+ }
2451
+ },
2452
+ "WorkspaceConfig": {
2453
+ "type": "object",
2454
+ "properties": {
2455
+ "enabled": {
2456
+ "type": "boolean",
2457
+ "description": "Enable workspace isolation (default: true when config present)"
2458
+ },
2459
+ "base_path": {
2460
+ "type": "string",
2461
+ "description": "Base path for workspaces (default: /tmp/visor-workspaces)"
2462
+ },
2463
+ "name": {
2464
+ "type": "string",
2465
+ "description": "Workspace directory name (defaults to session id)"
2466
+ },
2467
+ "main_project_name": {
2468
+ "type": "string",
2469
+ "description": "Main project folder name inside the workspace (defaults to original directory name)"
2470
+ },
2471
+ "cleanup_on_exit": {
2472
+ "type": "boolean",
2473
+ "description": "Clean up workspace on exit (default: true)"
2474
+ },
2475
+ "include_main_project": {
2476
+ "type": "boolean",
2477
+ "description": "Include main project worktree in AI allowed folders (default: false)"
2478
+ }
2479
+ },
2480
+ "additionalProperties": false,
2481
+ "description": "Workspace isolation configuration",
2482
+ "patternProperties": {
2483
+ "^x-": {}
2484
+ }
2485
+ },
2486
+ "Record<string,SandboxConfig>": {
2487
+ "type": "object",
2488
+ "additionalProperties": {
2489
+ "$ref": "#/definitions/SandboxConfig"
2490
+ }
2491
+ },
2492
+ "SandboxConfig": {
2493
+ "type": "object",
2494
+ "properties": {
2495
+ "engine": {
2496
+ "type": "string",
2497
+ "enum": [
2498
+ "docker",
2499
+ "bubblewrap",
2500
+ "seatbelt"
2501
+ ],
2502
+ "description": "Sandbox engine type: 'docker' (default), 'bubblewrap' (Linux namespaces), or 'seatbelt' (macOS sandbox-exec)"
2503
+ },
2504
+ "image": {
2505
+ "type": "string",
2506
+ "description": "Docker image to use (e.g., \"node:20-alpine\")"
2507
+ },
2508
+ "dockerfile": {
2509
+ "type": "string",
2510
+ "description": "Path to Dockerfile (relative to config file or absolute)"
2511
+ },
2512
+ "dockerfile_inline": {
2513
+ "type": "string",
2514
+ "description": "Inline Dockerfile content"
2515
+ },
2516
+ "compose": {
2517
+ "type": "string",
2518
+ "description": "Path to docker-compose file"
2519
+ },
2520
+ "service": {
2521
+ "type": "string",
2522
+ "description": "Service name within the compose file"
2523
+ },
2524
+ "workdir": {
2525
+ "type": "string",
2526
+ "description": "Working directory inside container (default: /workspace)"
2527
+ },
2528
+ "env_passthrough": {
2529
+ "type": "array",
2530
+ "items": {
2531
+ "type": "string"
2532
+ },
2533
+ "description": "Glob patterns for host env vars to forward into sandbox"
2534
+ },
2535
+ "network": {
2536
+ "type": "boolean",
2537
+ "description": "Enable/disable network access (default: true)"
2538
+ },
2539
+ "read_only": {
2540
+ "type": "boolean",
2541
+ "description": "Mount repo as read-only (default: false)"
2542
+ },
2543
+ "resources": {
2544
+ "$ref": "#/definitions/SandboxResourceConfig",
2545
+ "description": "Resource limits"
2546
+ },
2547
+ "visor_path": {
2548
+ "type": "string",
2549
+ "description": "Where visor is mounted inside container (default: /opt/visor)"
2550
+ },
2551
+ "cache": {
2552
+ "$ref": "#/definitions/SandboxCacheConfig",
2553
+ "description": "Cache volume configuration"
2554
+ },
2555
+ "bind_paths": {
2556
+ "type": "array",
2557
+ "items": {
2558
+ "$ref": "#/definitions/SandboxBindPath"
2559
+ },
2560
+ "description": "Additional host paths to bind-mount into the sandbox"
2561
+ }
2562
+ },
2563
+ "additionalProperties": false,
2564
+ "description": "Configuration for a single sandbox environment",
2565
+ "patternProperties": {
2566
+ "^x-": {}
2567
+ }
2568
+ },
2569
+ "SandboxResourceConfig": {
2570
+ "type": "object",
2571
+ "properties": {
2572
+ "memory": {
2573
+ "type": "string",
2574
+ "description": "Memory limit (e.g., \"512m\", \"2g\")"
2575
+ },
2576
+ "cpu": {
2577
+ "type": "number",
2578
+ "description": "CPU limit (e.g., 1.0, 0.5)"
2579
+ }
2580
+ },
2581
+ "additionalProperties": false,
2582
+ "description": "Resource limits for sandbox containers",
2583
+ "patternProperties": {
2584
+ "^x-": {}
2585
+ }
2586
+ },
2587
+ "SandboxCacheConfig": {
2588
+ "type": "object",
2589
+ "properties": {
2590
+ "prefix": {
2591
+ "type": "string",
2592
+ "description": "Liquid template for cache scope prefix (default: git branch)"
2593
+ },
2594
+ "fallback_prefix": {
2595
+ "type": "string",
2596
+ "description": "Fallback prefix when current prefix has no cache"
2597
+ },
2598
+ "paths": {
2599
+ "type": "array",
2600
+ "items": {
2601
+ "type": "string"
2602
+ },
2603
+ "description": "Paths inside the container to cache"
2604
+ },
2605
+ "ttl": {
2606
+ "type": "string",
2607
+ "description": "Time-to-live for cache volumes (e.g., \"7d\", \"24h\")"
2608
+ },
2609
+ "max_scopes": {
2610
+ "type": "number",
2611
+ "description": "Maximum number of cache scopes to keep"
2612
+ }
2613
+ },
2614
+ "required": [
2615
+ "paths"
2616
+ ],
2617
+ "additionalProperties": false,
2618
+ "description": "Cache configuration for sandbox volumes",
2619
+ "patternProperties": {
2620
+ "^x-": {}
2621
+ }
2622
+ },
2623
+ "SandboxBindPath": {
2624
+ "type": "object",
2625
+ "properties": {
2626
+ "host": {
2627
+ "type": "string",
2628
+ "description": "Host path (supports ~ prefix for home directory)"
2629
+ },
2630
+ "container": {
2631
+ "type": "string",
2632
+ "description": "Container path (defaults to resolved host path)"
2633
+ },
2634
+ "read_only": {
2635
+ "type": "boolean",
2636
+ "description": "Mount as read-only (default: true)"
2637
+ }
2638
+ },
2639
+ "required": [
2640
+ "host"
2641
+ ],
2642
+ "additionalProperties": false,
2643
+ "description": "Additional host path to bind-mount into the sandbox",
2644
+ "patternProperties": {
2645
+ "^x-": {}
2646
+ }
2647
+ },
2648
+ "SandboxDefaults": {
2649
+ "type": "object",
2650
+ "properties": {
2651
+ "env_passthrough": {
2652
+ "type": "array",
2653
+ "items": {
2654
+ "type": "string"
2655
+ },
2656
+ "description": "Base env var patterns for all sandboxes (replaces hardcoded defaults when set)"
2657
+ }
2658
+ },
2659
+ "additionalProperties": false,
2660
+ "patternProperties": {
2661
+ "^x-": {}
2662
+ }
2663
+ },
2664
+ "SlackConfig": {
2665
+ "type": "object",
2666
+ "properties": {
2667
+ "version": {
2668
+ "type": "string",
2669
+ "description": "Slack API version"
2670
+ },
2671
+ "mentions": {
2672
+ "type": "string",
2673
+ "description": "Mention handling: 'all', 'direct', etc."
2674
+ },
2675
+ "threads": {
2676
+ "type": "string",
2677
+ "description": "Thread handling: 'required', 'optional', etc."
2678
+ },
2679
+ "allow_bot_messages": {
2680
+ "type": "boolean",
2681
+ "description": "Allow bot_message events to trigger runs (default: false)"
2682
+ },
2683
+ "show_raw_output": {
2684
+ "type": "boolean",
2685
+ "description": "Show raw output in Slack responses"
2686
+ },
2687
+ "telemetry": {
2688
+ "$ref": "#/definitions/SlackTelemetryConfig",
2689
+ "description": "Append telemetry identifiers to Slack replies."
2690
+ }
2691
+ },
2692
+ "additionalProperties": false,
2693
+ "description": "Slack configuration",
2694
+ "patternProperties": {
2695
+ "^x-": {}
2696
+ }
2697
+ },
2698
+ "SlackTelemetryConfig": {
2699
+ "type": "object",
2700
+ "properties": {
2701
+ "enabled": {
2702
+ "type": "boolean",
2703
+ "description": "Enable telemetry ID suffix in Slack messages"
2704
+ }
2705
+ },
2706
+ "additionalProperties": false,
2707
+ "patternProperties": {
2708
+ "^x-": {}
2709
+ }
2710
+ },
2711
+ "TelegramConfig": {
2712
+ "type": "object",
2713
+ "properties": {
2714
+ "bot_token": {
2715
+ "type": "string",
2716
+ "description": "Bot token from"
2717
+ },
2718
+ "polling_timeout": {
2719
+ "type": "number",
2720
+ "description": "Polling timeout in seconds for getUpdates (default: 30)"
2721
+ },
2722
+ "chat_allowlist": {
2723
+ "type": "array",
2724
+ "items": {
2725
+ "type": [
2726
+ "string",
2727
+ "number"
2728
+ ]
2729
+ },
2730
+ "description": "Chat/group allowlist - numeric chat IDs that the bot responds in"
2731
+ },
2732
+ "require_mention": {
2733
+ "type": "boolean",
2734
+ "description": "In groups, only respond when"
2735
+ },
2736
+ "workflow": {
2737
+ "type": "string",
2738
+ "description": "Workflow to run when a message is received"
2739
+ }
2740
+ },
2741
+ "additionalProperties": false,
2742
+ "patternProperties": {
2743
+ "^x-": {}
2744
+ }
2745
+ },
2746
+ "EmailConfig": {
2747
+ "type": "object",
2748
+ "properties": {
2749
+ "receive": {
2750
+ "type": "object",
2751
+ "properties": {
2752
+ "type": {
2753
+ "type": "string",
2754
+ "enum": [
2755
+ "imap",
2756
+ "resend"
2757
+ ],
2758
+ "description": "Backend type: 'imap' (universal) or 'resend' (managed webhook)"
2759
+ },
2760
+ "host": {
2761
+ "type": "string",
2762
+ "description": "IMAP server hostname"
2763
+ },
2764
+ "port": {
2765
+ "type": "number",
2766
+ "description": "IMAP server port (default: 993)"
2767
+ },
2768
+ "auth": {
2769
+ "type": "object",
2770
+ "properties": {
2771
+ "user": {
2772
+ "type": "string"
2773
+ },
2774
+ "pass": {
2775
+ "type": "string"
2776
+ }
2777
+ },
2778
+ "additionalProperties": false,
2779
+ "description": "IMAP auth credentials",
2780
+ "patternProperties": {
2781
+ "^x-": {}
2782
+ }
2783
+ },
2784
+ "secure": {
2785
+ "type": "boolean",
2786
+ "description": "Use TLS (default: true)"
2787
+ },
2788
+ "poll_interval": {
2789
+ "type": "number",
2790
+ "description": "Polling interval in seconds when IDLE not available (default: 30)"
2791
+ },
2792
+ "folder": {
2793
+ "type": "string",
2794
+ "description": "IMAP folder to monitor (default: 'INBOX')"
2795
+ },
2796
+ "mark_read": {
2797
+ "type": "boolean",
2798
+ "description": "Mark processed messages as read (default: true)"
2799
+ },
2800
+ "api_key": {
2801
+ "type": "string",
2802
+ "description": "Resend API key (for type: 'resend')"
2803
+ },
2804
+ "webhook_secret": {
2805
+ "type": "string",
2806
+ "description": "Resend webhook secret for signature verification"
2807
+ }
2808
+ },
2809
+ "additionalProperties": false,
2810
+ "description": "Receive backend configuration",
2811
+ "patternProperties": {
2812
+ "^x-": {}
2813
+ }
2814
+ },
2815
+ "send": {
2816
+ "type": "object",
2817
+ "properties": {
2818
+ "type": {
2819
+ "type": "string",
2820
+ "enum": [
2821
+ "smtp",
2822
+ "resend"
2823
+ ],
2824
+ "description": "Backend type: 'smtp' (universal) or 'resend' (managed API)"
2825
+ },
2826
+ "host": {
2827
+ "type": "string",
2828
+ "description": "SMTP server hostname"
2829
+ },
2830
+ "port": {
2831
+ "type": "number",
2832
+ "description": "SMTP server port (default: 587)"
2833
+ },
2834
+ "auth": {
2835
+ "type": "object",
2836
+ "properties": {
2837
+ "user": {
2838
+ "type": "string"
2839
+ },
2840
+ "pass": {
2841
+ "type": "string"
2842
+ }
2843
+ },
2844
+ "additionalProperties": false,
2845
+ "description": "SMTP auth credentials",
2846
+ "patternProperties": {
2847
+ "^x-": {}
2848
+ }
2849
+ },
2850
+ "secure": {
2851
+ "type": "boolean",
2852
+ "description": "Use TLS (default: true)"
2853
+ },
2854
+ "from": {
2855
+ "type": "string",
2856
+ "description": "Default sender address (e.g., \"Bot <bot@example.com>\")"
2857
+ },
2858
+ "api_key": {
2859
+ "type": "string",
2860
+ "description": "Resend API key (for type: 'resend')"
2861
+ }
2862
+ },
2863
+ "additionalProperties": false,
2864
+ "description": "Send backend configuration",
2865
+ "patternProperties": {
2866
+ "^x-": {}
2867
+ }
2868
+ },
2869
+ "allowlist": {
2870
+ "type": "array",
2871
+ "items": {
2872
+ "type": "string"
2873
+ },
2874
+ "description": "Only process emails from these senders"
2875
+ },
2876
+ "workflow": {
2877
+ "type": "string",
2878
+ "description": "Workflow to run when an email is received"
2879
+ }
2880
+ },
2881
+ "additionalProperties": false,
2882
+ "patternProperties": {
2883
+ "^x-": {}
2884
+ }
2885
+ },
2886
+ "WhatsAppConfig": {
2887
+ "type": "object",
2888
+ "properties": {
2889
+ "access_token": {
2890
+ "type": "string",
2891
+ "description": "WhatsApp Cloud API access token (or WHATSAPP_ACCESS_TOKEN env var)"
2892
+ },
2893
+ "phone_number_id": {
2894
+ "type": "string",
2895
+ "description": "Phone Number ID from Meta Business Suite (or WHATSAPP_PHONE_NUMBER_ID env var)"
2896
+ },
2897
+ "app_secret": {
2898
+ "type": "string",
2899
+ "description": "Meta App Secret for webhook signature verification (or WHATSAPP_APP_SECRET env var)"
2900
+ },
2901
+ "verify_token": {
2902
+ "type": "string",
2903
+ "description": "Verify token for webhook subscription challenge (or WHATSAPP_VERIFY_TOKEN env var)"
2904
+ },
2905
+ "api_version": {
2906
+ "type": "string",
2907
+ "description": "Graph API version (default: 'v21.0')"
2908
+ },
2909
+ "port": {
2910
+ "type": "number",
2911
+ "description": "Port for webhook HTTP server (default: 8443)"
2912
+ },
2913
+ "host": {
2914
+ "type": "string",
2915
+ "description": "Host for webhook HTTP server (default: '0.0.0.0')"
2916
+ },
2917
+ "phone_allowlist": {
2918
+ "type": "array",
2919
+ "items": {
2920
+ "type": "string"
2921
+ },
2922
+ "description": "Phone number allowlist — only respond to these numbers"
2923
+ },
2924
+ "workflow": {
2925
+ "type": "string",
2926
+ "description": "Workflow to run when a message is received"
2927
+ }
2928
+ },
2929
+ "additionalProperties": false,
2930
+ "patternProperties": {
2931
+ "^x-": {}
2932
+ }
2933
+ },
2934
+ "TeamsConfig": {
2935
+ "type": "object",
2936
+ "properties": {
2937
+ "app_id": {
2938
+ "type": "string",
2939
+ "description": "Azure AD App (client) ID (or TEAMS_APP_ID env var)"
2940
+ },
2941
+ "app_password": {
2942
+ "type": "string",
2943
+ "description": "Azure AD App client secret (or TEAMS_APP_PASSWORD env var)"
2944
+ },
2945
+ "tenant_id": {
2946
+ "type": "string",
2947
+ "description": "Azure AD Tenant ID for single-tenant apps (or TEAMS_TENANT_ID env var)"
2948
+ },
2949
+ "port": {
2950
+ "type": "number",
2951
+ "description": "Port for webhook HTTP server (default: 3978)"
2952
+ },
2953
+ "host": {
2954
+ "type": "string",
2955
+ "description": "Host for webhook HTTP server (default: '0.0.0.0')"
2956
+ },
2957
+ "user_allowlist": {
2958
+ "type": "array",
2959
+ "items": {
2960
+ "type": "string"
2961
+ },
2962
+ "description": "User ID allowlist — only respond to these AAD user IDs"
2963
+ },
2964
+ "workflow": {
2965
+ "type": "string",
2966
+ "description": "Workflow to run when a message is received"
2967
+ }
2968
+ },
2969
+ "additionalProperties": false,
2970
+ "patternProperties": {
2971
+ "^x-": {}
2972
+ }
2973
+ },
2974
+ "SchedulerConfig": {
2975
+ "type": "object",
2976
+ "properties": {
2977
+ "enabled": {
2978
+ "type": "boolean",
2979
+ "description": "Enable/disable the scheduler (default: true)"
2980
+ },
2981
+ "storage": {
2982
+ "type": "object",
2983
+ "properties": {
2984
+ "path": {
2985
+ "type": "string",
2986
+ "description": "Path to schedules JSON file (legacy, triggers auto-migration)"
2987
+ },
2988
+ "driver": {
2989
+ "type": "string",
2990
+ "enum": [
2991
+ "sqlite",
2992
+ "postgresql",
2993
+ "mysql",
2994
+ "mssql"
2995
+ ],
2996
+ "description": "Database driver (default: 'sqlite')"
2997
+ },
2998
+ "connection": {
2999
+ "$ref": "#/definitions/SchedulerStorageConnectionConfig",
3000
+ "description": "Database connection configuration"
3001
+ }
3002
+ },
3003
+ "additionalProperties": false,
3004
+ "description": "Storage configuration",
3005
+ "patternProperties": {
3006
+ "^x-": {}
3007
+ }
3008
+ },
3009
+ "ha": {
3010
+ "$ref": "#/definitions/SchedulerHAConfig",
3011
+ "description": "High-availability configuration for multi-node deployments"
3012
+ },
3013
+ "limits": {
3014
+ "$ref": "#/definitions/SchedulerLimitsConfig",
3015
+ "description": "Limits for dynamic schedules"
3016
+ },
3017
+ "default_timezone": {
3018
+ "type": "string",
3019
+ "description": "Default timezone (IANA format, e.g., \"America/New_York\")"
3020
+ },
3021
+ "check_interval_ms": {
3022
+ "type": "number",
3023
+ "description": "Check interval in milliseconds (default: 60000)"
3024
+ },
3025
+ "permissions": {
3026
+ "$ref": "#/definitions/SchedulerPermissionsConfig",
3027
+ "description": "Permissions for dynamic schedule creation (via AI tool)"
3028
+ },
3029
+ "cron": {
3030
+ "$ref": "#/definitions/Record%3Cstring%2CStaticCronJob%3E",
3031
+ "description": "Static cron jobs defined in configuration (always executed)"
3032
+ },
3033
+ "on_message": {
3034
+ "$ref": "#/definitions/Record%3Cstring%2CSlackMessageTrigger%3E",
3035
+ "description": "Slack message triggers for reactive workflow execution"
3036
+ }
3037
+ },
3038
+ "additionalProperties": false,
3039
+ "description": "Scheduler configuration for workflow scheduling",
3040
+ "patternProperties": {
3041
+ "^x-": {}
3042
+ }
3043
+ },
3044
+ "SchedulerStorageConnectionConfig": {
3045
+ "type": "object",
3046
+ "properties": {
3047
+ "filename": {
3048
+ "type": "string",
3049
+ "description": "SQLite database file path (default: '.visor/schedules.db')"
3050
+ },
3051
+ "host": {
3052
+ "type": "string",
3053
+ "description": "Database host (PostgreSQL/MySQL/MSSQL)"
3054
+ },
3055
+ "port": {
3056
+ "type": "number",
3057
+ "description": "Database port (PostgreSQL/MySQL/MSSQL)"
3058
+ },
3059
+ "database": {
3060
+ "type": "string",
3061
+ "description": "Database name (PostgreSQL/MySQL/MSSQL)"
3062
+ },
3063
+ "user": {
3064
+ "type": "string",
3065
+ "description": "Database user (PostgreSQL/MySQL/MSSQL)"
3066
+ },
3067
+ "password": {
3068
+ "type": "string",
3069
+ "description": "Database password (PostgreSQL/MySQL/MSSQL)"
3070
+ },
3071
+ "ssl": {
3072
+ "anyOf": [
3073
+ {
3074
+ "type": "boolean"
3075
+ },
3076
+ {
3077
+ "$ref": "#/definitions/SchedulerSslConfig"
3078
+ }
3079
+ ],
3080
+ "description": "SSL/TLS configuration (PostgreSQL/MySQL/MSSQL)"
3081
+ },
3082
+ "connection_string": {
3083
+ "type": "string",
3084
+ "description": "Connection string URL (e.g., postgresql://user:pass@host/db)"
3085
+ },
3086
+ "pool": {
3087
+ "type": "object",
3088
+ "properties": {
3089
+ "min": {
3090
+ "type": "number"
3091
+ },
3092
+ "max": {
3093
+ "type": "number"
3094
+ }
3095
+ },
3096
+ "additionalProperties": false,
3097
+ "description": "Connection pool configuration",
3098
+ "patternProperties": {
3099
+ "^x-": {}
3100
+ }
3101
+ }
3102
+ },
3103
+ "additionalProperties": false,
3104
+ "description": "Scheduler storage connection configuration",
3105
+ "patternProperties": {
3106
+ "^x-": {}
3107
+ }
3108
+ },
3109
+ "SchedulerSslConfig": {
3110
+ "type": "object",
3111
+ "properties": {
3112
+ "enabled": {
3113
+ "type": "boolean",
3114
+ "description": "Enable SSL (default: true when SslConfig object is provided)"
3115
+ },
3116
+ "reject_unauthorized": {
3117
+ "type": "boolean",
3118
+ "description": "Reject unauthorized certificates (default: true)"
3119
+ },
3120
+ "ca": {
3121
+ "type": "string",
3122
+ "description": "Path to CA certificate PEM file"
3123
+ },
3124
+ "cert": {
3125
+ "type": "string",
3126
+ "description": "Path to client certificate PEM file"
3127
+ },
3128
+ "key": {
3129
+ "type": "string",
3130
+ "description": "Path to client key PEM file"
3131
+ }
3132
+ },
3133
+ "additionalProperties": false,
3134
+ "description": "SSL/TLS configuration for scheduler database connections",
3135
+ "patternProperties": {
3136
+ "^x-": {}
3137
+ }
3138
+ },
3139
+ "SchedulerHAConfig": {
3140
+ "type": "object",
3141
+ "properties": {
3142
+ "enabled": {
3143
+ "type": "boolean",
3144
+ "description": "Enable distributed locking for multi-node deployments (default: false)"
3145
+ },
3146
+ "node_id": {
3147
+ "type": "string",
3148
+ "description": "Unique node identifier (default: hostname-pid)"
3149
+ },
3150
+ "lock_ttl": {
3151
+ "type": "number",
3152
+ "description": "Lock time-to-live in seconds (default: 60)"
3153
+ },
3154
+ "heartbeat_interval": {
3155
+ "type": "number",
3156
+ "description": "Heartbeat interval for lock renewal in seconds (default: 15)"
3157
+ }
3158
+ },
3159
+ "additionalProperties": false,
3160
+ "description": "Scheduler high-availability configuration",
3161
+ "patternProperties": {
3162
+ "^x-": {}
3163
+ }
3164
+ },
3165
+ "SchedulerLimitsConfig": {
3166
+ "type": "object",
3167
+ "properties": {
3168
+ "max_per_user": {
3169
+ "type": "number",
3170
+ "description": "Maximum schedules per user (default: 25)"
3171
+ },
3172
+ "max_recurring_per_user": {
3173
+ "type": "number",
3174
+ "description": "Maximum recurring schedules per user (default: 10)"
3175
+ },
3176
+ "max_global": {
3177
+ "type": "number",
3178
+ "description": "Maximum total schedules (default: 1000)"
3179
+ }
3180
+ },
3181
+ "additionalProperties": false,
3182
+ "description": "Scheduler limits configuration",
3183
+ "patternProperties": {
3184
+ "^x-": {}
3185
+ }
3186
+ },
3187
+ "SchedulerPermissionsConfig": {
3188
+ "type": "object",
3189
+ "properties": {
3190
+ "allow_personal": {
3191
+ "type": "boolean",
3192
+ "description": "Allow personal schedules (via DM or CLI)"
3193
+ },
3194
+ "allow_channel": {
3195
+ "type": "boolean",
3196
+ "description": "Allow channel schedules (in Slack channels)"
3197
+ },
3198
+ "allow_dm": {
3199
+ "type": "boolean",
3200
+ "description": "Allow DM schedules (to specific users)"
3201
+ },
3202
+ "allowed_workflows": {
3203
+ "type": "array",
3204
+ "items": {
3205
+ "type": "string"
3206
+ },
3207
+ "description": "List of allowed workflow patterns (glob-style, e.g., \"report-*\")"
3208
+ },
3209
+ "denied_workflows": {
3210
+ "type": "array",
3211
+ "items": {
3212
+ "type": "string"
3213
+ },
3214
+ "description": "List of denied workflow patterns"
3215
+ }
3216
+ },
3217
+ "additionalProperties": false,
3218
+ "description": "Scheduler permissions for dynamic schedule creation",
3219
+ "patternProperties": {
3220
+ "^x-": {}
3221
+ }
3222
+ },
3223
+ "Record<string,StaticCronJob>": {
3224
+ "type": "object",
3225
+ "additionalProperties": {
3226
+ "$ref": "#/definitions/StaticCronJob"
3227
+ }
3228
+ },
3229
+ "StaticCronJob": {
3230
+ "type": "object",
3231
+ "properties": {
3232
+ "schedule": {
3233
+ "type": "string",
3234
+ "description": "Cron expression (e.g., \"0 9 * * 1\" for every Monday at 9am)"
3235
+ },
3236
+ "workflow": {
3237
+ "type": "string",
3238
+ "description": "Workflow/check ID to run"
3239
+ },
3240
+ "inputs": {
3241
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
3242
+ "description": "Optional workflow inputs"
3243
+ },
3244
+ "output": {
3245
+ "type": "object",
3246
+ "properties": {
3247
+ "type": {
3248
+ "type": "string",
3249
+ "enum": [
3250
+ "slack",
3251
+ "github",
3252
+ "webhook",
3253
+ "none"
3254
+ ],
3255
+ "description": "Output type: slack, github, webhook, or none"
3256
+ },
3257
+ "target": {
3258
+ "type": "string",
3259
+ "description": "Target (channel name, repo, URL)"
3260
+ },
3261
+ "thread_id": {
3262
+ "type": "string",
3263
+ "description": "Thread ID for threaded outputs"
3264
+ }
3265
+ },
3266
+ "required": [
3267
+ "type"
3268
+ ],
3269
+ "additionalProperties": false,
3270
+ "description": "Output destination configuration",
3271
+ "patternProperties": {
3272
+ "^x-": {}
3273
+ }
3274
+ },
3275
+ "description": {
3276
+ "type": "string",
3277
+ "description": "Description for logging/display"
3278
+ },
3279
+ "enabled": {
3280
+ "type": "boolean",
3281
+ "description": "Enable/disable this job (default: true)"
3282
+ },
3283
+ "timezone": {
3284
+ "type": "string",
3285
+ "description": "Timezone for schedule (default: UTC or scheduler default)"
3286
+ }
3287
+ },
3288
+ "required": [
3289
+ "schedule",
3290
+ "workflow"
3291
+ ],
3292
+ "additionalProperties": false,
3293
+ "description": "Static cron job defined in YAML configuration These are always executed by the scheduler daemon",
3294
+ "patternProperties": {
3295
+ "^x-": {}
3296
+ }
3297
+ },
3298
+ "Record<string,SlackMessageTrigger>": {
3299
+ "type": "object",
3300
+ "additionalProperties": {
3301
+ "$ref": "#/definitions/SlackMessageTrigger"
3302
+ }
3303
+ },
3304
+ "SlackMessageTrigger": {
3305
+ "type": "object",
3306
+ "properties": {
3307
+ "channels": {
3308
+ "type": "array",
3309
+ "items": {
3310
+ "type": "string"
3311
+ },
3312
+ "description": "Channel IDs to monitor (supports wildcard suffix, e.g., \"CENG*\")"
3313
+ },
3314
+ "from": {
3315
+ "type": "array",
3316
+ "items": {
3317
+ "type": "string"
3318
+ },
3319
+ "description": "Only trigger on messages from these user IDs"
3320
+ },
3321
+ "from_bots": {
3322
+ "type": "boolean",
3323
+ "description": "Allow bot messages to trigger (default: false)"
3324
+ },
3325
+ "contains": {
3326
+ "type": "array",
3327
+ "items": {
3328
+ "type": "string"
3329
+ },
3330
+ "description": "Keyword match - any keyword triggers (case-insensitive OR)"
3331
+ },
3332
+ "match": {
3333
+ "type": "string",
3334
+ "description": "Regex pattern to match against message text"
3335
+ },
3336
+ "threads": {
3337
+ "type": "string",
3338
+ "enum": [
3339
+ "root_only",
3340
+ "thread_only",
3341
+ "any"
3342
+ ],
3343
+ "description": "Thread scope filter (default: 'any')"
3344
+ },
3345
+ "workflow": {
3346
+ "type": "string",
3347
+ "description": "Workflow/check ID to execute"
3348
+ },
3349
+ "inputs": {
3350
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
3351
+ "description": "Optional workflow inputs"
3352
+ },
3353
+ "output": {
3354
+ "type": "object",
3355
+ "properties": {
3356
+ "type": {
3357
+ "type": "string",
3358
+ "enum": [
3359
+ "slack",
3360
+ "github",
3361
+ "webhook",
3362
+ "none"
3363
+ ],
3364
+ "description": "Output type: slack, github, webhook, or none"
3365
+ },
3366
+ "target": {
3367
+ "type": "string",
3368
+ "description": "Target (channel name, repo, URL)"
3369
+ },
3370
+ "thread_id": {
3371
+ "type": "string",
3372
+ "description": "Thread ID for threaded outputs"
3373
+ }
3374
+ },
3375
+ "required": [
3376
+ "type"
3377
+ ],
3378
+ "additionalProperties": false,
3379
+ "description": "Output destination configuration",
3380
+ "patternProperties": {
3381
+ "^x-": {}
3382
+ }
3383
+ },
3384
+ "description": {
3385
+ "type": "string",
3386
+ "description": "Description for logging/display"
3387
+ },
3388
+ "enabled": {
3389
+ "type": "boolean",
3390
+ "description": "Enable/disable this trigger (default: true)"
3391
+ }
3392
+ },
3393
+ "required": [
3394
+ "workflow"
3395
+ ],
3396
+ "additionalProperties": false,
3397
+ "description": "Slack message trigger for reactive workflow execution Triggers workflows based on Slack messages matching configured filters",
3398
+ "patternProperties": {
3399
+ "^x-": {}
3400
+ }
3401
+ },
3402
+ "PolicyConfig": {
3403
+ "type": "object",
3404
+ "properties": {
3405
+ "engine": {
3406
+ "type": "string",
3407
+ "enum": [
3408
+ "local",
3409
+ "remote",
3410
+ "disabled"
3411
+ ],
3412
+ "description": "Policy engine mode"
3413
+ },
3414
+ "rules": {
3415
+ "anyOf": [
3416
+ {
3417
+ "type": "string"
3418
+ },
3419
+ {
3420
+ "type": "array",
3421
+ "items": {
3422
+ "type": "string"
3423
+ }
3424
+ }
3425
+ ],
3426
+ "description": "Path to .rego files or .wasm bundle (local mode)"
3427
+ },
3428
+ "data": {
3429
+ "type": "string",
3430
+ "description": "Path to a JSON file to load as OPA data document"
3431
+ },
3432
+ "url": {
3433
+ "type": "string",
3434
+ "description": "OPA server URL (remote mode)"
3435
+ },
3436
+ "fallback": {
3437
+ "type": "string",
3438
+ "enum": [
3439
+ "allow",
3440
+ "deny",
3441
+ "warn"
3442
+ ],
3443
+ "description": "Default decision when policy evaluation fails"
3444
+ },
3445
+ "timeout": {
3446
+ "type": "number",
3447
+ "description": "Evaluation timeout in ms (default: 5000)"
3448
+ },
3449
+ "roles": {
3450
+ "$ref": "#/definitions/Record%3Cstring%2CPolicyRoleConfig%3E",
3451
+ "description": "Role definitions: map role names to conditions"
3452
+ }
3453
+ },
3454
+ "required": [
3455
+ "engine"
3456
+ ],
3457
+ "additionalProperties": false,
3458
+ "patternProperties": {
3459
+ "^x-": {}
3460
+ }
3461
+ },
3462
+ "Record<string,PolicyRoleConfig>": {
3463
+ "type": "object",
3464
+ "additionalProperties": {
3465
+ "$ref": "#/definitions/PolicyRoleConfig"
3466
+ }
3467
+ },
3468
+ "PolicyRoleConfig": {
3469
+ "type": "object",
3470
+ "properties": {
3471
+ "author_association": {
3472
+ "type": "array",
3473
+ "items": {
3474
+ "type": "string"
3475
+ },
3476
+ "description": "GitHub author associations that map to this role"
3477
+ },
3478
+ "teams": {
3479
+ "type": "array",
3480
+ "items": {
3481
+ "type": "string"
3482
+ },
3483
+ "description": "GitHub team slugs (requires GitHub API)"
3484
+ },
3485
+ "users": {
3486
+ "type": "array",
3487
+ "items": {
3488
+ "type": "string"
3489
+ },
3490
+ "description": "Explicit GitHub usernames"
3491
+ },
3492
+ "slack_users": {
3493
+ "type": "array",
3494
+ "items": {
3495
+ "type": "string"
3496
+ },
3497
+ "description": "Slack user IDs (e.g., [\"U0123ABC\"])"
3498
+ },
3499
+ "emails": {
3500
+ "type": "array",
3501
+ "items": {
3502
+ "type": "string"
3503
+ },
3504
+ "description": "Email addresses for identity matching (e.g., [\"alice@co.com\"])"
3505
+ },
3506
+ "slack_channels": {
3507
+ "type": "array",
3508
+ "items": {
3509
+ "type": "string"
3510
+ },
3511
+ "description": "Slack channel IDs — role only applies when triggered from these channels"
3512
+ }
3513
+ },
3514
+ "additionalProperties": false,
3515
+ "patternProperties": {
3516
+ "^x-": {}
3517
+ }
3518
+ },
3519
+ "AgentProtocolConfig": {
3520
+ "type": "object",
3521
+ "properties": {
3522
+ "enabled": {
3523
+ "type": "boolean"
3524
+ },
3525
+ "protocol": {
3526
+ "type": "string"
3527
+ },
3528
+ "agent_card": {
3529
+ "type": "string"
3530
+ },
3531
+ "agent_card_inline": {
3532
+ "$ref": "#/definitions/AgentCard"
3533
+ },
3534
+ "public_url": {
3535
+ "type": "string"
3536
+ },
3537
+ "port": {
3538
+ "type": "number"
3539
+ },
3540
+ "host": {
3541
+ "type": "string"
3542
+ },
3543
+ "tls": {
3544
+ "$ref": "#/definitions/AgentProtocolTlsConfig"
3545
+ },
3546
+ "auth": {
3547
+ "$ref": "#/definitions/AgentProtocolAuthConfig"
3548
+ },
3549
+ "default_workflow": {
3550
+ "type": "string"
3551
+ },
3552
+ "skill_routing": {
3553
+ "$ref": "#/definitions/Record%3Cstring%2Cstring%3E"
3554
+ },
3555
+ "task_ttl": {
3556
+ "type": "string"
3557
+ },
3558
+ "queue": {
3559
+ "$ref": "#/definitions/AgentProtocolQueueConfig"
3560
+ }
3561
+ },
3562
+ "required": [
3563
+ "enabled",
3564
+ "protocol"
3565
+ ],
3566
+ "additionalProperties": false,
3567
+ "patternProperties": {
3568
+ "^x-": {}
3569
+ }
3570
+ },
3571
+ "AgentCard": {
3572
+ "type": "object",
3573
+ "properties": {
3574
+ "name": {
3575
+ "type": "string"
3576
+ },
3577
+ "description": {
3578
+ "type": "string"
3579
+ },
3580
+ "version": {
3581
+ "type": "string"
3582
+ },
3583
+ "provider": {
3584
+ "type": "object",
3585
+ "properties": {
3586
+ "organization": {
3587
+ "type": "string"
3588
+ },
3589
+ "url": {
3590
+ "type": "string"
3591
+ }
3592
+ },
3593
+ "required": [
3594
+ "organization"
3595
+ ],
3596
+ "additionalProperties": false,
3597
+ "patternProperties": {
3598
+ "^x-": {}
3599
+ }
3600
+ },
3601
+ "supported_interfaces": {
3602
+ "type": "array",
3603
+ "items": {
3604
+ "type": "object",
3605
+ "properties": {
3606
+ "url": {
3607
+ "type": "string"
3608
+ },
3609
+ "protocol_binding": {
3610
+ "type": "string"
3611
+ },
3612
+ "protocol_version": {
3613
+ "type": "string"
3614
+ }
3615
+ },
3616
+ "required": [
3617
+ "url"
3618
+ ],
3619
+ "additionalProperties": false
3620
+ }
3621
+ },
3622
+ "capabilities": {
3623
+ "$ref": "#/definitions/AgentCapabilities"
3624
+ },
3625
+ "default_input_modes": {
3626
+ "type": "array",
3627
+ "items": {
3628
+ "type": "string"
3629
+ }
3630
+ },
3631
+ "default_output_modes": {
3632
+ "type": "array",
3633
+ "items": {
3634
+ "type": "string"
3635
+ }
3636
+ },
3637
+ "security_schemes": {
3638
+ "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
3639
+ },
3640
+ "security_requirements": {
3641
+ "type": "array",
3642
+ "items": {}
3643
+ },
3644
+ "skills": {
3645
+ "type": "array",
3646
+ "items": {
3647
+ "$ref": "#/definitions/AgentSkill"
3648
+ }
3649
+ },
3650
+ "icon_url": {
3651
+ "type": "string"
3652
+ }
3653
+ },
3654
+ "required": [
3655
+ "name"
3656
+ ],
3657
+ "additionalProperties": false,
3658
+ "patternProperties": {
3659
+ "^x-": {}
3660
+ }
3661
+ },
3662
+ "AgentCapabilities": {
3663
+ "type": "object",
3664
+ "properties": {
3665
+ "streaming": {
3666
+ "type": "boolean"
3667
+ },
3668
+ "push_notifications": {
3669
+ "type": "boolean"
3670
+ },
3671
+ "extensions": {
3672
+ "type": "array",
3673
+ "items": {
3674
+ "type": "string"
3675
+ }
3676
+ },
3677
+ "extended_agent_card": {
3678
+ "type": "boolean"
3679
+ }
3680
+ },
3681
+ "additionalProperties": false,
3682
+ "patternProperties": {
3683
+ "^x-": {}
3684
+ }
3685
+ },
3686
+ "AgentSkill": {
3687
+ "type": "object",
3688
+ "properties": {
3689
+ "id": {
3690
+ "type": "string"
3691
+ },
3692
+ "name": {
3693
+ "type": "string"
3694
+ },
3695
+ "description": {
3696
+ "type": "string"
3697
+ },
3698
+ "tags": {
3699
+ "type": "array",
3700
+ "items": {
3701
+ "type": "string"
3702
+ }
3703
+ },
3704
+ "examples": {
3705
+ "type": "array",
3706
+ "items": {
3707
+ "type": "string"
3708
+ }
3709
+ },
3710
+ "input_modes": {
3711
+ "type": "array",
3712
+ "items": {
3713
+ "type": "string"
3714
+ }
3715
+ },
3716
+ "output_modes": {
3717
+ "type": "array",
3718
+ "items": {
3719
+ "type": "string"
3720
+ }
3721
+ }
3722
+ },
3723
+ "required": [
3724
+ "id",
3725
+ "name",
3726
+ "description"
3727
+ ],
3728
+ "additionalProperties": false,
3729
+ "patternProperties": {
3730
+ "^x-": {}
3731
+ }
3732
+ },
3733
+ "AgentProtocolTlsConfig": {
3734
+ "type": "object",
3735
+ "properties": {
3736
+ "cert": {
3737
+ "type": "string"
3738
+ },
3739
+ "key": {
3740
+ "type": "string"
3741
+ }
3742
+ },
3743
+ "required": [
3744
+ "cert",
3745
+ "key"
3746
+ ],
3747
+ "additionalProperties": false,
3748
+ "patternProperties": {
3749
+ "^x-": {}
3750
+ }
3751
+ },
3752
+ "AgentProtocolAuthConfig": {
3753
+ "type": "object",
3754
+ "properties": {
3755
+ "type": {
3756
+ "type": "string",
3757
+ "enum": [
3758
+ "bearer",
3759
+ "api_key",
3760
+ "none"
3761
+ ]
3762
+ },
3763
+ "token_env": {
3764
+ "type": "string"
3765
+ },
3766
+ "header_name": {
3767
+ "type": "string"
3768
+ },
3769
+ "param_name": {
3770
+ "type": "string"
3771
+ },
3772
+ "key_env": {
3773
+ "type": "string"
3774
+ }
3775
+ },
3776
+ "required": [
3777
+ "type"
3778
+ ],
3779
+ "additionalProperties": false,
3780
+ "patternProperties": {
3781
+ "^x-": {}
3782
+ }
3783
+ },
3784
+ "AgentProtocolQueueConfig": {
3785
+ "type": "object",
3786
+ "properties": {
3787
+ "poll_interval": {
3788
+ "type": "number"
3789
+ },
3790
+ "max_concurrent": {
3791
+ "type": "number"
3792
+ },
3793
+ "stale_claim_timeout": {
3794
+ "type": "number"
3795
+ }
3796
+ },
3797
+ "additionalProperties": false,
3798
+ "patternProperties": {
3799
+ "^x-": {}
3800
+ }
3801
+ }
3802
+ }
3803
+ }