@probelabs/visor 0.1.127 → 0.1.129

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 (255) hide show
  1. package/README.md +31 -1
  2. package/defaults/.visor.yaml +420 -0
  3. package/dist/ai-review-service.d.ts +1 -0
  4. package/dist/ai-review-service.d.ts.map +1 -1
  5. package/dist/cli-main.d.ts.map +1 -1
  6. package/dist/config.d.ts +4 -0
  7. package/dist/config.d.ts.map +1 -1
  8. package/dist/daemon.js +19 -0
  9. package/dist/defaults/.visor.yaml +420 -0
  10. package/dist/docs/commands.md +1 -1
  11. package/dist/docs/debugging.md +133 -0
  12. package/dist/docs/dev-playbook.md +10 -0
  13. package/dist/docs/index.md +1 -0
  14. package/dist/docs/scheduler.md +503 -0
  15. package/dist/docs/slack-integration.md +21 -0
  16. package/dist/docs/timeouts.md +1 -1
  17. package/dist/docs/workflow-creation-guide.md +39 -0
  18. package/dist/examples/README.md +30 -0
  19. package/dist/examples/calculator-config.yaml +4 -4
  20. package/dist/examples/sandbox-basic.yaml +18 -0
  21. package/dist/examples/sandbox-cache.yaml +32 -0
  22. package/dist/examples/sandbox-dockerfile-inline.yaml +22 -0
  23. package/dist/examples/sandbox-env-passthrough.yaml +26 -0
  24. package/dist/examples/sandbox-multi-env.yaml +27 -0
  25. package/dist/examples/sandbox-read-only.yaml +33 -0
  26. package/dist/examples/scheduler-example.yaml +118 -0
  27. package/dist/frontends/host.d.ts.map +1 -1
  28. package/dist/frontends/slack-frontend.d.ts.map +1 -1
  29. package/dist/generated/config-schema.d.ts +230 -9
  30. package/dist/generated/config-schema.d.ts.map +1 -1
  31. package/dist/index.js +13676 -1604
  32. package/dist/mcp-server.d.ts +8 -8
  33. package/dist/{traces/run-2026-02-01T09-59-08-165Z.ndjson → output/traces/run-2026-02-08T18-16-04-160Z.ndjson} +84 -84
  34. package/dist/{traces/run-2026-02-01T09-59-52-595Z.ndjson → output/traces/run-2026-02-08T18-16-51-253Z.ndjson} +1029 -1029
  35. package/dist/providers/ai-check-provider.d.ts +16 -0
  36. package/dist/providers/ai-check-provider.d.ts.map +1 -1
  37. package/dist/providers/check-provider.interface.d.ts +5 -0
  38. package/dist/providers/check-provider.interface.d.ts.map +1 -1
  39. package/dist/providers/command-check-provider.d.ts.map +1 -1
  40. package/dist/providers/log-check-provider.d.ts.map +1 -1
  41. package/dist/providers/mcp-check-provider.d.ts +3 -0
  42. package/dist/providers/mcp-check-provider.d.ts.map +1 -1
  43. package/dist/providers/mcp-custom-sse-server.d.ts +22 -2
  44. package/dist/providers/mcp-custom-sse-server.d.ts.map +1 -1
  45. package/dist/providers/workflow-check-provider.d.ts.map +1 -1
  46. package/dist/providers/workflow-tool-executor.d.ts +2 -0
  47. package/dist/providers/workflow-tool-executor.d.ts.map +1 -1
  48. package/dist/sandbox/cache-volume-manager.d.ts +48 -0
  49. package/dist/sandbox/cache-volume-manager.d.ts.map +1 -0
  50. package/dist/sandbox/check-runner.d.ts +25 -0
  51. package/dist/sandbox/check-runner.d.ts.map +1 -0
  52. package/dist/sandbox/docker-compose-sandbox.d.ts +25 -0
  53. package/dist/sandbox/docker-compose-sandbox.d.ts.map +1 -0
  54. package/dist/sandbox/docker-image-sandbox.d.ts +32 -0
  55. package/dist/sandbox/docker-image-sandbox.d.ts.map +1 -0
  56. package/dist/sandbox/env-filter.d.ts +19 -0
  57. package/dist/sandbox/env-filter.d.ts.map +1 -0
  58. package/dist/sandbox/index.d.ts +9 -0
  59. package/dist/sandbox/index.d.ts.map +1 -0
  60. package/dist/sandbox/sandbox-manager.d.ts +39 -0
  61. package/dist/sandbox/sandbox-manager.d.ts.map +1 -0
  62. package/dist/sandbox/sandbox-telemetry.d.ts +9 -0
  63. package/dist/sandbox/sandbox-telemetry.d.ts.map +1 -0
  64. package/dist/sandbox/trace-ingester.d.ts +19 -0
  65. package/dist/sandbox/trace-ingester.d.ts.map +1 -0
  66. package/dist/sandbox/types.d.ts +149 -0
  67. package/dist/sandbox/types.d.ts.map +1 -0
  68. package/dist/scheduler/cli-handler.d.ts +6 -0
  69. package/dist/scheduler/cli-handler.d.ts.map +1 -0
  70. package/dist/scheduler/index.d.ts +14 -0
  71. package/dist/scheduler/index.d.ts.map +1 -0
  72. package/dist/scheduler/schedule-parser.d.ts +34 -0
  73. package/dist/scheduler/schedule-parser.d.ts.map +1 -0
  74. package/dist/scheduler/schedule-store.d.ts +182 -0
  75. package/dist/scheduler/schedule-store.d.ts.map +1 -0
  76. package/dist/scheduler/schedule-tool.d.ts +137 -0
  77. package/dist/scheduler/schedule-tool.d.ts.map +1 -0
  78. package/dist/scheduler/scheduler.d.ts +195 -0
  79. package/dist/scheduler/scheduler.d.ts.map +1 -0
  80. package/dist/sdk/check-provider-registry-ACRGIYOB.mjs +28 -0
  81. package/dist/sdk/check-provider-registry-VYHKFHK2.mjs +28 -0
  82. package/dist/sdk/{chunk-CNX7V5JK.mjs → chunk-25IC7KXZ.mjs} +2 -2
  83. package/dist/sdk/{chunk-IHZOSIF4.mjs → chunk-2KB35MB7.mjs} +3 -3
  84. package/dist/sdk/{chunk-HQL734ZI.mjs → chunk-6W75IMDC.mjs} +3 -3
  85. package/dist/sdk/{chunk-XWJPT5KQ.mjs → chunk-7YSOINAQ.mjs} +392 -18
  86. package/dist/sdk/chunk-7YSOINAQ.mjs.map +1 -0
  87. package/dist/sdk/{chunk-3OMWVM6J.mjs → chunk-B7BVQM5K.mjs} +2 -2
  88. package/dist/sdk/chunk-BDGUM6BA.mjs +38825 -0
  89. package/dist/sdk/chunk-BDGUM6BA.mjs.map +1 -0
  90. package/dist/sdk/{chunk-VW2GBXQT.mjs → chunk-D5KI4YQ4.mjs} +3 -3
  91. package/dist/sdk/chunk-DGZPPGJJ.mjs +38825 -0
  92. package/dist/sdk/chunk-DGZPPGJJ.mjs.map +1 -0
  93. package/dist/sdk/chunk-H5BOW5CR.mjs +91 -0
  94. package/dist/sdk/chunk-H5BOW5CR.mjs.map +1 -0
  95. package/dist/sdk/{chunk-YSN4G6CI.mjs → chunk-HEX3RL32.mjs} +81 -3
  96. package/dist/sdk/{chunk-YSN4G6CI.mjs.map → chunk-HEX3RL32.mjs.map} +1 -1
  97. package/dist/sdk/{chunk-ZYAUYXSW.mjs → chunk-J5RGJQ53.mjs} +14 -3
  98. package/dist/sdk/{chunk-ZYAUYXSW.mjs.map → chunk-J5RGJQ53.mjs.map} +1 -1
  99. package/dist/sdk/{chunk-WMJKH4XE.mjs → chunk-J7LXIPZS.mjs} +16 -1
  100. package/dist/sdk/{chunk-EXFGO4FX.mjs → chunk-KFKHU6CM.mjs} +2 -2
  101. package/dist/sdk/{chunk-MPS4HVQI.mjs → chunk-N7HO6KKC.mjs} +8 -8
  102. package/dist/sdk/{chunk-O5EZDNYL.mjs → chunk-NCWIZVOT.mjs} +2 -2
  103. package/dist/sdk/{chunk-3NMLT3YS.mjs → chunk-PO7X5XI7.mjs} +3 -3
  104. package/dist/sdk/{chunk-BHOKBQPB.mjs → chunk-R5Z7YWPB.mjs} +5 -5
  105. package/dist/sdk/{chunk-EORMDOZU.mjs → chunk-SGS2VMEL.mjs} +7 -7
  106. package/dist/sdk/{chunk-BOVFH3LI.mjs → chunk-VF6XIUE4.mjs} +21 -10
  107. package/dist/sdk/chunk-VF6XIUE4.mjs.map +1 -0
  108. package/dist/sdk/{chunk-J2QWVDXK.mjs → chunk-XDLQ3UNF.mjs} +3 -3
  109. package/dist/sdk/{chunk-S2RUE2RG.mjs → chunk-XR7XXGL7.mjs} +3 -3
  110. package/dist/sdk/{chunk-NAW3DB3I.mjs → chunk-XXAEN5KU.mjs} +3 -3
  111. package/dist/sdk/command-executor-DVVXERLR.mjs +14 -0
  112. package/dist/sdk/config-7VTT64SQ.mjs +16 -0
  113. package/dist/sdk/config-merger-RKCZJQ44.mjs +10 -0
  114. package/dist/sdk/event-bus-5K3Y2FCS.mjs +43 -0
  115. package/dist/sdk/{event-bus-5BEVPQ6T.mjs.map → event-bus-5K3Y2FCS.mjs.map} +1 -1
  116. package/dist/sdk/failure-condition-evaluator-4WMDF4Q3.mjs +17 -0
  117. package/dist/sdk/git-repository-analyzer-QFMW6WIS.mjs +471 -0
  118. package/dist/sdk/git-repository-analyzer-QFMW6WIS.mjs.map +1 -0
  119. package/dist/sdk/{github-frontend-5PCKKHVC.mjs → github-frontend-3N2NLO66.mjs} +520 -588
  120. package/dist/sdk/github-frontend-3N2NLO66.mjs.map +1 -0
  121. package/dist/sdk/host-ONVMEHAA.mjs +63 -0
  122. package/dist/sdk/host-ONVMEHAA.mjs.map +1 -0
  123. package/dist/sdk/{liquid-extensions-I7O7KMHF.mjs → liquid-extensions-5IZLTFSZ.mjs} +8 -8
  124. package/dist/sdk/memory-store-3N4AZCYB.mjs +12 -0
  125. package/dist/sdk/{metrics-7PP3EJUH.mjs → metrics-GXQ2EDXA.mjs} +4 -4
  126. package/dist/sdk/ndjson-sink-FD2PSXGD.mjs +52 -0
  127. package/dist/sdk/{ndjson-sink-B4V4NTAQ.mjs.map → ndjson-sink-FD2PSXGD.mjs.map} +1 -1
  128. package/dist/sdk/{prompt-state-EZYOUG75.mjs → prompt-state-YHGXB2OA.mjs} +5 -5
  129. package/dist/sdk/{renderer-schema-CKFB5NDB.mjs → renderer-schema-CMXOLNIG.mjs} +4 -4
  130. package/dist/sdk/routing-S3Y7T2X3.mjs +24 -0
  131. package/dist/sdk/sdk.d.mts +212 -4
  132. package/dist/sdk/sdk.d.ts +212 -4
  133. package/dist/sdk/sdk.js +26927 -6264
  134. package/dist/sdk/sdk.js.map +1 -1
  135. package/dist/sdk/sdk.mjs +23 -1278
  136. package/dist/sdk/sdk.mjs.map +1 -1
  137. package/dist/sdk/session-registry-6PV6SGEJ.mjs +10 -0
  138. package/dist/sdk/slack-frontend-R3M2CACB.mjs +899 -0
  139. package/dist/sdk/slack-frontend-R3M2CACB.mjs.map +1 -0
  140. package/dist/sdk/{trace-helpers-VP6QYVBX.mjs → trace-helpers-YHNPC7MR.mjs} +4 -4
  141. package/dist/sdk/tracer-init-XPRWKMZT.mjs +10 -0
  142. package/dist/sdk/tui-frontend-S546M7A7.mjs +281 -0
  143. package/dist/sdk/tui-frontend-S546M7A7.mjs.map +1 -0
  144. package/dist/sdk/workflow-check-provider-4F3432ZP.mjs +28 -0
  145. package/dist/sdk/workflow-check-provider-A44PBPG2.mjs +28 -0
  146. package/dist/sdk/workflow-check-provider-A44PBPG2.mjs.map +1 -0
  147. package/dist/sdk/workflow-registry-ZAYYXLEP.mjs +12 -0
  148. package/dist/sdk/workflow-registry-ZAYYXLEP.mjs.map +1 -0
  149. package/dist/slack/client.d.ts +28 -0
  150. package/dist/slack/client.d.ts.map +1 -1
  151. package/dist/slack/schedule-tool-handler.d.ts +46 -0
  152. package/dist/slack/schedule-tool-handler.d.ts.map +1 -0
  153. package/dist/slack/slack-output-adapter.d.ts +44 -0
  154. package/dist/slack/slack-output-adapter.d.ts.map +1 -0
  155. package/dist/slack/socket-runner.d.ts +22 -0
  156. package/dist/slack/socket-runner.d.ts.map +1 -1
  157. package/dist/state-machine/dispatch/execution-invoker.d.ts.map +1 -1
  158. package/dist/state-machine/dispatch/foreach-processor.d.ts.map +1 -1
  159. package/dist/state-machine/dispatch/sandbox-routing.d.ts +21 -0
  160. package/dist/state-machine/dispatch/sandbox-routing.d.ts.map +1 -0
  161. package/dist/state-machine/states/level-dispatch.d.ts.map +1 -1
  162. package/dist/state-machine-execution-engine.d.ts.map +1 -1
  163. package/dist/test-runner/index.d.ts +5 -0
  164. package/dist/test-runner/index.d.ts.map +1 -1
  165. package/dist/{output/traces/run-2026-02-01T09-59-08-165Z.ndjson → traces/run-2026-02-08T18-16-04-160Z.ndjson} +84 -84
  166. package/dist/{output/traces/run-2026-02-01T09-59-52-595Z.ndjson → traces/run-2026-02-08T18-16-51-253Z.ndjson} +1029 -1029
  167. package/dist/tui/chat-runner.d.ts +39 -0
  168. package/dist/tui/chat-runner.d.ts.map +1 -0
  169. package/dist/tui/chat-state.d.ts +56 -0
  170. package/dist/tui/chat-state.d.ts.map +1 -0
  171. package/dist/tui/chat-tui.d.ts +69 -0
  172. package/dist/tui/chat-tui.d.ts.map +1 -0
  173. package/dist/tui/components/chat-box.d.ts +33 -0
  174. package/dist/tui/components/chat-box.d.ts.map +1 -0
  175. package/dist/tui/components/input-bar.d.ts +50 -0
  176. package/dist/tui/components/input-bar.d.ts.map +1 -0
  177. package/dist/tui/components/status-bar.d.ts +31 -0
  178. package/dist/tui/components/status-bar.d.ts.map +1 -0
  179. package/dist/tui/components/trace-viewer.d.ts +73 -0
  180. package/dist/tui/components/trace-viewer.d.ts.map +1 -0
  181. package/dist/tui/index.d.ts +14 -0
  182. package/dist/tui/index.d.ts.map +1 -0
  183. package/dist/tui/tui-frontend.d.ts +29 -0
  184. package/dist/tui/tui-frontend.d.ts.map +1 -0
  185. package/dist/types/bot.d.ts +35 -0
  186. package/dist/types/bot.d.ts.map +1 -1
  187. package/dist/types/config.d.ts +152 -3
  188. package/dist/types/config.d.ts.map +1 -1
  189. package/dist/types/engine.d.ts +3 -0
  190. package/dist/types/engine.d.ts.map +1 -1
  191. package/dist/utils/sandbox.d.ts.map +1 -1
  192. package/dist/utils/workspace-manager.d.ts +22 -2
  193. package/dist/utils/workspace-manager.d.ts.map +1 -1
  194. package/dist/utils/worktree-manager.d.ts +2 -1
  195. package/dist/utils/worktree-manager.d.ts.map +1 -1
  196. package/package.json +4 -2
  197. package/dist/docs/NPM_USAGE.md +0 -281
  198. package/dist/generated/config-schema.json +0 -2161
  199. package/dist/sdk/check-provider-registry-CVUONJ5A.mjs +0 -28
  200. package/dist/sdk/chunk-BOVFH3LI.mjs.map +0 -1
  201. package/dist/sdk/chunk-TS6BUNAI.mjs +0 -17722
  202. package/dist/sdk/chunk-TS6BUNAI.mjs.map +0 -1
  203. package/dist/sdk/chunk-XWJPT5KQ.mjs.map +0 -1
  204. package/dist/sdk/command-executor-Q7MHJKZJ.mjs +0 -14
  205. package/dist/sdk/config-DXX64GD3.mjs +0 -16
  206. package/dist/sdk/config-merger-PX3WIT57.mjs +0 -10
  207. package/dist/sdk/event-bus-5BEVPQ6T.mjs +0 -35
  208. package/dist/sdk/failure-condition-evaluator-G4HMJPXF.mjs +0 -17
  209. package/dist/sdk/git-repository-analyzer-HJC4MYW4.mjs +0 -458
  210. package/dist/sdk/git-repository-analyzer-HJC4MYW4.mjs.map +0 -1
  211. package/dist/sdk/github-frontend-5PCKKHVC.mjs.map +0 -1
  212. package/dist/sdk/host-H3AWNZ2F.mjs +0 -52
  213. package/dist/sdk/host-H3AWNZ2F.mjs.map +0 -1
  214. package/dist/sdk/memory-store-RW5N2NGJ.mjs +0 -12
  215. package/dist/sdk/ndjson-sink-B4V4NTAQ.mjs +0 -44
  216. package/dist/sdk/routing-QHTGDIXF.mjs +0 -24
  217. package/dist/sdk/session-registry-4E6YRQ77.mjs +0 -10
  218. package/dist/sdk/slack-frontend-JUT3TYVC.mjs +0 -821
  219. package/dist/sdk/slack-frontend-JUT3TYVC.mjs.map +0 -1
  220. package/dist/sdk/tracer-init-GSLPPLCD.mjs +0 -10
  221. package/dist/sdk/workflow-check-provider-3IWBAZP7.mjs +0 -28
  222. package/dist/sdk/workflow-registry-KFWSDSLM.mjs +0 -12
  223. package/dist/tui.d.ts +0 -51
  224. package/dist/tui.d.ts.map +0 -1
  225. /package/dist/sdk/{check-provider-registry-CVUONJ5A.mjs.map → check-provider-registry-ACRGIYOB.mjs.map} +0 -0
  226. /package/dist/sdk/{chunk-WMJKH4XE.mjs.map → check-provider-registry-VYHKFHK2.mjs.map} +0 -0
  227. /package/dist/sdk/{chunk-CNX7V5JK.mjs.map → chunk-25IC7KXZ.mjs.map} +0 -0
  228. /package/dist/sdk/{chunk-IHZOSIF4.mjs.map → chunk-2KB35MB7.mjs.map} +0 -0
  229. /package/dist/sdk/{chunk-HQL734ZI.mjs.map → chunk-6W75IMDC.mjs.map} +0 -0
  230. /package/dist/sdk/{chunk-3OMWVM6J.mjs.map → chunk-B7BVQM5K.mjs.map} +0 -0
  231. /package/dist/sdk/{chunk-VW2GBXQT.mjs.map → chunk-D5KI4YQ4.mjs.map} +0 -0
  232. /package/dist/sdk/{command-executor-Q7MHJKZJ.mjs.map → chunk-J7LXIPZS.mjs.map} +0 -0
  233. /package/dist/sdk/{chunk-EXFGO4FX.mjs.map → chunk-KFKHU6CM.mjs.map} +0 -0
  234. /package/dist/sdk/{chunk-MPS4HVQI.mjs.map → chunk-N7HO6KKC.mjs.map} +0 -0
  235. /package/dist/sdk/{chunk-O5EZDNYL.mjs.map → chunk-NCWIZVOT.mjs.map} +0 -0
  236. /package/dist/sdk/{chunk-3NMLT3YS.mjs.map → chunk-PO7X5XI7.mjs.map} +0 -0
  237. /package/dist/sdk/{chunk-BHOKBQPB.mjs.map → chunk-R5Z7YWPB.mjs.map} +0 -0
  238. /package/dist/sdk/{chunk-EORMDOZU.mjs.map → chunk-SGS2VMEL.mjs.map} +0 -0
  239. /package/dist/sdk/{chunk-J2QWVDXK.mjs.map → chunk-XDLQ3UNF.mjs.map} +0 -0
  240. /package/dist/sdk/{chunk-S2RUE2RG.mjs.map → chunk-XR7XXGL7.mjs.map} +0 -0
  241. /package/dist/sdk/{chunk-NAW3DB3I.mjs.map → chunk-XXAEN5KU.mjs.map} +0 -0
  242. /package/dist/sdk/{config-DXX64GD3.mjs.map → command-executor-DVVXERLR.mjs.map} +0 -0
  243. /package/dist/sdk/{config-merger-PX3WIT57.mjs.map → config-7VTT64SQ.mjs.map} +0 -0
  244. /package/dist/sdk/{failure-condition-evaluator-G4HMJPXF.mjs.map → config-merger-RKCZJQ44.mjs.map} +0 -0
  245. /package/dist/sdk/{liquid-extensions-I7O7KMHF.mjs.map → failure-condition-evaluator-4WMDF4Q3.mjs.map} +0 -0
  246. /package/dist/sdk/{memory-store-RW5N2NGJ.mjs.map → liquid-extensions-5IZLTFSZ.mjs.map} +0 -0
  247. /package/dist/sdk/{metrics-7PP3EJUH.mjs.map → memory-store-3N4AZCYB.mjs.map} +0 -0
  248. /package/dist/sdk/{prompt-state-EZYOUG75.mjs.map → metrics-GXQ2EDXA.mjs.map} +0 -0
  249. /package/dist/sdk/{routing-QHTGDIXF.mjs.map → prompt-state-YHGXB2OA.mjs.map} +0 -0
  250. /package/dist/sdk/{renderer-schema-CKFB5NDB.mjs.map → renderer-schema-CMXOLNIG.mjs.map} +0 -0
  251. /package/dist/sdk/{session-registry-4E6YRQ77.mjs.map → routing-S3Y7T2X3.mjs.map} +0 -0
  252. /package/dist/sdk/{trace-helpers-VP6QYVBX.mjs.map → session-registry-6PV6SGEJ.mjs.map} +0 -0
  253. /package/dist/sdk/{tracer-init-GSLPPLCD.mjs.map → trace-helpers-YHNPC7MR.mjs.map} +0 -0
  254. /package/dist/sdk/{workflow-check-provider-3IWBAZP7.mjs.map → tracer-init-XPRWKMZT.mjs.map} +0 -0
  255. /package/dist/sdk/{workflow-registry-KFWSDSLM.mjs.map → workflow-check-provider-4F3432ZP.mjs.map} +0 -0
