@probelabs/visor 0.1.107 → 0.1.112

package/dist/sdk/{routing-RP56JTV2.mjs → routing-6N45MJ4F.mjs}

@@ -4,14 +4,15 @@ import {
   evaluateTransitions,
   handleRouting,
   init_routing
-} from "./chunk-IEO6CFLG.mjs";
-import "./chunk-OZJ263FM.mjs";
-import "./chunk-CNX7V5JK.mjs";
+} from "./chunk-AIVFBIS4.mjs";
+import "./chunk-SIWNBRTK.mjs";
+import "./chunk-BOVFH3LI.mjs";
 import "./chunk-ZYAUYXSW.mjs";
 import "./chunk-S2RUE2RG.mjs";
+import "./chunk-CNX7V5JK.mjs";
+import "./chunk-7UK3NIIT.mjs";
+import "./chunk-AGIZJ4UZ.mjs";
 import "./chunk-YSN4G6CI.mjs";
-import "./chunk-37ZSCMFC.mjs";
-import "./chunk-VMPLF6FT.mjs";
 import "./chunk-WMJKH4XE.mjs";
 init_routing();
 export {
@@ -20,4 +21,4 @@ export {
   evaluateTransitions,
   handleRouting
 };
-//# sourceMappingURL=routing-RP56JTV2.mjs.map
+//# sourceMappingURL=routing-6N45MJ4F.mjs.map

package/dist/sdk/sdk.d.mts

@@ -120,7 +120,7 @@ interface FailureConditionResult {
 /**
  * Valid check types in configuration
  */
-type ConfigCheckType = 'ai' | 'command' | 'script' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp' | 'human-input' | 'workflow';
+type ConfigCheckType = 'ai' | 'command' | 'script' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp' | 'human-input' | 'workflow' | 'git-checkout';
 /**
  * Valid event triggers for checks
  */
@@ -235,6 +235,15 @@ interface AIProviderConfig {
     custom_prompt?: string;
     /** Skip adding code context (diffs, files, PR info) to the prompt */
     skip_code_context?: boolean;
+    /** Skip adding Slack conversation context to the prompt (when running under Slack) */
+    skip_slack_context?: boolean;
+    /**
+     * 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.
+     */
+    skip_transport_context?: boolean;
     /** MCP servers configuration */
     mcpServers?: Record<string, McpServerConfig>;
     /** Enable the delegate tool for task distribution to subagents */
@@ -253,6 +262,8 @@ interface AIProviderConfig {
     allowBash?: boolean;
     /** Advanced bash command execution configuration */
     bashConfig?: BashConfig;
+    /** Completion prompt for post-completion validation/review (runs after attempt_completion) */
+    completion_prompt?: string;
 }
 /**
  * MCP Server configuration
@@ -347,14 +358,16 @@ interface CheckConfig {
     ai_custom_prompt?: string;
     /** MCP servers for this AI check - overrides global setting */
     ai_mcp_servers?: Record<string, McpServerConfig>;
+    /** List of custom tool names to expose to this AI check via ephemeral SSE MCP server */
+    ai_custom_tools?: string[];
     /** Claude Code configuration (for claude-code type checks) */
     claude_code?: ClaudeCodeConfig;
     /** Environment variables for this check */
     env?: EnvConfig;
     /** Timeout in seconds for command execution (default: 60) */
     timeout?: number;
-    /** Check IDs that this check depends on (optional) */
-    depends_on?: string[];
+    /** Check IDs that this check depends on (optional). Accepts single string or array. */
+    depends_on?: string | string[];
     /** Group name for comment separation (e.g., "code-review", "pr-overview") - optional */
     group?: string;
     /** Schema type for template rendering (e.g., "code-review", "markdown") or inline JSON schema object - optional */
@@ -409,6 +422,8 @@ interface CheckConfig {
     fanout?: 'map' | 'reduce';
     /** Alias for fanout: 'reduce' */
     reduce?: boolean;
+    /** Init routing configuration for this check (runs before execution/preprocessing) */
+    on_init?: OnInitConfig;
     /** Failure routing configuration for this check (retry/goto/run) */
     on_fail?: OnFailConfig;
     /** Success routing configuration for this check (post-actions and optional goto) */
@@ -510,6 +525,43 @@ interface CheckConfig {
     overrides?: Record<string, Partial<CheckConfig>>;
     /** Map workflow outputs to check outputs */
     output_mapping?: Record<string, string>;
+    /** Alias for args - workflow inputs (backward compatibility) */
+    workflow_inputs?: Record<string, unknown>;
+    /** Config file path - alternative to workflow ID (loads a Visor config file as workflow) */
+    config?: string;
+    /** Alias for overrides - workflow step overrides (backward compatibility) */
+    workflow_overrides?: Record<string, Partial<CheckConfig>>;
+    /**
+     * Git-checkout provider specific options (optional, only used when type === 'git-checkout').
+     */
+    /** Git reference to checkout (branch, tag, commit SHA) - supports templates */
+    ref?: string;
+    /** Repository URL or owner/repo format (defaults to current repository) */
+    repository?: string;
+    /** GitHub token for private repositories (defaults to GITHUB_TOKEN env) */
+    token?: string;
+    /** Number of commits to fetch (0 for full history, default: 1) */
+    fetch_depth?: number;
+    /** Whether to fetch tags (default: false) */
+    fetch_tags?: boolean;
+    /** Checkout submodules: false, true, or 'recursive' */
+    submodules?: boolean | 'recursive';
+    /** Working directory for the checkout (defaults to temp directory) */
+    working_directory?: string;
+    /** Use git worktree for efficient parallel checkouts (default: true) */
+    use_worktree?: boolean;
+    /** Clean the working directory before checkout (default: true) */
+    clean?: boolean;
+    /** Sparse checkout paths - only checkout specific directories/files */
+    sparse_checkout?: string[];
+    /** Enable Git LFS (Large File Storage) */
+    lfs?: boolean;
+    /** Timeout in ms for cloning the bare repository (default: 300000 = 5 min) */
+    clone_timeout_ms?: number;
+    /** Clean up worktree on failure (default: true) */
+    cleanup_on_failure?: boolean;
+    /** Keep worktree after workflow completion (default: false) */
+    persist_worktree?: boolean;
 }
 /**
  * Backoff policy for retries
@@ -587,6 +639,59 @@ interface OnFinishConfig {
     /** Declarative transitions (see OnFailConfig.transitions). */
     transitions?: TransitionRule[];
 }
+/**
+ * Init routing configuration per check
+ * Runs BEFORE the check executes (preprocessing/setup)
+ */
+interface OnInitConfig {
+    /** Items to run before this check executes */
+    run?: OnInitRunItem[];
+    /** Dynamic init items: JS expression returning OnInitRunItem[] */
+    run_js?: string;
+    /** Declarative transitions (optional, for advanced use cases) */
+    transitions?: TransitionRule[];
+}
+/**
+ * Unified on_init run item - can be tool, step, workflow, or plain string
+ */
+type OnInitRunItem = OnInitToolInvocation | OnInitStepInvocation | OnInitWorkflowInvocation | string;
+/**
+ * Invoke a custom tool (from tools: section)
+ */
+interface OnInitToolInvocation {
+    /** Tool name (must exist in tools: section) */
+    tool: string;
+    /** Arguments to pass to the tool (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to tool name) */
+    as?: string;
+}
+/**
+ * Invoke a helper step (regular check)
+ */
+interface OnInitStepInvocation {
+    /** Step name (must exist in steps: section) */
+    step: string;
+    /** Arguments to pass to the step (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to step name) */
+    as?: string;
+}
+/**
+ * Invoke a reusable workflow
+ */
+interface OnInitWorkflowInvocation {
+    /** Workflow ID or path */
+    workflow: string;
+    /** Workflow inputs (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to workflow name) */
+    as?: string;
+    /** Step overrides */
+    overrides?: Record<string, Partial<CheckConfig>>;
+    /** Output mapping */
+    output_mapping?: Record<string, string>;
+}
 /**
  * Declarative transition rule for on_* blocks.
  */
@@ -654,6 +759,8 @@ interface DebugConfig {
  * PR comment output configuration
  */
 interface PrCommentOutput {
+    /** Whether PR comments are enabled */
+    enabled?: boolean;
     /** Format of the output */
     format: ConfigOutputFormat;
     /** How to group the results */
@@ -829,6 +936,34 @@ interface CustomToolDefinition {
     /** Expected output schema for validation */
     outputSchema?: Record<string, unknown>;
 }
+/**
+ * Workflow input definition for standalone reusable workflows
+ */
+interface WorkflowInput {
+    /** Input parameter name */
+    name: string;
+    /** JSON Schema for the input */
+    schema?: Record<string, unknown>;
+    /** Whether this input is required */
+    required?: boolean;
+    /** Default value if not provided */
+    default?: unknown;
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * Workflow output definition for standalone reusable workflows
+ */
+interface WorkflowOutput {
+    /** Output name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Value using Liquid template syntax (references step outputs) */
+    value?: string;
+    /** Value using JavaScript expression (alternative to value) */
+    value_js?: string;
+}
 /**
  * Main Visor configuration
  */
@@ -843,12 +978,16 @@ interface VisorConfig {
     tools?: Record<string, CustomToolDefinition>;
     /** Import workflow definitions from external files or URLs */
     imports?: string[];
+    /** Workflow inputs (for standalone reusable workflows) */
+    inputs?: WorkflowInput[];
+    /** Workflow outputs (for standalone reusable workflows) */
+    outputs?: WorkflowOutput[];
     /** Step configurations (recommended) */
     steps?: Record<string, CheckConfig>;
     /** Check configurations (legacy, use 'steps' instead) - always populated after normalization */
     checks?: Record<string, CheckConfig>;
-    /** Output configuration */
-    output: OutputConfig;
+    /** Output configuration (optional - defaults provided) */
+    output?: OutputConfig;
     /** HTTP server configuration for receiving webhooks */
     http_server?: HttpServerConfig;
     /** Memory storage configuration */
@@ -884,6 +1023,42 @@ interface VisorConfig {
         /** Frontend-specific configuration */
         config?: unknown;
     }>;
+    /** Workspace isolation configuration for sandboxed execution */
+    workspace?: WorkspaceConfig;
+    /** Slack configuration */
+    slack?: SlackConfig;
+}
+/**
+ * Workspace isolation configuration
+ */
+interface WorkspaceConfig {
+    /** Enable workspace isolation (default: true when config present) */
+    enabled?: boolean;
+    /** Base path for workspaces (default: /tmp/visor-workspaces) */
+    base_path?: string;
+    /** Clean up workspace on exit (default: true) */
+    cleanup_on_exit?: boolean;
+}
+/**
+ * Slack configuration
+ */
+interface SlackConfig {
+    /** Slack API version */
+    version?: string;
+    /** Mention handling: 'all', 'direct', etc. */
+    mentions?: string;
+    /** Thread handling: 'required', 'optional', etc. */
+    threads?: string;
+    /** Show raw output in Slack responses */
+    show_raw_output?: boolean;
+    /**
+     * Append telemetry identifiers to Slack replies.
+     */
+    telemetry?: SlackTelemetryConfig;
+}
+interface SlackTelemetryConfig {
+    /** Enable telemetry ID suffix in Slack messages */
+    enabled?: boolean;
 }
 
 /**
@@ -975,6 +1150,36 @@ interface DebugInfo {
     }>;
 }
 
+interface EventEnvelope<T = any> {
+    id: string;
+    version: 1;
+    timestamp: string;
+    runId: string;
+    workflowId?: string;
+    caseId?: string;
+    wave?: number;
+    attempt?: number;
+    checkId?: string;
+    traceId?: string;
+    spanId?: string;
+    causationId?: string;
+    correlationId?: string;
+    payload: T;
+}
+type AnyEvent = any;
+
+type EventHandler<T = AnyEvent> = (event: T | EventEnvelope<T>) => void | Promise<void>;
+interface Subscription {
+    unsubscribe(): void;
+}
+declare class EventBus {
+    private handlers;
+    private anyHandlers;
+    on<T = AnyEvent>(eventType: string, handler: EventHandler<T>): Subscription;
+    onAny(handler: EventHandler): Subscription;
+    emit(event: AnyEvent | EventEnvelope): Promise<void>;
+}
+
 /**
  * Execution context passed to check providers
  */
@@ -994,6 +1199,8 @@ interface ExecutionContext {
     stageHistoryBase?: Record<string, number>;
     /** Workflow inputs - available when executing within a workflow */
     workflowInputs?: Record<string, unknown>;
+    /** Custom arguments passed from on_init 'with' directive */
+    args?: Record<string, unknown>;
     /** SDK hooks for human input */
     hooks?: {
         onHumanInput?: (request: HumanInputRequest) => Promise<string>;
@@ -1018,6 +1225,13 @@ interface ExecutionContext {
         /** reset per-run guard state before grouped execution */
         resetPerRunState?: boolean;
     };
+    /** Optional event bus for emitting integration events (e.g., HumanInputRequested) */
+    eventBus?: EventBus;
+    /** Optional webhook context (e.g., Slack Events API payload) */
+    webhookContext?: {
+        webhookData?: Map<string, unknown>;
+        eventType?: string;
+    };
 }
 
 interface VisorOptions {

package/dist/sdk/sdk.d.ts

@@ -120,7 +120,7 @@ interface FailureConditionResult {
 /**
  * Valid check types in configuration
  */
-type ConfigCheckType = 'ai' | 'command' | 'script' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp' | 'human-input' | 'workflow';
+type ConfigCheckType = 'ai' | 'command' | 'script' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp' | 'human-input' | 'workflow' | 'git-checkout';
 /**
  * Valid event triggers for checks
  */
@@ -235,6 +235,15 @@ interface AIProviderConfig {
     custom_prompt?: string;
     /** Skip adding code context (diffs, files, PR info) to the prompt */
     skip_code_context?: boolean;
+    /** Skip adding Slack conversation context to the prompt (when running under Slack) */
+    skip_slack_context?: boolean;
+    /**
+     * 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.
+     */
+    skip_transport_context?: boolean;
     /** MCP servers configuration */
     mcpServers?: Record<string, McpServerConfig>;
     /** Enable the delegate tool for task distribution to subagents */
@@ -253,6 +262,8 @@ interface AIProviderConfig {
     allowBash?: boolean;
     /** Advanced bash command execution configuration */
     bashConfig?: BashConfig;
+    /** Completion prompt for post-completion validation/review (runs after attempt_completion) */
+    completion_prompt?: string;
 }
 /**
  * MCP Server configuration
@@ -347,14 +358,16 @@ interface CheckConfig {
     ai_custom_prompt?: string;
     /** MCP servers for this AI check - overrides global setting */
     ai_mcp_servers?: Record<string, McpServerConfig>;
+    /** List of custom tool names to expose to this AI check via ephemeral SSE MCP server */
+    ai_custom_tools?: string[];
     /** Claude Code configuration (for claude-code type checks) */
     claude_code?: ClaudeCodeConfig;
     /** Environment variables for this check */
     env?: EnvConfig;
     /** Timeout in seconds for command execution (default: 60) */
     timeout?: number;
-    /** Check IDs that this check depends on (optional) */
-    depends_on?: string[];
+    /** Check IDs that this check depends on (optional). Accepts single string or array. */
+    depends_on?: string | string[];
     /** Group name for comment separation (e.g., "code-review", "pr-overview") - optional */
     group?: string;
     /** Schema type for template rendering (e.g., "code-review", "markdown") or inline JSON schema object - optional */
@@ -409,6 +422,8 @@ interface CheckConfig {
     fanout?: 'map' | 'reduce';
     /** Alias for fanout: 'reduce' */
     reduce?: boolean;
+    /** Init routing configuration for this check (runs before execution/preprocessing) */
+    on_init?: OnInitConfig;
     /** Failure routing configuration for this check (retry/goto/run) */
     on_fail?: OnFailConfig;
     /** Success routing configuration for this check (post-actions and optional goto) */
@@ -510,6 +525,43 @@ interface CheckConfig {
     overrides?: Record<string, Partial<CheckConfig>>;
     /** Map workflow outputs to check outputs */
     output_mapping?: Record<string, string>;
+    /** Alias for args - workflow inputs (backward compatibility) */
+    workflow_inputs?: Record<string, unknown>;
+    /** Config file path - alternative to workflow ID (loads a Visor config file as workflow) */
+    config?: string;
+    /** Alias for overrides - workflow step overrides (backward compatibility) */
+    workflow_overrides?: Record<string, Partial<CheckConfig>>;
+    /**
+     * Git-checkout provider specific options (optional, only used when type === 'git-checkout').
+     */
+    /** Git reference to checkout (branch, tag, commit SHA) - supports templates */
+    ref?: string;
+    /** Repository URL or owner/repo format (defaults to current repository) */
+    repository?: string;
+    /** GitHub token for private repositories (defaults to GITHUB_TOKEN env) */
+    token?: string;
+    /** Number of commits to fetch (0 for full history, default: 1) */
+    fetch_depth?: number;
+    /** Whether to fetch tags (default: false) */
+    fetch_tags?: boolean;
+    /** Checkout submodules: false, true, or 'recursive' */
+    submodules?: boolean | 'recursive';
+    /** Working directory for the checkout (defaults to temp directory) */
+    working_directory?: string;
+    /** Use git worktree for efficient parallel checkouts (default: true) */
+    use_worktree?: boolean;
+    /** Clean the working directory before checkout (default: true) */
+    clean?: boolean;
+    /** Sparse checkout paths - only checkout specific directories/files */
+    sparse_checkout?: string[];
+    /** Enable Git LFS (Large File Storage) */
+    lfs?: boolean;
+    /** Timeout in ms for cloning the bare repository (default: 300000 = 5 min) */
+    clone_timeout_ms?: number;
+    /** Clean up worktree on failure (default: true) */
+    cleanup_on_failure?: boolean;
+    /** Keep worktree after workflow completion (default: false) */
+    persist_worktree?: boolean;
 }
 /**
  * Backoff policy for retries
@@ -587,6 +639,59 @@ interface OnFinishConfig {
     /** Declarative transitions (see OnFailConfig.transitions). */
     transitions?: TransitionRule[];
 }
+/**
+ * Init routing configuration per check
+ * Runs BEFORE the check executes (preprocessing/setup)
+ */
+interface OnInitConfig {
+    /** Items to run before this check executes */
+    run?: OnInitRunItem[];
+    /** Dynamic init items: JS expression returning OnInitRunItem[] */
+    run_js?: string;
+    /** Declarative transitions (optional, for advanced use cases) */
+    transitions?: TransitionRule[];
+}
+/**
+ * Unified on_init run item - can be tool, step, workflow, or plain string
+ */
+type OnInitRunItem = OnInitToolInvocation | OnInitStepInvocation | OnInitWorkflowInvocation | string;
+/**
+ * Invoke a custom tool (from tools: section)
+ */
+interface OnInitToolInvocation {
+    /** Tool name (must exist in tools: section) */
+    tool: string;
+    /** Arguments to pass to the tool (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to tool name) */
+    as?: string;
+}
+/**
+ * Invoke a helper step (regular check)
+ */
+interface OnInitStepInvocation {
+    /** Step name (must exist in steps: section) */
+    step: string;
+    /** Arguments to pass to the step (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to step name) */
+    as?: string;
+}
+/**
+ * Invoke a reusable workflow
+ */
+interface OnInitWorkflowInvocation {
+    /** Workflow ID or path */
+    workflow: string;
+    /** Workflow inputs (Liquid templates supported) */
+    with?: Record<string, unknown>;
+    /** Custom output name (defaults to workflow name) */
+    as?: string;
+    /** Step overrides */
+    overrides?: Record<string, Partial<CheckConfig>>;
+    /** Output mapping */
+    output_mapping?: Record<string, string>;
+}
 /**
  * Declarative transition rule for on_* blocks.
  */
@@ -654,6 +759,8 @@ interface DebugConfig {
  * PR comment output configuration
  */
 interface PrCommentOutput {
+    /** Whether PR comments are enabled */
+    enabled?: boolean;
     /** Format of the output */
     format: ConfigOutputFormat;
     /** How to group the results */
@@ -829,6 +936,34 @@ interface CustomToolDefinition {
     /** Expected output schema for validation */
     outputSchema?: Record<string, unknown>;
 }
+/**
+ * Workflow input definition for standalone reusable workflows
+ */
+interface WorkflowInput {
+    /** Input parameter name */
+    name: string;
+    /** JSON Schema for the input */
+    schema?: Record<string, unknown>;
+    /** Whether this input is required */
+    required?: boolean;
+    /** Default value if not provided */
+    default?: unknown;
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * Workflow output definition for standalone reusable workflows
+ */
+interface WorkflowOutput {
+    /** Output name */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Value using Liquid template syntax (references step outputs) */
+    value?: string;
+    /** Value using JavaScript expression (alternative to value) */
+    value_js?: string;
+}
 /**
  * Main Visor configuration
  */
@@ -843,12 +978,16 @@ interface VisorConfig {
     tools?: Record<string, CustomToolDefinition>;
     /** Import workflow definitions from external files or URLs */
     imports?: string[];
+    /** Workflow inputs (for standalone reusable workflows) */
+    inputs?: WorkflowInput[];
+    /** Workflow outputs (for standalone reusable workflows) */
+    outputs?: WorkflowOutput[];
     /** Step configurations (recommended) */
     steps?: Record<string, CheckConfig>;
     /** Check configurations (legacy, use 'steps' instead) - always populated after normalization */
     checks?: Record<string, CheckConfig>;
-    /** Output configuration */
-    output: OutputConfig;
+    /** Output configuration (optional - defaults provided) */
+    output?: OutputConfig;
     /** HTTP server configuration for receiving webhooks */
     http_server?: HttpServerConfig;
     /** Memory storage configuration */
@@ -884,6 +1023,42 @@ interface VisorConfig {
         /** Frontend-specific configuration */
         config?: unknown;
     }>;
+    /** Workspace isolation configuration for sandboxed execution */
+    workspace?: WorkspaceConfig;
+    /** Slack configuration */
+    slack?: SlackConfig;
+}
+/**
+ * Workspace isolation configuration
+ */
+interface WorkspaceConfig {
+    /** Enable workspace isolation (default: true when config present) */
+    enabled?: boolean;
+    /** Base path for workspaces (default: /tmp/visor-workspaces) */
+    base_path?: string;
+    /** Clean up workspace on exit (default: true) */
+    cleanup_on_exit?: boolean;
+}
+/**
+ * Slack configuration
+ */
+interface SlackConfig {
+    /** Slack API version */
+    version?: string;
+    /** Mention handling: 'all', 'direct', etc. */
+    mentions?: string;
+    /** Thread handling: 'required', 'optional', etc. */
+    threads?: string;
+    /** Show raw output in Slack responses */
+    show_raw_output?: boolean;
+    /**
+     * Append telemetry identifiers to Slack replies.
+     */
+    telemetry?: SlackTelemetryConfig;
+}
+interface SlackTelemetryConfig {
+    /** Enable telemetry ID suffix in Slack messages */
+    enabled?: boolean;
 }
 
 /**
@@ -975,6 +1150,36 @@ interface DebugInfo {
     }>;
 }
 
+interface EventEnvelope<T = any> {
+    id: string;
+    version: 1;
+    timestamp: string;
+    runId: string;
+    workflowId?: string;
+    caseId?: string;
+    wave?: number;
+    attempt?: number;
+    checkId?: string;
+    traceId?: string;
+    spanId?: string;
+    causationId?: string;
+    correlationId?: string;
+    payload: T;
+}
+type AnyEvent = any;
+
+type EventHandler<T = AnyEvent> = (event: T | EventEnvelope<T>) => void | Promise<void>;
+interface Subscription {
+    unsubscribe(): void;
+}
+declare class EventBus {
+    private handlers;
+    private anyHandlers;
+    on<T = AnyEvent>(eventType: string, handler: EventHandler<T>): Subscription;
+    onAny(handler: EventHandler): Subscription;
+    emit(event: AnyEvent | EventEnvelope): Promise<void>;
+}
+
 /**
  * Execution context passed to check providers
  */
@@ -994,6 +1199,8 @@ interface ExecutionContext {
     stageHistoryBase?: Record<string, number>;
     /** Workflow inputs - available when executing within a workflow */
     workflowInputs?: Record<string, unknown>;
+    /** Custom arguments passed from on_init 'with' directive */
+    args?: Record<string, unknown>;
     /** SDK hooks for human input */
     hooks?: {
         onHumanInput?: (request: HumanInputRequest) => Promise<string>;
@@ -1018,6 +1225,13 @@ interface ExecutionContext {
         /** reset per-run guard state before grouped execution */
         resetPerRunState?: boolean;
     };
+    /** Optional event bus for emitting integration events (e.g., HumanInputRequested) */
+    eventBus?: EventBus;
+    /** Optional webhook context (e.g., Slack Events API payload) */
+    webhookContext?: {
+        webhookData?: Map<string, unknown>;
+        eventType?: string;
+    };
 }
 
 interface VisorOptions {