@probelabs/visor 0.1.106 → 0.1.107

package/dist/generated/config-schema.json

@@ -1,10 +1,14 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$ref": "#/definitions/VisorConfig",
+  "$ref": "#/definitions/VisorConfigSchema",
   "definitions": {
-    "VisorConfig": {
+    "VisorConfigSchema": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
+        "hooks": {
+          "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
+        },
         "version": {
           "type": "string",
           "description": "Configuration version"
@@ -23,6 +27,31 @@
           ],
           "description": "Extends from other configurations - can be file path, HTTP(S) URL, or \"default\""
         },
+        "include": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Alias for extends - include from other configurations (backward compatibility)"
+        },
+        "tools": {
+          "$ref": "#/definitions/Record%3Cstring%2CCustomToolDefinition%3E",
+          "description": "Custom tool definitions that can be used in MCP blocks"
+        },
+        "imports": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Import workflow definitions from external files or URLs"
+        },
         "steps": {
           "$ref": "#/definitions/Record%3Cstring%2CCheckConfig%3E",
           "description": "Step configurations (recommended)"
@@ -82,18 +111,143 @@
         "routing": {
           "$ref": "#/definitions/RoutingDefaults",
           "description": "Optional routing defaults for retry/goto/run policies"
+        },
+        "limits": {
+          "$ref": "#/definitions/LimitsConfig",
+          "description": "Global execution limits"
+        },
+        "frontends": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Frontend name, e.g., 'ndjson-sink', 'github'"
+              },
+              "config": {
+                "description": "Frontend-specific configuration"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Optional integrations: event-driven frontends (e.g., ndjson-sink, github)"
         }
       },
       "required": [
-        "version",
-        "output"
+        "output",
+        "version"
+      ],
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
+    "Record<string,unknown>": {
+      "type": "object",
+      "additionalProperties": {}
+    },
+    "Record<string,CustomToolDefinition>": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/CustomToolDefinition"
+      }
+    },
+    "CustomToolDefinition": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tool name - used to reference the tool in MCP blocks"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of what the tool does"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "object"
+            },
+            "properties": {
+              "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E"
+            },
+            "required": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "additionalProperties": false,
+          "description": "Input schema for the tool (JSON Schema format)",
+          "patternProperties": {
+            "^x-": {}
+          }
+        },
+        "exec": {
+          "type": "string",
+          "description": "Command to execute - supports Liquid template"
+        },
+        "stdin": {
+          "type": "string",
+          "description": "Optional stdin input - supports Liquid template"
+        },
+        "transform": {
+          "type": "string",
+          "description": "Transform the raw output - supports Liquid template"
+        },
+        "transform_js": {
+          "type": "string",
+          "description": "Transform the output using JavaScript - alternative to transform"
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Working directory for command execution"
+        },
+        "env": {
+          "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
+          "description": "Environment variables for the command"
+        },
+        "timeout": {
+          "type": "number",
+          "description": "Timeout in milliseconds"
+        },
+        "parseJson": {
+          "type": "boolean",
+          "description": "Whether to parse output as JSON automatically"
+        },
+        "outputSchema": {
+          "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
+          "description": "Expected output schema for validation"
+        }
+      },
+      "required": [
+        "name",
+        "exec"
       ],
       "additionalProperties": false,
-      "description": "Main Visor configuration",
+      "description": "Custom tool definition for use in MCP blocks",
       "patternProperties": {
         "^x-": {}
       }
     },
+    "Record<string,string>": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
     "Record<string,CheckConfig>": {
       "type": "object",
       "additionalProperties": {
@@ -151,6 +305,10 @@
           "type": "string",
           "description": "Transform using JavaScript expressions (evaluated in secure sandbox) - optional"
         },
+        "content": {
+          "type": "string",
+          "description": "Script content to execute for script checks"
+        },
         "schedule": {
           "type": "string",
           "description": "Cron schedule expression (e.g., \"0 2 * * *\") - optional for any check type"
@@ -189,6 +347,22 @@
           "type": "string",
           "description": "AI provider to use for this check - overrides global setting"
         },
+        "ai_persona": {
+          "type": "string",
+          "description": "Optional persona hint, prepended to the prompt as 'Persona: <value>'"
+        },
+        "ai_prompt_type": {
+          "type": "string",
+          "description": "Probe promptType for this check (underscore style)"
+        },
+        "ai_system_prompt": {
+          "type": "string",
+          "description": "System prompt for this check (underscore style)"
+        },
+        "ai_custom_prompt": {
+          "type": "string",
+          "description": "Legacy customPrompt (underscore style) — deprecated, use ai_system_prompt"
+        },
         "ai_mcp_servers": {
           "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
           "description": "MCP servers for this AI check - overrides global setting"
@@ -227,6 +401,10 @@
           ],
           "description": "Schema type for template rendering (e.g., \"code-review\", \"markdown\") or inline JSON schema object - optional"
         },