@@ -1,2161 +0,0 @@
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
- "fail_fast": {
110
- "type": "boolean",
111
- "description": "Stop execution when any check fails (default: false)"
112
- },
113
- "fail_if": {
114
- "type": "string",
115
- "description": "Simple global fail condition - fails if expression evaluates to true"
116
- },
117
- "failure_conditions": {
118
- "$ref": "#/definitions/FailureConditions",
119
- "description": "Global failure conditions - optional (deprecated, use fail_if)"
120
- },
121
- "tag_filter": {
122
- "$ref": "#/definitions/TagFilter",
123
- "description": "Tag filter for selective check execution"
124
- },
125
- "routing": {
126
- "$ref": "#/definitions/RoutingDefaults",
127
- "description": "Optional routing defaults for retry/goto/run policies"
128
- },
129
- "limits": {
130
- "$ref": "#/definitions/LimitsConfig",
131
- "description": "Global execution limits"
132
- },
133
- "frontends": {
134
- "type": "array",
135
- "items": {
136
- "type": "object",
137
- "properties": {
138
- "name": {
139
- "type": "string",
140
- "description": "Frontend name, e.g., 'ndjson-sink', 'github'"
141
- },
142
- "config": {
143
- "description": "Frontend-specific configuration"
144
- }
145
- },
146
- "required": [
147
- "name"
148
- ],
149
- "additionalProperties": false
150
- },
151
- "description": "Optional integrations: event-driven frontends (e.g., ndjson-sink, github)"
152
- },
153
- "workspace": {
154
- "$ref": "#/definitions/WorkspaceConfig",
155
- "description": "Workspace isolation configuration for sandboxed execution"
156
- },
157
- "slack": {
158
- "$ref": "#/definitions/SlackConfig",
159
- "description": "Slack configuration"
160
- }
161
- },
162
- "required": [
163
- "version"
164
- ],
165
- "patternProperties": {
166
- "^x-": {}
167
- }
168
- },
169
- "Record<string,unknown>": {
170
- "type": "object",
171
- "additionalProperties": {}
172
- },
173
- "Record<string,CustomToolDefinition>": {
174
- "type": "object",
175
- "additionalProperties": {
176
- "$ref": "#/definitions/CustomToolDefinition"
177
- }
178
- },
179
- "CustomToolDefinition": {
180
- "type": "object",
181
- "properties": {
182
- "name": {
183
- "type": "string",
184
- "description": "Tool name - used to reference the tool in MCP blocks"
185
- },
186
- "description": {
187
- "type": "string",
188
- "description": "Description of what the tool does"
189
- },
190
- "inputSchema": {
191
- "type": "object",
192
- "properties": {
193
- "type": {
194
- "type": "string",
195
- "const": "object"
196
- },
197
- "properties": {
198
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
199
- },
200
- "required": {
201
- "type": "array",
202
- "items": {
203
- "type": "string"
204
- }
205
- },
206
- "additionalProperties": {
207
- "type": "boolean"
208
- }
209
- },
210
- "required": [
211
- "type"
212
- ],
213
- "additionalProperties": false,
214
- "description": "Input schema for the tool (JSON Schema format)",
215
- "patternProperties": {
216
- "^x-": {}
217
- }
218
- },
219
- "exec": {
220
- "type": "string",
221
- "description": "Command to execute - supports Liquid template"
222
- },
223
- "stdin": {
224
- "type": "string",
225
- "description": "Optional stdin input - supports Liquid template"
226
- },
227
- "transform": {
228
- "type": "string",
229
- "description": "Transform the raw output - supports Liquid template"
230
- },
231
- "transform_js": {
232
- "type": "string",
233
- "description": "Transform the output using JavaScript - alternative to transform"
234
- },
235
- "cwd": {
236
- "type": "string",
237
- "description": "Working directory for command execution"
238
- },
239
- "env": {
240
- "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
241
- "description": "Environment variables for the command"
242
- },
243
- "timeout": {
244
- "type": "number",
245
- "description": "Timeout in milliseconds"
246
- },
247
- "parseJson": {
248
- "type": "boolean",
249
- "description": "Whether to parse output as JSON automatically"
250
- },
251
- "outputSchema": {
252
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
253
- "description": "Expected output schema for validation"
254
- }
255
- },
256
- "required": [
257
- "name",
258
- "exec"
259
- ],
260
- "additionalProperties": false,
261
- "description": "Custom tool definition for use in MCP blocks",
262
- "patternProperties": {
263
- "^x-": {}
264
- }
265
- },
266
- "Record<string,string>": {
267
- "type": "object",
268
- "additionalProperties": {
269
- "type": "string"
270
- }
271
- },
272
- "WorkflowInput": {
273
- "type": "object",
274
- "properties": {
275
- "name": {
276
- "type": "string",
277
- "description": "Input parameter name"
278
- },
279
- "schema": {
280
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
281
- "description": "JSON Schema for the input"
282
- },
283
- "required": {
284
- "type": "boolean",
285
- "description": "Whether this input is required"
286
- },
287
- "default": {
288
- "description": "Default value if not provided"
289
- },
290
- "description": {
291
- "type": "string",
292
- "description": "Human-readable description"
293
- }
294
- },
295
- "required": [
296
- "name"
297
- ],
298
- "additionalProperties": false,
299
- "description": "Workflow input definition for standalone reusable workflows",
300
- "patternProperties": {
301
- "^x-": {}
302
- }
303
- },
304
- "WorkflowOutput": {
305
- "type": "object",
306
- "properties": {
307
- "name": {
308
- "type": "string",
309
- "description": "Output name"
310
- },
311
- "description": {
312
- "type": "string",
313
- "description": "Human-readable description"
314
- },
315
- "value": {
316
- "type": "string",
317
- "description": "Value using Liquid template syntax (references step outputs)"
318
- },
319
- "value_js": {
320
- "type": "string",
321
- "description": "Value using JavaScript expression (alternative to value)"
322
- }
323
- },
324
- "required": [
325
- "name"
326
- ],
327
- "additionalProperties": false,
328
- "description": "Workflow output definition for standalone reusable workflows",
329
- "patternProperties": {
330
- "^x-": {}
331
- }
332
- },
333
- "Record<string,CheckConfig>": {
334
- "type": "object",
335
- "additionalProperties": {
336
- "$ref": "#/definitions/CheckConfig"
337
- }
338
- },
339
- "CheckConfig": {
340
- "type": "object",
341
- "properties": {
342
- "type": {
343
- "$ref": "#/definitions/ConfigCheckType",
344
- "description": "Type of check to perform (defaults to 'ai' if not specified)"
345
- },
346
- "prompt": {
347
- "type": "string",
348
- "description": "AI prompt for the check - can be inline string or file path (auto-detected) - required for AI checks"
349
- },
350
- "appendPrompt": {
351
- "type": "string",
352
- "description": "Additional prompt to append when extending configurations - merged with parent prompt"
353
- },
354
- "exec": {
355
- "type": "string",
356
- "description": "Command execution with Liquid template support - required for command checks"
357
- },
358
- "stdin": {
359
- "type": "string",
360
- "description": "Stdin input for tools with Liquid template support - optional for tool checks"
361
- },
362
- "url": {
363
- "type": "string",
364
- "description": "HTTP URL - required for http output checks"
365
- },
366
- "body": {
367
- "type": "string",
368
- "description": "HTTP body template (Liquid) - required for http output checks"
369
- },
370
- "method": {
371
- "type": "string",
372
- "description": "HTTP method (defaults to POST)"
373
- },
374
- "headers": {
375
- "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
376
- "description": "HTTP headers"
377
- },
378
- "endpoint": {
379
- "type": "string",
380
- "description": "HTTP endpoint path - required for http_input checks"
381
- },
382
- "transform": {
383
- "type": "string",
384
- "description": "Transform template for http_input data (Liquid) - optional"
385
- },
386
- "transform_js": {
387
- "type": "string",
388
- "description": "Transform using JavaScript expressions (evaluated in secure sandbox) - optional"
389
- },
390
- "content": {
391
- "type": "string",
392
- "description": "Script content to execute for script checks"
393
- },
394
- "schedule": {
395
- "type": "string",
396
- "description": "Cron schedule expression (e.g., \"0 2 * * *\") - optional for any check type"
397
- },
398
- "focus": {
399
- "type": "string",
400
- "description": "Focus area for the check (security/performance/style/architecture/all) - optional"
401
- },
402
- "command": {
403
- "type": "string",
404
- "description": "Command that triggers this check (e.g., \"review\", \"security-scan\") - optional"
405
- },
406
- "on": {
407
- "type": "array",
408
- "items": {
409
- "$ref": "#/definitions/EventTrigger"
410
- },
411
- "description": "Events that trigger this check (defaults to ['manual'] if not specified)"
412
- },
413
- "triggers": {
414
- "type": "array",
415
- "items": {
416
- "type": "string"
417
- },
418
- "description": "File patterns that trigger this check (optional)"
419
- },
420
- "ai": {
421
- "$ref": "#/definitions/AIProviderConfig",
422
- "description": "AI provider configuration (optional)"
423
- },
424
- "ai_model": {
425
- "type": "string",
426
- "description": "AI model to use for this check - overrides global setting"
427
- },
428
- "ai_provider": {
429
- "type": "string",
430
- "description": "AI provider to use for this check - overrides global setting"
431
- },
432
- "ai_persona": {
433
- "type": "string",
434
- "description": "Optional persona hint, prepended to the prompt as 'Persona: <value>'"
435
- },
436
- "ai_prompt_type": {
437
- "type": "string",
438
- "description": "Probe promptType for this check (underscore style)"
439
- },
440
- "ai_max_iterations": {
441
- "type": "number",
442
- "description": "Maximum tool iterations for ProbeAgent (underscore style)"
443
- },
444
- "ai_system_prompt": {
445
- "type": "string",
446
- "description": "System prompt for this check (underscore style)"
447
- },
448
- "ai_custom_prompt": {
449
- "type": "string",
450
- "description": "Legacy customPrompt (underscore style) — deprecated, use ai_system_prompt"
451
- },
452
- "ai_mcp_servers": {
453
- "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
454
- "description": "MCP servers for this AI check - overrides global setting"
455
- },
456
- "ai_custom_tools": {
457
- "type": "array",
458
- "items": {
459
- "type": "string"
460
- },
461
- "description": "List of custom tool names to expose to this AI check via ephemeral SSE MCP server"
462
- },
463
- "claude_code": {
464
- "$ref": "#/definitions/ClaudeCodeConfig",
465
- "description": "Claude Code configuration (for claude-code type checks)"
466
- },
467
- "env": {
468
- "$ref": "#/definitions/EnvConfig",
469
- "description": "Environment variables for this check"
470
- },
471
- "timeout": {
472
- "type": "number",
473
- "description": "Timeout in milliseconds for command execution (default: 60000, i.e., 60 seconds)"
474
- },
475
- "depends_on": {
476
- "anyOf": [
477
- {
478
- "type": "string"
479
- },
480
- {
481
- "type": "array",
482
- "items": {
483
- "type": "string"
484
- }
485
- }
486
- ],
487
- "description": "Check IDs that this check depends on (optional). Accepts single string or array."
488
- },
489
- "group": {
490
- "type": "string",
491
- "description": "Group name for comment separation (e.g., \"code-review\", \"pr-overview\") - optional"
492
- },
493
- "schema": {
494
- "anyOf": [
495
- {
496
- "type": "string"
497
- },
498
- {
499
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
500
- }
501
- ],
502
- "description": "Schema type for template rendering (e.g., \"code-review\", \"markdown\") or inline JSON schema object - optional"
503
- },
504
- "output_schema": {
505
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
506
- "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."
507
- },
508
- "template": {
509
- "$ref": "#/definitions/CustomTemplateConfig",
510
- "description": "Custom template configuration - optional"
511
- },
512
- "if": {
513
- "type": "string",
514
- "description": "Condition to determine if check should run - runs if expression evaluates to true"
515
- },
516
- "reuse_ai_session": {
517
- "type": [
518
- "string",
519
- "boolean"
520
- ],
521
- "description": "Check name to reuse AI session from, or true to use first dependency (only works with depends_on)"
522
- },
523
- "session_mode": {
524
- "type": "string",
525
- "enum": [
526
- "clone",
527
- "append"
528
- ],
529
- "description": "How to reuse AI session: 'clone' (default, copy history) or 'append' (share history)"
530
- },
531
- "fail_if": {
532
- "type": "string",
533
- "description": "Simple fail condition - fails check if expression evaluates to true"
534
- },
535
- "failure_conditions": {
536
- "$ref": "#/definitions/FailureConditions",
537
- "description": "Check-specific failure conditions - optional (deprecated, use fail_if)"
538
- },
539
- "tags": {
540
- "type": "array",
541
- "items": {
542
- "type": "string"
543
- },
544
- "description": "Tags for categorizing and filtering checks (e.g., [\"local\", \"fast\", \"security\"])"
545
- },
546
- "criticality": {
547
- "type": "string",
548
- "enum": [
549
- "external",
550
- "internal",
551
- "policy",
552
- "info"
553
- ],
554
- "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."
555
- },
556
- "continue_on_failure": {
557
- "type": "boolean",
558
- "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."
559
- },
560
- "forEach": {
561
- "type": "boolean",
562
- "description": "Process output as array and run dependent checks for each item"
563
- },
564
- "fanout": {
565
- "type": "string",
566
- "enum": [
567
- "map",
568
- "reduce"
569
- ],
570
- "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."
571
- },
572
- "reduce": {
573
- "type": "boolean",
574
- "description": "Alias for fanout: 'reduce'"
575
- },
576
- "on_init": {
577
- "$ref": "#/definitions/OnInitConfig",
578
- "description": "Init routing configuration for this check (runs before execution/preprocessing)"
579
- },
580
- "on_fail": {
581
- "$ref": "#/definitions/OnFailConfig",
582
- "description": "Failure routing configuration for this check (retry/goto/run)"
583
- },
584
- "on_success": {
585
- "$ref": "#/definitions/OnSuccessConfig",
586
- "description": "Success routing configuration for this check (post-actions and optional goto)"
587
- },
588
- "on_finish": {
589
- "$ref": "#/definitions/OnFinishConfig",
590
- "description": "Finish routing configuration for forEach checks (runs after ALL iterations complete)"
591
- },
592
- "assume": {
593
- "anyOf": [
594
- {
595
- "type": "string"
596
- },
597
- {
598
- "type": "array",
599
- "items": {
600
- "type": "string"
601
- }
602
- }
603
- ],
604
- "description": "Preconditions that must hold before executing the check. If any expression evaluates to false, the check is skipped (skipReason='assume')."
605
- },
606
- "guarantee": {
607
- "anyOf": [
608
- {
609
- "type": "string"
610
- },
611
- {
612
- "type": "array",
613
- "items": {
614
- "type": "string"
615
- }
616
- }
617
- ],
618
- "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\"."
619
- },
620
- "max_runs": {
621
- "type": "number",
622
- "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."
623
- },
624
- "message": {
625
- "type": "string",
626
- "description": "Message template for log checks"
627
- },
628
- "level": {
629
- "type": "string",
630
- "enum": [
631
- "debug",
632
- "info",
633
- "warn",
634
- "error"
635
- ],
636
- "description": "Log level for log checks"
637
- },
638
- "include_pr_context": {
639
- "type": "boolean",
640
- "description": "Include PR context in log output"
641
- },
642
- "include_dependencies": {
643
- "type": "boolean",
644
- "description": "Include dependency summaries in log output"
645
- },
646
- "include_metadata": {
647
- "type": "boolean",
648
- "description": "Include execution metadata in log output"
649
- },
650
- "output_format": {
651
- "type": "string",
652
- "enum": [
653
- "json",
654
- "text"
655
- ],
656
- "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."
657
- },
658
- "operation": {
659
- "type": "string",
660
- "enum": [
661
- "get",
662
- "set",
663
- "append",
664
- "increment",
665
- "delete",
666
- "clear",
667
- "list"
668
- ],
669
- "description": "Memory operation to perform. Use `type: 'script'` for custom JavaScript."
670
- },
671
- "key": {
672
- "type": "string",
673
- "description": "Key for memory operation"
674
- },
675
- "value": {
676
- "description": "Value for set/append operations"
677
- },
678
- "value_js": {
679
- "type": "string",
680
- "description": "JavaScript expression to compute value dynamically"
681
- },
682
- "namespace": {
683
- "type": "string",
684
- "description": "Override namespace for this check"
685
- },
686
- "op": {
687
- "type": "string",
688
- "description": "GitHub operation to perform (e.g., 'labels.add', 'labels.remove', 'comment.create')"
689
- },
690
- "values": {
691
- "anyOf": [
692
- {
693
- "type": "array",
694
- "items": {
695
- "type": "string"
696
- }
697
- },
698
- {
699
- "type": "string"
700
- }
701
- ],
702
- "description": "Values for GitHub operations (can be array or single value)"
703
- },
704
- "transport": {
705
- "type": "string",
706
- "enum": [
707
- "stdio",
708
- "sse",
709
- "http"
710
- ],
711
- "description": "Transport type for MCP: stdio (default), sse (legacy), or http (streamable HTTP)"
712
- },
713
- "methodArgs": {
714
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
715
- "description": "Arguments to pass to the MCP method (supports Liquid templates)"
716
- },
717
- "argsTransform": {
718
- "type": "string",
719
- "description": "Transform template for method arguments (Liquid)"
720
- },
721
- "sessionId": {
722
- "type": "string",
723
- "description": "Session ID for HTTP transport (optional, server may generate one)"
724
- },
725
- "command_args": {
726
- "type": "array",
727
- "items": {
728
- "type": "string"
729
- },
730
- "description": "Command arguments (for stdio transport in MCP checks)"
731
- },
732
- "workingDirectory": {
733
- "type": "string",
734
- "description": "Working directory (for stdio transport in MCP checks)"
735
- },
736
- "placeholder": {
737
- "type": "string",
738
- "description": "Placeholder text to show in input field"
739
- },
740
- "allow_empty": {
741
- "type": "boolean",
742
- "description": "Allow empty input (default: false)"
743
- },
744
- "multiline": {
745
- "type": "boolean",
746
- "description": "Support multiline input (default: false)"
747
- },
748
- "default": {
749
- "type": "string",
750
- "description": "Default value if timeout occurs or empty input when allow_empty is true"
751
- },
752
- "workflow": {
753
- "type": "string",
754
- "description": "Workflow ID or path to workflow file"
755
- },
756
- "args": {
757
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
758
- "description": "Arguments/inputs for the workflow"
759
- },
760
- "overrides": {
761
- "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453%3E%3E",
762
- "description": "Override specific step configurations in the workflow"
763
- },
764
- "output_mapping": {
765
- "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
766
- "description": "Map workflow outputs to check outputs"
767
- },
768
- "workflow_inputs": {
769
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
770
- "description": "Alias for args - workflow inputs (backward compatibility)"
771
- },
772
- "config": {
773
- "type": "string",
774
- "description": "Config file path - alternative to workflow ID (loads a Visor config file as workflow)"
775
- },
776
- "workflow_overrides": {
777
- "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453%3E%3E",
778
- "description": "Alias for overrides - workflow step overrides (backward compatibility)"
779
- },
780
- "ref": {
781
- "type": "string",
782
- "description": "Git reference to checkout (branch, tag, commit SHA) - supports templates"
783
- },
784
- "repository": {
785
- "type": "string",
786
- "description": "Repository URL or owner/repo format (defaults to current repository)"
787
- },
788
- "token": {
789
- "type": "string",
790
- "description": "GitHub token for private repositories (defaults to GITHUB_TOKEN env)"
791
- },
792
- "fetch_depth": {
793
- "type": "number",
794
- "description": "Number of commits to fetch (0 for full history, default: 1)"
795
- },
796
- "fetch_tags": {
797
- "type": "boolean",
798
- "description": "Whether to fetch tags (default: false)"
799
- },
800
- "submodules": {
801
- "anyOf": [
802
- {
803
- "type": "boolean"
804
- },
805
- {
806
- "type": "string",
807
- "const": "recursive"
808
- }
809
- ],
810
- "description": "Checkout submodules: false, true, or 'recursive'"
811
- },
812
- "working_directory": {
813
- "type": "string",
814
- "description": "Working directory for the checkout (defaults to temp directory)"
815
- },
816
- "use_worktree": {
817
- "type": "boolean",
818
- "description": "Use git worktree for efficient parallel checkouts (default: true)"
819
- },
820
- "clean": {
821
- "type": "boolean",
822
- "description": "Clean the working directory before checkout (default: true)"
823
- },
824
- "sparse_checkout": {
825
- "type": "array",
826
- "items": {
827
- "type": "string"
828
- },
829
- "description": "Sparse checkout paths - only checkout specific directories/files"
830
- },
831
- "lfs": {
832
- "type": "boolean",
833
- "description": "Enable Git LFS (Large File Storage)"
834
- },
835
- "clone_timeout_ms": {
836
- "type": "number",
837
- "description": "Timeout in ms for cloning the bare repository (default: 300000 = 5 min)"
838
- },
839
- "cleanup_on_failure": {
840
- "type": "boolean",
841
- "description": "Clean up worktree on failure (default: true)"
842
- },
843
- "persist_worktree": {
844
- "type": "boolean",
845
- "description": "Keep worktree after workflow completion (default: false)"
846
- }
847
- },
848
- "additionalProperties": false,
849
- "description": "Configuration for a single check",
850
- "patternProperties": {
851
- "^x-": {}
852
- }
853
- },
854
- "ConfigCheckType": {
855
- "type": "string",
856
- "enum": [
857
- "ai",
858
- "command",
859
- "script",
860
- "http",
861
- "http_input",
862
- "http_client",
863
- "noop",
864
- "log",
865
- "memory",
866
- "github",
867
- "claude-code",
868
- "mcp",
869
- "human-input",
870
- "workflow",
871
- "git-checkout"
872
- ],
873
- "description": "Valid check types in configuration"
874
- },
875
- "EventTrigger": {
876
- "type": "string",
877
- "enum": [
878
- "pr_opened",
879
- "pr_updated",
880
- "pr_closed",
881
- "issue_opened",
882
- "issue_comment",
883
- "manual",
884
- "schedule",
885
- "webhook_received"
886
- ],
887
- "description": "Valid event triggers for checks"
888
- },
889
- "AIProviderConfig": {
890
- "type": "object",
891
- "properties": {
892
- "provider": {
893
- "type": "string",
894
- "enum": [
895
- "google",
896
- "anthropic",
897
- "openai",
898
- "bedrock",
899
- "mock"
900
- ],
901
- "description": "AI provider to use"
902
- },
903
- "model": {
904
- "type": "string",
905
- "description": "Model name to use"
906
- },
907
- "apiKey": {
908
- "type": "string",
909
- "description": "API key (usually from environment variables)"
910
- },
911
- "timeout": {
912
- "type": "number",
913
- "description": "Request timeout in milliseconds"
914
- },
915
- "max_iterations": {
916
- "type": "number",
917
- "description": "Maximum tool iterations for ProbeAgent"
918
- },
919
- "debug": {
920
- "type": "boolean",
921
- "description": "Enable debug mode"
922
- },
923
- "prompt_type": {
924
- "type": "string",
925
- "description": "Probe promptType to use (e.g., engineer, code-review, architect)"
926
- },
927
- "system_prompt": {
928
- "type": "string",
929
- "description": "System prompt (baseline preamble). Replaces legacy custom_prompt."
930
- },
931
- "custom_prompt": {
932
- "type": "string",
933
- "description": "Probe customPrompt (baseline/system prompt) — deprecated, use system_prompt"
934
- },
935
- "skip_code_context": {
936
- "type": "boolean",
937
- "description": "Skip adding code context (diffs, files, PR info) to the prompt"
938
- },
939
- "skip_slack_context": {
940
- "type": "boolean",
941
- "description": "Skip adding Slack conversation context to the prompt (when running under Slack)"
942
- },
943
- "skip_transport_context": {
944
- "type": "boolean",
945
- "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."
946
- },
947
- "mcpServers": {
948
- "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
949
- "description": "MCP servers configuration"
950
- },
951
- "enableDelegate": {
952
- "type": "boolean",
953
- "description": "Enable the delegate tool for task distribution to subagents"
954
- },
955
- "retry": {
956
- "$ref": "#/definitions/AIRetryConfig",
957
- "description": "Retry configuration for this provider"
958
- },
959
- "fallback": {
960
- "$ref": "#/definitions/AIFallbackConfig",
961
- "description": "Fallback configuration for provider failures"
962
- },
963
- "allowEdit": {
964
- "type": "boolean",
965
- "description": "Enable Edit and Create tools for file modification (disabled by default for security)"
966
- },
967
- "allowedTools": {
968
- "type": "array",
969
- "items": {
970
- "type": "string"
971
- },
972
- "description": "Filter allowed tools - supports whitelist, exclusion (!prefix), or raw AI mode (empty array)"
973
- },
974
- "disableTools": {
975
- "type": "boolean",
976
- "description": "Disable all tools for raw AI mode (alternative to allowedTools: [])"
977
- },
978
- "allowBash": {
979
- "type": "boolean",
980
- "description": "Enable bash command execution (shorthand for bashConfig.enabled)"
981
- },
982
- "bashConfig": {
983
- "$ref": "#/definitions/BashConfig",
984
- "description": "Advanced bash command execution configuration"
985
- },
986
- "completion_prompt": {
987
- "type": "string",
988
- "description": "Completion prompt for post-completion validation/review (runs after attempt_completion)"
989
- }
990
- },
991
- "additionalProperties": false,
992
- "description": "AI provider configuration",
993
- "patternProperties": {
994
- "^x-": {}
995
- }
996
- },
997
- "Record<string,McpServerConfig>": {
998
- "type": "object",
999
- "additionalProperties": {
1000
- "$ref": "#/definitions/McpServerConfig"
1001
- }
1002
- },
1003
- "McpServerConfig": {
1004
- "type": "object",
1005
- "properties": {
1006
- "command": {
1007
- "type": "string",
1008
- "description": "Command to execute for the MCP server"
1009
- },
1010
- "args": {
1011
- "type": "array",
1012
- "items": {
1013
- "type": "string"
1014
- },
1015
- "description": "Arguments to pass to the command"
1016
- },
1017
- "env": {
1018
- "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
1019
- "description": "Environment variables for the MCP server"
1020
- }
1021
- },
1022
- "required": [
1023
- "command"
1024
- ],
1025
- "additionalProperties": false,
1026
- "description": "MCP Server configuration",
1027
- "patternProperties": {
1028
- "^x-": {}
1029
- }
1030
- },
1031
- "AIRetryConfig": {
1032
- "type": "object",
1033
- "properties": {
1034
- "maxRetries": {
1035
- "type": "number",
1036
- "description": "Maximum retry attempts (0-50)"
1037
- },
1038
- "initialDelay": {
1039
- "type": "number",
1040
- "description": "Initial delay in milliseconds (0-60000)"
1041
- },
1042
- "maxDelay": {
1043
- "type": "number",
1044
- "description": "Maximum delay cap in milliseconds (0-300000)"
1045
- },
1046
- "backoffFactor": {
1047
- "type": "number",
1048
- "description": "Exponential backoff multiplier (1-10)"
1049
- },
1050
- "retryableErrors": {
1051
- "type": "array",
1052
- "items": {
1053
- "type": "string"
1054
- },
1055
- "description": "Custom error patterns to retry on"
1056
- }
1057
- },
1058
- "additionalProperties": false,
1059
- "description": "Retry configuration for AI provider calls",
1060
- "patternProperties": {
1061
- "^x-": {}
1062
- }
1063
- },
1064
- "AIFallbackConfig": {
1065
- "type": "object",
1066
- "properties": {
1067
- "strategy": {
1068
- "type": "string",
1069
- "enum": [
1070
- "same-model",
1071
- "same-provider",
1072
- "any",
1073
- "custom"
1074
- ],
1075
- "description": "Fallback strategy: 'same-model', 'same-provider', 'any', or 'custom'"
1076
- },
1077
- "providers": {
1078
- "type": "array",
1079
- "items": {
1080
- "$ref": "#/definitions/AIFallbackProviderConfig"
1081
- },
1082
- "description": "Array of fallback provider configurations"
1083
- },
1084
- "maxTotalAttempts": {
1085
- "type": "number",
1086
- "description": "Maximum total attempts across all providers"
1087
- },
1088
- "auto": {
1089
- "type": "boolean",
1090
- "description": "Enable automatic fallback using available environment variables"
1091
- }
1092
- },
1093
- "additionalProperties": false,
1094
- "description": "Fallback configuration for AI providers",
1095
- "patternProperties": {
1096
- "^x-": {}
1097
- }
1098
- },
1099
- "AIFallbackProviderConfig": {
1100
- "type": "object",
1101
- "properties": {
1102
- "provider": {
1103
- "type": "string",
1104
- "enum": [
1105
- "google",
1106
- "anthropic",
1107
- "openai",
1108
- "bedrock"
1109
- ],
1110
- "description": "AI provider to use"
1111
- },
1112
- "model": {
1113
- "type": "string",
1114
- "description": "Model name to use"
1115
- },
1116
- "apiKey": {
1117
- "type": "string",
1118
- "description": "API key for this provider"
1119
- },
1120
- "maxRetries": {
1121
- "type": "number",
1122
- "description": "Per-provider retry override"
1123
- },
1124
- "region": {
1125
- "type": "string",
1126
- "description": "AWS region (for Bedrock)"
1127
- },
1128
- "accessKeyId": {
1129
- "type": "string",
1130
- "description": "AWS access key ID (for Bedrock)"
1131
- },
1132
- "secretAccessKey": {
1133
- "type": "string",
1134
- "description": "AWS secret access key (for Bedrock)"
1135
- }
1136
- },
1137
- "required": [
1138
- "provider",
1139
- "model"
1140
- ],
1141
- "additionalProperties": false,
1142
- "description": "Fallback provider configuration",
1143
- "patternProperties": {
1144
- "^x-": {}
1145
- }
1146
- },
1147
- "BashConfig": {
1148
- "type": "object",
1149
- "properties": {
1150
- "allow": {
1151
- "type": "array",
1152
- "items": {
1153
- "type": "string"
1154
- },
1155
- "description": "Array of permitted command patterns (e.g., ['ls', 'git status'])"
1156
- },
1157
- "deny": {
1158
- "type": "array",
1159
- "items": {
1160
- "type": "string"
1161
- },
1162
- "description": "Array of blocked command patterns (e.g., ['rm -rf', 'sudo'])"
1163
- },
1164
- "noDefaultAllow": {
1165
- "type": "boolean",
1166
- "description": "Disable default safe command list (use with caution)"
1167
- },
1168
- "noDefaultDeny": {
1169
- "type": "boolean",
1170
- "description": "Disable default dangerous command blocklist (use with extreme caution)"
1171
- },
1172
- "timeout": {
1173
- "type": "number",
1174
- "description": "Execution timeout in milliseconds"
1175
- },
1176
- "workingDirectory": {
1177
- "type": "string",
1178
- "description": "Default working directory for command execution"
1179
- }
1180
- },
1181
- "additionalProperties": false,
1182
- "description": "Bash command execution configuration for ProbeAgent Note: Use 'allowBash: true' in AIProviderConfig to enable bash execution",
1183
- "patternProperties": {
1184
- "^x-": {}
1185
- }
1186
- },
1187
- "ClaudeCodeConfig": {
1188
- "type": "object",
1189
- "properties": {
1190
- "allowedTools": {
1191
- "type": "array",
1192
- "items": {
1193
- "type": "string"
1194
- },
1195
- "description": "List of allowed tools for Claude Code to use"
1196
- },
1197
- "maxTurns": {
1198
- "type": "number",
1199
- "description": "Maximum number of turns in conversation"
1200
- },
1201
- "systemPrompt": {
1202
- "type": "string",
1203
- "description": "System prompt for Claude Code"
1204
- },
1205
- "mcpServers": {
1206
- "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
1207
- "description": "MCP servers configuration"
1208
- },
1209
- "subagent": {
1210
- "type": "string",
1211
- "description": "Path to subagent script"
1212
- },
1213
- "enableDelegate": {
1214
- "type": "boolean",
1215
- "description": "Enable the delegate tool for task distribution to subagents"
1216
- },
1217
- "hooks": {
1218
- "type": "object",
1219
- "properties": {
1220
- "onStart": {
1221
- "type": "string",
1222
- "description": "Called when check starts"
1223
- },
1224
- "onEnd": {
1225
- "type": "string",
1226
- "description": "Called when check ends"
1227
- },
1228
- "onError": {
1229
- "type": "string",
1230
- "description": "Called when check encounters an error"
1231
- }
1232
- },
1233
- "additionalProperties": false,
1234
- "description": "Event hooks for lifecycle management",
1235
- "patternProperties": {
1236
- "^x-": {}
1237
- }
1238
- }
1239
- },
1240
- "additionalProperties": false,
1241
- "description": "Claude Code configuration",
1242
- "patternProperties": {
1243
- "^x-": {}
1244
- }
1245
- },
1246
- "EnvConfig": {
1247
- "type": "object",
1248
- "additionalProperties": {
1249
- "type": [
1250
- "string",
1251
- "number",
1252
- "boolean"
1253
- ]
1254
- },
1255
- "description": "Environment variable reference configuration"
1256
- },
1257
- "CustomTemplateConfig": {
1258
- "type": "object",
1259
- "properties": {
1260
- "file": {
1261
- "type": "string",
1262
- "description": "Path to custom template file (relative to config file or absolute)"
1263
- },
1264
- "content": {
1265
- "type": "string",
1266
- "description": "Raw template content as string"
1267
- }
1268
- },
1269
- "additionalProperties": false,
1270
- "description": "Custom template configuration",
1271
- "patternProperties": {
1272
- "^x-": {}
1273
- }
1274
- },
1275
- "FailureConditions": {
1276
- "type": "object",
1277
- "additionalProperties": {
1278
- "$ref": "#/definitions/FailureCondition"
1279
- },
1280
- "description": "Collection of failure conditions"
1281
- },
1282
- "FailureCondition": {
1283
- "anyOf": [
1284
- {
1285
- "$ref": "#/definitions/SimpleFailureCondition"
1286
- },
1287
- {
1288
- "$ref": "#/definitions/ComplexFailureCondition"
1289
- }
1290
- ],
1291
- "description": "Failure condition - can be a simple expression string or complex object"
1292
- },
1293
- "SimpleFailureCondition": {
1294
- "type": "string",
1295
- "description": "Simple failure condition - just an expression string"
1296
- },
1297
- "ComplexFailureCondition": {
1298
- "type": "object",
1299
- "properties": {
1300
- "condition": {
1301
- "type": "string",
1302
- "description": "Expression to evaluate using Function Constructor"
1303
- },
1304
- "message": {
1305
- "type": "string",
1306
- "description": "Human-readable message when condition is met"
1307
- },
1308
- "severity": {
1309
- "$ref": "#/definitions/FailureConditionSeverity",
1310
- "description": "Severity level of the failure"
1311
- },
1312
- "halt_execution": {
1313
- "type": "boolean",
1314
- "description": "Whether this condition should halt execution"
1315
- }
1316
- },
1317
- "required": [
1318
- "condition"
1319
- ],
1320
- "additionalProperties": false,
1321
- "description": "Complex failure condition with additional metadata",
1322
- "patternProperties": {
1323
- "^x-": {}
1324
- }
1325
- },
1326
- "FailureConditionSeverity": {
1327
- "type": "string",
1328
- "enum": [
1329
- "error",
1330
- "warning",
1331
- "info"
1332
- ],
1333
- "description": "Failure condition severity levels"
1334
- },
1335
- "OnInitConfig": {
1336
- "type": "object",
1337
- "properties": {
1338
- "run": {
1339
- "type": "array",
1340
- "items": {
1341
- "$ref": "#/definitions/OnInitRunItem"
1342
- },
1343
- "description": "Items to run before this check executes"
1344
- },
1345
- "run_js": {
1346
- "type": "string",
1347
- "description": "Dynamic init items: JS expression returning OnInitRunItem[]"
1348
- },
1349
- "transitions": {
1350
- "type": "array",
1351
- "items": {
1352
- "$ref": "#/definitions/TransitionRule"
1353
- },
1354
- "description": "Declarative transitions (optional, for advanced use cases)"
1355
- }
1356
- },
1357
- "additionalProperties": false,
1358
- "description": "Init routing configuration per check Runs BEFORE the check executes (preprocessing/setup)",
1359
- "patternProperties": {
1360
- "^x-": {}
1361
- }
1362
- },
1363
- "OnInitRunItem": {
1364
- "anyOf": [
1365
- {
1366
- "$ref": "#/definitions/OnInitToolInvocation"
1367
- },
1368
- {
1369
- "$ref": "#/definitions/OnInitStepInvocation"
1370
- },
1371
- {
1372
- "$ref": "#/definitions/OnInitWorkflowInvocation"
1373
- },
1374
- {
1375
- "type": "string"
1376
- }
1377
- ],
1378
- "description": "Unified on_init run item - can be tool, step, workflow, or plain string"
1379
- },
1380
- "OnInitToolInvocation": {
1381
- "type": "object",
1382
- "properties": {
1383
- "tool": {
1384
- "type": "string",
1385
- "description": "Tool name (must exist in tools: section)"
1386
- },
1387
- "with": {
1388
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1389
- "description": "Arguments to pass to the tool (Liquid templates supported)"
1390
- },
1391
- "as": {
1392
- "type": "string",
1393
- "description": "Custom output name (defaults to tool name)"
1394
- }
1395
- },
1396
- "required": [
1397
- "tool"
1398
- ],
1399
- "additionalProperties": false,
1400
- "description": "Invoke a custom tool (from tools: section)",
1401
- "patternProperties": {
1402
- "^x-": {}
1403
- }
1404
- },
1405
- "OnInitStepInvocation": {
1406
- "type": "object",
1407
- "properties": {
1408
- "step": {
1409
- "type": "string",
1410
- "description": "Step name (must exist in steps: section)"
1411
- },
1412
- "with": {
1413
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1414
- "description": "Arguments to pass to the step (Liquid templates supported)"
1415
- },
1416
- "as": {
1417
- "type": "string",
1418
- "description": "Custom output name (defaults to step name)"
1419
- }
1420
- },
1421
- "required": [
1422
- "step"
1423
- ],
1424
- "additionalProperties": false,
1425
- "description": "Invoke a helper step (regular check)",
1426
- "patternProperties": {
1427
- "^x-": {}
1428
- }
1429
- },
1430
- "OnInitWorkflowInvocation": {
1431
- "type": "object",
1432
- "properties": {
1433
- "workflow": {
1434
- "type": "string",
1435
- "description": "Workflow ID or path"
1436
- },
1437
- "with": {
1438
- "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
1439
- "description": "Workflow inputs (Liquid templates supported)"
1440
- },
1441
- "as": {
1442
- "type": "string",
1443
- "description": "Custom output name (defaults to workflow name)"
1444
- },
1445
- "overrides": {
1446
- "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453%3E%3E",
1447
- "description": "Step overrides"
1448
- },
1449
- "output_mapping": {
1450
- "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
1451
- "description": "Output mapping"
1452
- }
1453
- },
1454
- "required": [
1455
- "workflow"
1456
- ],
1457
- "additionalProperties": false,
1458
- "description": "Invoke a reusable workflow",
1459
- "patternProperties": {
1460
- "^x-": {}
1461
- }
1462
- },
1463
- "Record<string,Partial<interface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453>>": {
1464
- "type": "object",
1465
- "additionalProperties": {
1466
- "$ref": "#/definitions/Partial%3Cinterface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453%3E"
1467
- }
1468
- },
1469
- "Partial<interface-src_types_config.ts-11434-23754-src_types_config.ts-0-41453>": {
1470
- "type": "object",
1471
- "additionalProperties": false
1472
- },
1473
- "TransitionRule": {
1474
- "type": "object",
1475
- "properties": {
1476
- "when": {
1477
- "type": "string",
1478
- "description": "JavaScript expression evaluated in the same sandbox as goto_js; truthy enables the rule."
1479
- },
1480
- "to": {
1481
- "type": [
1482
- "string",
1483
- "null"
1484
- ],
1485
- "description": "Target step ID, or null to explicitly prevent goto."
1486
- },
1487
- "goto_event": {
1488
- "$ref": "#/definitions/EventTrigger",
1489
- "description": "Optional event override when performing goto."
1490
- }
1491
- },
1492
- "required": [
1493
- "when"
1494
- ],
1495
- "additionalProperties": false,
1496
- "description": "Declarative transition rule for on_* blocks.",
1497
- "patternProperties": {
1498
- "^x-": {}
1499
- }
1500
- },
1501
- "OnFailConfig": {
1502
- "type": "object",
1503
- "properties": {
1504
- "retry": {
1505
- "$ref": "#/definitions/RetryPolicy",
1506
- "description": "Retry policy"
1507
- },
1508
- "run": {
1509
- "type": "array",
1510
- "items": {
1511
- "type": "string"
1512
- },
1513
- "description": "Remediation steps to run before reattempt"
1514
- },
1515
- "goto": {
1516
- "type": "string",
1517
- "description": "Jump back to an ancestor step (by id)"
1518
- },
1519
- "goto_event": {
1520
- "$ref": "#/definitions/EventTrigger",
1521
- "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1522
- },
1523
- "goto_js": {
1524
- "type": "string",
1525
- "description": "Dynamic goto: JS expression returning step id or null"
1526
- },
1527
- "run_js": {
1528
- "type": "string",
1529
- "description": "Dynamic remediation list: JS expression returning string[]"
1530
- },
1531
- "transitions": {
1532
- "type": "array",
1533
- "items": {
1534
- "$ref": "#/definitions/TransitionRule"
1535
- },
1536
- "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."
1537
- }
1538
- },
1539
- "additionalProperties": false,
1540
- "description": "Failure routing configuration per check",
1541
- "patternProperties": {
1542
- "^x-": {}
1543
- }
1544
- },
1545
- "RetryPolicy": {
1546
- "type": "object",
1547
- "properties": {
1548
- "max": {
1549
- "type": "number",
1550
- "description": "Maximum retry attempts (excluding the first attempt)"
1551
- },
1552
- "backoff": {
1553
- "$ref": "#/definitions/BackoffPolicy",
1554
- "description": "Backoff policy"
1555
- }
1556
- },
1557
- "additionalProperties": false,
1558
- "description": "Retry policy for a step",
1559
- "patternProperties": {
1560
- "^x-": {}
1561
- }
1562
- },
1563
- "BackoffPolicy": {
1564
- "type": "object",
1565
- "properties": {
1566
- "mode": {
1567
- "type": "string",
1568
- "enum": [
1569
- "fixed",
1570
- "exponential"
1571
- ],
1572
- "description": "Backoff mode"
1573
- },
1574
- "delay_ms": {
1575
- "type": "number",
1576
- "description": "Initial delay in milliseconds"
1577
- }
1578
- },
1579
- "additionalProperties": false,
1580
- "description": "Backoff policy for retries",
1581
- "patternProperties": {
1582
- "^x-": {}
1583
- }
1584
- },
1585
- "OnSuccessConfig": {
1586
- "type": "object",
1587
- "properties": {
1588
- "run": {
1589
- "type": "array",
1590
- "items": {
1591
- "type": "string"
1592
- },
1593
- "description": "Post-success steps to run"
1594
- },
1595
- "goto": {
1596
- "type": "string",
1597
- "description": "Optional jump back to ancestor step (by id)"
1598
- },
1599
- "goto_event": {
1600
- "$ref": "#/definitions/EventTrigger",
1601
- "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1602
- },
1603
- "goto_js": {
1604
- "type": "string",
1605
- "description": "Dynamic goto: JS expression returning step id or null"
1606
- },
1607
- "run_js": {
1608
- "type": "string",
1609
- "description": "Dynamic post-success steps: JS expression returning string[]"
1610
- },
1611
- "transitions": {
1612
- "type": "array",
1613
- "items": {
1614
- "$ref": "#/definitions/TransitionRule"
1615
- },
1616
- "description": "Declarative transitions (see OnFailConfig.transitions)."
1617
- }
1618
- },
1619
- "additionalProperties": false,
1620
- "description": "Success routing configuration per check",
1621
- "patternProperties": {
1622
- "^x-": {}
1623
- }
1624
- },
1625
- "OnFinishConfig": {
1626
- "type": "object",
1627
- "properties": {
1628
- "run": {
1629
- "type": "array",
1630
- "items": {
1631
- "type": "string"
1632
- },
1633
- "description": "Post-finish steps to run"
1634
- },
1635
- "goto": {
1636
- "type": "string",
1637
- "description": "Optional jump back to ancestor step (by id)"
1638
- },
1639
- "goto_event": {
1640
- "$ref": "#/definitions/EventTrigger",
1641
- "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
1642
- },
1643
- "goto_js": {
1644
- "type": "string",
1645
- "description": "Dynamic goto: JS expression returning step id or null"
1646
- },
1647
- "run_js": {
1648
- "type": "string",
1649
- "description": "Dynamic post-finish steps: JS expression returning string[]"
1650
- },
1651
- "transitions": {
1652
- "type": "array",
1653
- "items": {
1654
- "$ref": "#/definitions/TransitionRule"
1655
- },
1656
- "description": "Declarative transitions (see OnFailConfig.transitions)."
1657
- }
1658
- },
1659
- "additionalProperties": false,
1660
- "description": "Finish routing configuration for forEach checks Runs once after ALL iterations of forEach and ALL dependent checks complete",
1661
- "patternProperties": {
1662
- "^x-": {}
1663
- }
1664
- },
1665
- "OutputConfig": {
1666
- "type": "object",
1667
- "properties": {
1668
- "pr_comment": {
1669
- "$ref": "#/definitions/PrCommentOutput",
1670
- "description": "PR comment configuration"
1671
- },
1672
- "file_comment": {
1673
- "$ref": "#/definitions/FileCommentOutput",
1674
- "description": "File comment configuration (optional)"
1675
- },
1676
- "github_checks": {
1677
- "$ref": "#/definitions/GitHubCheckOutput",
1678
- "description": "GitHub check runs configuration (optional)"
1679
- },
1680
- "suppressionEnabled": {
1681
- "type": "boolean",
1682
- "description": "Whether to enable issue suppression via visor-disable comments (default: true)"
1683
- }
1684
- },
1685
- "required": [
1686
- "pr_comment"
1687
- ],
1688
- "additionalProperties": false,
1689
- "description": "Output configuration",
1690
- "patternProperties": {
1691
- "^x-": {}
1692
- }
1693
- },
1694
- "PrCommentOutput": {
1695
- "type": "object",
1696
- "properties": {
1697
- "enabled": {
1698
- "type": "boolean",
1699
- "description": "Whether PR comments are enabled"
1700
- },
1701
- "format": {
1702
- "$ref": "#/definitions/ConfigOutputFormat",
1703
- "description": "Format of the output"
1704
- },
1705
- "group_by": {
1706
- "$ref": "#/definitions/GroupByOption",
1707
- "description": "How to group the results"
1708
- },
1709
- "collapse": {
1710
- "type": "boolean",
1711
- "description": "Whether to collapse sections by default"
1712
- },
1713
- "debug": {
1714
- "$ref": "#/definitions/DebugConfig",
1715
- "description": "Debug mode configuration (optional)"
1716
- }
1717
- },
1718
- "required": [
1719
- "format",
1720
- "group_by",
1721
- "collapse"
1722
- ],
1723
- "additionalProperties": false,
1724
- "description": "PR comment output configuration",
1725
- "patternProperties": {
1726
- "^x-": {}
1727
- }
1728
- },
1729
- "ConfigOutputFormat": {
1730
- "type": "string",
1731
- "enum": [
1732
- "table",
1733
- "json",
1734
- "markdown",
1735
- "sarif"
1736
- ],
1737
- "description": "Valid output formats"
1738
- },
1739
- "GroupByOption": {
1740
- "type": "string",
1741
- "enum": [
1742
- "check",
1743
- "file",
1744
- "severity",
1745
- "group"
1746
- ],
1747
- "description": "Valid grouping options"
1748
- },
1749
- "DebugConfig": {
1750
- "type": "object",
1751
- "properties": {
1752
- "enabled": {
1753
- "type": "boolean",
1754
- "description": "Enable debug mode"
1755
- },
1756
- "includePrompts": {
1757
- "type": "boolean",
1758
- "description": "Include AI prompts in debug output"
1759
- },
1760
- "includeRawResponses": {
1761
- "type": "boolean",
1762
- "description": "Include raw AI responses in debug output"
1763
- },
1764
- "includeTiming": {
1765
- "type": "boolean",
1766
- "description": "Include timing information"
1767
- },
1768
- "includeProviderInfo": {
1769
- "type": "boolean",
1770
- "description": "Include provider information"
1771
- }
1772
- },
1773
- "required": [
1774
- "enabled",
1775
- "includePrompts",
1776
- "includeRawResponses",
1777
- "includeTiming",
1778
- "includeProviderInfo"
1779
- ],
1780
- "additionalProperties": false,
1781
- "description": "Debug mode configuration",
1782
- "patternProperties": {
1783
- "^x-": {}
1784
- }
1785
- },
1786
- "FileCommentOutput": {
1787
- "type": "object",
1788
- "properties": {
1789
- "enabled": {
1790
- "type": "boolean",
1791
- "description": "Whether file comments are enabled"
1792
- },
1793
- "inline": {
1794
- "type": "boolean",
1795
- "description": "Whether to show inline comments"
1796
- }
1797
- },
1798
- "required": [
1799
- "enabled",
1800
- "inline"
1801
- ],
1802
- "additionalProperties": false,
1803
- "description": "File comment output configuration",
1804
- "patternProperties": {
1805
- "^x-": {}
1806
- }
1807
- },
1808
- "GitHubCheckOutput": {
1809
- "type": "object",
1810
- "properties": {
1811
- "enabled": {
1812
- "type": "boolean",
1813
- "description": "Whether GitHub check runs are enabled"
1814
- },
1815
- "per_check": {
1816
- "type": "boolean",
1817
- "description": "Whether to create individual check runs per configured check"
1818
- },
1819
- "name_prefix": {
1820
- "type": "string",
1821
- "description": "Custom name prefix for check runs"
1822
- }
1823
- },
1824
- "required": [
1825
- "enabled",
1826
- "per_check"
1827
- ],
1828
- "additionalProperties": false,
1829
- "description": "GitHub Check Runs output configuration",
1830
- "patternProperties": {
1831
- "^x-": {}
1832
- }
1833
- },
1834
- "HttpServerConfig": {
1835
- "type": "object",
1836
- "properties": {
1837
- "enabled": {
1838
- "type": "boolean",
1839
- "description": "Whether HTTP server is enabled"
1840
- },
1841
- "port": {
1842
- "type": "number",
1843
- "description": "Port to listen on"
1844
- },
1845
- "host": {
1846
- "type": "string",
1847
- "description": "Host/IP to bind to (defaults to 0.0.0.0)"
1848
- },
1849
- "tls": {
1850
- "$ref": "#/definitions/TlsConfig",
1851
- "description": "TLS/SSL configuration for HTTPS"
1852
- },
1853
- "auth": {
1854
- "$ref": "#/definitions/HttpAuthConfig",
1855
- "description": "Authentication configuration"
1856
- },
1857
- "endpoints": {
1858
- "type": "array",
1859
- "items": {
1860
- "$ref": "#/definitions/HttpEndpointConfig"
1861
- },
1862
- "description": "HTTP endpoints configuration"
1863
- }
1864
- },
1865
- "required": [
1866
- "enabled",
1867
- "port"
1868
- ],
1869
- "additionalProperties": false,
1870
- "description": "HTTP server configuration for receiving webhooks",
1871
- "patternProperties": {
1872
- "^x-": {}
1873
- }
1874
- },
1875
- "TlsConfig": {
1876
- "type": "object",
1877
- "properties": {
1878
- "enabled": {
1879
- "type": "boolean",
1880
- "description": "Enable TLS/HTTPS"
1881
- },
1882
- "cert": {
1883
- "type": "string",
1884
- "description": "Path to TLS certificate file or certificate content"
1885
- },
1886
- "key": {
1887
- "type": "string",
1888
- "description": "Path to TLS key file or key content"
1889
- },
1890
- "ca": {
1891
- "type": "string",
1892
- "description": "Path to CA certificate file or CA content (optional)"
1893
- },
1894
- "rejectUnauthorized": {
1895
- "type": "boolean",
1896
- "description": "Reject unauthorized connections (default: true)"
1897
- }
1898
- },
1899
- "required": [
1900
- "enabled"
1901
- ],
1902
- "additionalProperties": false,
1903
- "description": "TLS/SSL configuration for HTTPS server",
1904
- "patternProperties": {
1905
- "^x-": {}
1906
- }
1907
- },
1908
- "HttpAuthConfig": {
1909
- "type": "object",
1910
- "properties": {
1911
- "type": {
1912
- "type": "string",
1913
- "enum": [
1914
- "bearer_token",
1915
- "hmac",
1916
- "basic",
1917
- "none"
1918
- ],
1919
- "description": "Authentication type"
1920
- },
1921
- "secret": {
1922
- "type": "string",
1923
- "description": "Secret or token for authentication"
1924
- },
1925
- "username": {
1926
- "type": "string",
1927
- "description": "Username for basic auth"
1928
- },
1929
- "password": {
1930
- "type": "string",
1931
- "description": "Password for basic auth"
1932
- }
1933
- },
1934
- "required": [
1935
- "type"
1936
- ],
1937
- "additionalProperties": false,
1938
- "description": "HTTP server authentication configuration",
1939
- "patternProperties": {
1940
- "^x-": {}
1941
- }
1942
- },
1943
- "HttpEndpointConfig": {
1944
- "type": "object",
1945
- "properties": {
1946
- "path": {
1947
- "type": "string",
1948
- "description": "Path for the webhook endpoint"
1949
- },
1950
- "transform": {
1951
- "type": "string",
1952
- "description": "Optional transform template (Liquid) for the received data"
1953
- },
1954
- "name": {
1955
- "type": "string",
1956
- "description": "Optional name/ID for this endpoint"
1957
- }
1958
- },
1959
- "required": [
1960
- "path"
1961
- ],
1962
- "additionalProperties": false,
1963
- "description": "HTTP server endpoint configuration",
1964
- "patternProperties": {
1965
- "^x-": {}
1966
- }
1967
- },
1968
- "MemoryConfig": {
1969
- "type": "object",
1970
- "properties": {
1971
- "storage": {
1972
- "type": "string",
1973
- "enum": [
1974
- "memory",
1975
- "file"
1976
- ],
1977
- "description": "Storage mode: \"memory\" (in-memory, default) or \"file\" (persistent)"
1978
- },
1979
- "format": {
1980
- "type": "string",
1981
- "enum": [
1982
- "json",
1983
- "csv"
1984
- ],
1985
- "description": "Storage format (only for file storage, default: json)"
1986
- },
1987
- "file": {
1988
- "type": "string",
1989
- "description": "File path (required if storage: file)"
1990
- },
1991
- "namespace": {
1992
- "type": "string",
1993
- "description": "Default namespace (default: \"default\")"
1994
- },
1995
- "auto_load": {
1996
- "type": "boolean",
1997
- "description": "Auto-load on startup (default: true if storage: file)"
1998
- },
1999
- "auto_save": {
2000
- "type": "boolean",
2001
- "description": "Auto-save after operations (default: true if storage: file)"
2002
- }
2003
- },
2004
- "additionalProperties": false,
2005
- "description": "Memory storage configuration",
2006
- "patternProperties": {
2007
- "^x-": {}
2008
- }
2009
- },
2010
- "TagFilter": {
2011
- "type": "object",
2012
- "properties": {
2013
- "include": {
2014
- "type": "array",
2015
- "items": {
2016
- "type": "string"
2017
- },
2018
- "description": "Tags that checks must have to be included (ANY match)"
2019
- },
2020
- "exclude": {
2021
- "type": "array",
2022
- "items": {
2023
- "type": "string"
2024
- },
2025
- "description": "Tags that will exclude checks if present (ANY match)"
2026
- }
2027
- },
2028
- "additionalProperties": false,
2029
- "description": "Tag filter configuration for selective check execution",
2030
- "patternProperties": {
2031
- "^x-": {}
2032
- }
2033
- },
2034
- "RoutingDefaults": {
2035
- "type": "object",
2036
- "properties": {
2037
- "max_loops": {
2038
- "type": "number",
2039
- "description": "Per-scope cap on routing transitions (success + failure)"
2040
- },
2041
- "defaults": {
2042
- "type": "object",
2043
- "properties": {
2044
- "on_fail": {
2045
- "$ref": "#/definitions/OnFailConfig"
2046
- }
2047
- },
2048
- "additionalProperties": false,
2049
- "description": "Default policies applied to checks (step-level overrides take precedence)",
2050
- "patternProperties": {
2051
- "^x-": {}
2052
- }
2053
- }
2054
- },
2055
- "additionalProperties": false,
2056
- "description": "Global routing defaults",
2057
- "patternProperties": {
2058
- "^x-": {}
2059
- }
2060
- },
2061
- "LimitsConfig": {
2062
- "type": "object",
2063
- "properties": {
2064
- "max_runs_per_check": {
2065
- "type": "number",
2066
- "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."
2067
- },
2068
- "max_workflow_depth": {
2069
- "type": "number",
2070
- "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."
2071
- }
2072
- },
2073
- "additionalProperties": false,
2074
- "description": "Global engine limits",
2075
- "patternProperties": {
2076
- "^x-": {}
2077
- }
2078
- },
2079
- "WorkspaceConfig": {
2080
- "type": "object",
2081
- "properties": {
2082
- "enabled": {
2083
- "type": "boolean",
2084
- "description": "Enable workspace isolation (default: true when config present)"
2085
- },
2086
- "base_path": {
2087
- "type": "string",
2088
- "description": "Base path for workspaces (default: /tmp/visor-workspaces)"
2089
- },
2090
- "name": {
2091
- "type": "string",
2092
- "description": "Workspace directory name (defaults to session id)"
2093
- },
2094
- "main_project_name": {
2095
- "type": "string",
2096
- "description": "Main project folder name inside the workspace (defaults to original directory name)"
2097
- },
2098
- "cleanup_on_exit": {
2099
- "type": "boolean",
2100
- "description": "Clean up workspace on exit (default: true)"
2101
- },
2102
- "include_main_project": {
2103
- "type": "boolean",
2104
- "description": "Include main project worktree in AI allowed folders (default: false)"
2105
- }
2106
- },
2107
- "additionalProperties": false,
2108
- "description": "Workspace isolation configuration",
2109
- "patternProperties": {
2110
- "^x-": {}
2111
- }
2112
- },
2113
- "SlackConfig": {
2114
- "type": "object",
2115
- "properties": {
2116
- "version": {
2117
- "type": "string",
2118
- "description": "Slack API version"
2119
- },
2120
- "mentions": {
2121
- "type": "string",
2122
- "description": "Mention handling: 'all', 'direct', etc."
2123
- },
2124
- "threads": {
2125
- "type": "string",
2126
- "description": "Thread handling: 'required', 'optional', etc."
2127
- },
2128
- "allow_bot_messages": {
2129
- "type": "boolean",
2130
- "description": "Allow bot_message events to trigger runs (default: false)"
2131
- },
2132
- "show_raw_output": {
2133
- "type": "boolean",
2134
- "description": "Show raw output in Slack responses"
2135
- },
2136
- "telemetry": {
2137
- "$ref": "#/definitions/SlackTelemetryConfig",
2138
- "description": "Append telemetry identifiers to Slack replies."
2139
- }
2140
- },
2141
- "additionalProperties": false,
2142
- "description": "Slack configuration",
2143
- "patternProperties": {
2144
- "^x-": {}
2145
- }
2146
- },
2147
- "SlackTelemetryConfig": {
2148
- "type": "object",
2149
- "properties": {
2150
- "enabled": {
2151
- "type": "boolean",
2152
- "description": "Enable telemetry ID suffix in Slack messages"
2153
- }
2154
- },
2155
- "additionalProperties": false,
2156
- "patternProperties": {
2157
- "^x-": {}
2158
- }
2159
- }
2160
- }
2161
- }