+        "output_schema": {
+          "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
+          "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."
+        },
         "template": {
           "$ref": "#/definitions/CustomTemplateConfig",
           "description": "Custom template configuration - optional"
@@ -265,10 +443,36 @@
           },
           "description": "Tags for categorizing and filtering checks (e.g., [\"local\", \"fast\", \"security\"])"
         },
+        "criticality": {
+          "type": "string",
+          "enum": [
+            "external",
+            "internal",
+            "policy",
+            "info"
+          ],
+          "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."
+        },
+        "continue_on_failure": {
+          "type": "boolean",
+          "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."
+        },
         "forEach": {
           "type": "boolean",
           "description": "Process output as array and run dependent checks for each item"
         },
+        "fanout": {
+          "type": "string",
+          "enum": [
+            "map",
+            "reduce"
+          ],
+          "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."
+        },
+        "reduce": {
+          "type": "boolean",
+          "description": "Alias for fanout: 'reduce'"
+        },
         "on_fail": {
           "$ref": "#/definitions/OnFailConfig",
           "description": "Failure routing configuration for this check (retry/goto/run)"
@@ -277,6 +481,42 @@
           "$ref": "#/definitions/OnSuccessConfig",
           "description": "Success routing configuration for this check (post-actions and optional goto)"
         },
+        "on_finish": {
+          "$ref": "#/definitions/OnFinishConfig",
+          "description": "Finish routing configuration for forEach checks (runs after ALL iterations complete)"
+        },
+        "assume": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Preconditions that must hold before executing the check. If any expression evaluates to false, the check is skipped (skipReason='assume')."
+        },
+        "guarantee": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "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\"."
+        },
+        "max_runs": {
+          "type": "number",
+          "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."
+        },
         "message": {
           "type": "string",
           "description": "Message template for log checks"
@@ -303,6 +543,14 @@
           "type": "boolean",
           "description": "Include execution metadata in log output"
         },
+        "output_format": {
+          "type": "string",
+          "enum": [
+            "json",
+            "text"
+          ],
+          "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."
+        },
         "operation": {
           "type": "string",
           "enum": [
@@ -312,10 +560,9 @@
             "increment",
             "delete",
             "clear",
-            "list",
-            "exec_js"
+            "list"
           ],
-          "description": "Memory operation to perform"
+          "description": "Memory operation to perform. Use `type: 'script'` for custom JavaScript."
         },
         "key": {
           "type": "string",
@@ -328,10 +575,6 @@
           "type": "string",
           "description": "JavaScript expression to compute value dynamically"
         },
-        "memory_js": {
-          "type": "string",
-          "description": "JavaScript code for exec_js operation with full memory access"
-        },
         "namespace": {
           "type": "string",
           "description": "Override namespace for this check"
@@ -375,7 +618,7 @@
           "type": "string",
           "description": "Session ID for HTTP transport (optional, server may generate one)"
         },
-        "args": {
+        "command_args": {
           "type": "array",
           "items": {
             "type": "string"
@@ -385,6 +628,38 @@
         "workingDirectory": {
           "type": "string",
           "description": "Working directory (for stdio transport in MCP checks)"
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder text to show in input field"
+        },
+        "allow_empty": {
+          "type": "boolean",
+          "description": "Allow empty input (default: false)"
+        },
+        "multiline": {
+          "type": "boolean",
+          "description": "Support multiline input (default: false)"
+        },
+        "default": {
+          "type": "string",
+          "description": "Default value if timeout occurs or empty input when allow_empty is true"
+        },
+        "workflow": {
+          "type": "string",
+          "description": "Workflow ID or path to workflow file"
+        },
+        "args": {
+          "$ref": "#/definitions/Record%3Cstring%2Cunknown%3E",
+          "description": "Arguments/inputs for the workflow"
+        },
+        "overrides": {
+          "$ref": "#/definitions/Record%3Cstring%2CPartial%3Cinterface-src_types_config.ts-10692-20779-src_types_config.ts-0-34222%3E%3E",
+          "description": "Override specific step configurations in the workflow"
+        },
+        "output_mapping": {
+          "$ref": "#/definitions/Record%3Cstring%2Cstring%3E",
+          "description": "Map workflow outputs to check outputs"
         }
       },
       "additionalProperties": false,
@@ -398,6 +673,7 @@
       "enum": [
         "ai",
         "command",
+        "script",
         "http",
         "http_input",
         "http_client",
@@ -407,16 +683,11 @@
         "github",
         "claude-code",
         "mcp",
-        "human-input"
+        "human-input",
+        "workflow"
       ],
       "description": "Valid check types in configuration"
     },
-    "Record<string,string>": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "string"
-      }
-    },
     "EventTrigger": {
       "type": "string",
       "enum": [
@@ -461,9 +732,60 @@
           "type": "boolean",
           "description": "Enable debug mode"
         },
+        "prompt_type": {
+          "type": "string",
+          "description": "Probe promptType to use (e.g., engineer, code-review, architect)"
+        },
+        "system_prompt": {
+          "type": "string",
+          "description": "System prompt (baseline preamble). Replaces legacy custom_prompt."
+        },
+        "custom_prompt": {
+          "type": "string",
+          "description": "Probe customPrompt (baseline/system prompt) — deprecated, use system_prompt"
+        },
+        "skip_code_context": {
+          "type": "boolean",
+          "description": "Skip adding code context (diffs, files, PR info) to the prompt"
+        },
         "mcpServers": {
           "$ref": "#/definitions/Record%3Cstring%2CMcpServerConfig%3E",
           "description": "MCP servers configuration"
+        },
+        "enableDelegate": {
+          "type": "boolean",
+          "description": "Enable the delegate tool for task distribution to subagents"
+        },
+        "retry": {
+          "$ref": "#/definitions/AIRetryConfig",
+          "description": "Retry configuration for this provider"
+        },
+        "fallback": {
+          "$ref": "#/definitions/AIFallbackConfig",
+          "description": "Fallback configuration for provider failures"
+        },
+        "allowEdit": {
+          "type": "boolean",
+          "description": "Enable Edit and Create tools for file modification (disabled by default for security)"
+        },
+        "allowedTools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Filter allowed tools - supports whitelist, exclusion (!prefix), or raw AI mode (empty array)"
+        },
+        "disableTools": {
+          "type": "boolean",
+          "description": "Disable all tools for raw AI mode (alternative to allowedTools: [])"
+        },
+        "allowBash": {
+          "type": "boolean",
+          "description": "Enable bash command execution (shorthand for bashConfig.enabled)"
+        },
+        "bashConfig": {
+          "$ref": "#/definitions/BashConfig",
+          "description": "Advanced bash command execution configuration"
         }
       },
       "additionalProperties": false,
@@ -506,6 +828,162 @@
         "^x-": {}
       }
     },
+    "AIRetryConfig": {
+      "type": "object",
+      "properties": {
+        "maxRetries": {
+          "type": "number",
+          "description": "Maximum retry attempts (0-50)"
+        },
+        "initialDelay": {
+          "type": "number",
+          "description": "Initial delay in milliseconds (0-60000)"
+        },
+        "maxDelay": {
+          "type": "number",
+          "description": "Maximum delay cap in milliseconds (0-300000)"
+        },
+        "backoffFactor": {
+          "type": "number",
+          "description": "Exponential backoff multiplier (1-10)"
+        },
+        "retryableErrors": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Custom error patterns to retry on"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Retry configuration for AI provider calls",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
+    "AIFallbackConfig": {
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "same-model",
+            "same-provider",
+            "any",
+            "custom"
+          ],
+          "description": "Fallback strategy: 'same-model', 'same-provider', 'any', or 'custom'"
+        },
+        "providers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AIFallbackProviderConfig"
+          },
+          "description": "Array of fallback provider configurations"
+        },
+        "maxTotalAttempts": {
+          "type": "number",
+          "description": "Maximum total attempts across all providers"
+        },
+        "auto": {
+          "type": "boolean",
+          "description": "Enable automatic fallback using available environment variables"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Fallback configuration for AI providers",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
+    "AIFallbackProviderConfig": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": [
+            "google",
+            "anthropic",
+            "openai",
+            "bedrock"
+          ],
+          "description": "AI provider to use"
+        },
+        "model": {
+          "type": "string",
+          "description": "Model name to use"
+        },
+        "apiKey": {
+          "type": "string",
+          "description": "API key for this provider"
+        },
+        "maxRetries": {
+          "type": "number",
+          "description": "Per-provider retry override"
+        },
+        "region": {
+          "type": "string",
+          "description": "AWS region (for Bedrock)"
+        },
+        "accessKeyId": {
+          "type": "string",
+          "description": "AWS access key ID (for Bedrock)"
+        },
+        "secretAccessKey": {
+          "type": "string",
+          "description": "AWS secret access key (for Bedrock)"
+        }
+      },
+      "required": [
+        "provider",
+        "model"
+      ],
+      "additionalProperties": false,
+      "description": "Fallback provider configuration",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
+    "BashConfig": {
+      "type": "object",
+      "properties": {
+        "allow": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of permitted command patterns (e.g., ['ls', 'git status'])"
+        },
+        "deny": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Array of blocked command patterns (e.g., ['rm -rf', 'sudo'])"
+        },
+        "noDefaultAllow": {
+          "type": "boolean",
+          "description": "Disable default safe command list (use with caution)"
+        },
+        "noDefaultDeny": {
+          "type": "boolean",
+          "description": "Disable default dangerous command blocklist (use with extreme caution)"
+        },
+        "timeout": {
+          "type": "number",
+          "description": "Execution timeout in milliseconds"
+        },
+        "workingDirectory": {
+          "type": "string",
+          "description": "Default working directory for command execution"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Bash command execution configuration for ProbeAgent Note: Use 'allowBash: true' in AIProviderConfig to enable bash execution",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
     "ClaudeCodeConfig": {
       "type": "object",
       "properties": {
@@ -532,6 +1010,10 @@
           "type": "string",
           "description": "Path to subagent script"
         },
+        "enableDelegate": {
+          "type": "boolean",
+          "description": "Enable the delegate tool for task distribution to subagents"
+        },
         "hooks": {
           "type": "object",
           "properties": {
@@ -572,10 +1054,6 @@
       },
       "description": "Environment variable reference configuration"
     },
-    "Record<string,unknown>": {
-      "type": "object",
-      "additionalProperties": {}
-    },
     "CustomTemplateConfig": {
       "type": "object",
       "properties": {
@@ -683,6 +1161,13 @@
         "run_js": {
           "type": "string",
           "description": "Dynamic remediation list: JS expression returning string[]"
+        },
+        "transitions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransitionRule"
+          },
+          "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."
         }
       },
       "additionalProperties": false,
@@ -731,6 +1216,34 @@
         "^x-": {}
       }
     },
+    "TransitionRule": {
+      "type": "object",
+      "properties": {
+        "when": {
+          "type": "string",
+          "description": "JavaScript expression evaluated in the same sandbox as goto_js; truthy enables the rule."
+        },
+        "to": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Target step ID, or null to explicitly prevent goto."
+        },
+        "goto_event": {
+          "$ref": "#/definitions/EventTrigger",
+          "description": "Optional event override when performing goto."
+        }
+      },
+      "required": [
+        "when"
+      ],
+      "additionalProperties": false,
+      "description": "Declarative transition rule for on_* blocks.",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
     "OnSuccessConfig": {
       "type": "object",
       "properties": {
@@ -756,6 +1269,13 @@
         "run_js": {
           "type": "string",
           "description": "Dynamic post-success steps: JS expression returning string[]"
+        },
+        "transitions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransitionRule"
+          },
+          "description": "Declarative transitions (see OnFailConfig.transitions)."
         }
       },
       "additionalProperties": false,
@@ -764,6 +1284,56 @@
         "^x-": {}
       }
     },
+    "OnFinishConfig": {
+      "type": "object",
+      "properties": {
+        "run": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Post-finish steps to run"
+        },
+        "goto": {
+          "type": "string",
+          "description": "Optional jump back to ancestor step (by id)"
+        },
+        "goto_event": {
+          "$ref": "#/definitions/EventTrigger",
+          "description": "Simulate a different event when performing goto (e.g., 'pr_updated')"
+        },
+        "goto_js": {
+          "type": "string",
+          "description": "Dynamic goto: JS expression returning step id or null"
+        },
+        "run_js": {
+          "type": "string",
+          "description": "Dynamic post-finish steps: JS expression returning string[]"
+        },
+        "transitions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TransitionRule"
+          },
+          "description": "Declarative transitions (see OnFailConfig.transitions)."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Finish routing configuration for forEach checks Runs once after ALL iterations of forEach and ALL dependent checks complete",
+      "patternProperties": {
+        "^x-": {}
+      }
+    },
+    "Record<string,Partial<interface-src_types_config.ts-10692-20779-src_types_config.ts-0-34222>>": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/Partial%3Cinterface-src_types_config.ts-10692-20779-src_types_config.ts-0-34222%3E"
+      }
+    },
+    "Partial<interface-src_types_config.ts-10692-20779-src_types_config.ts-0-34222>": {
+      "type": "object",
+      "additionalProperties": false
+    },
     "OutputConfig": {
       "type": "object",
       "properties": {
@@ -1155,6 +1725,24 @@
       "patternProperties": {
         "^x-": {}
       }
+    },
+    "LimitsConfig": {
+      "type": "object",
+      "properties": {
+        "max_runs_per_check": {
+          "type": "number",
+          "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."
+        },
+        "max_workflow_depth": {
+          "type": "number",
+          "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."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Global engine limits",
+      "patternProperties": {
+        "^x-": {}
+      }
     }
   }
 }