windmill-cli 1.589.3 → 1.591.0

package/types/windmill-utils-internal/src/gen/types.gen.d.ts

@@ -1,27 +1,85 @@
+/**
+ * Top-level flow definition containing metadata, configuration, and the flow structure
+ */
 export type OpenFlow = {
+    /**
+     * Short description of what this flow does
+     */
     summary: string;
+    /**
+     * Detailed documentation for this flow
+     */
     description?: string;
     value: FlowValue;
+    /**
+     * JSON Schema for flow inputs. Use this to define input parameters, their types, defaults, and validation. For resource inputs, set type to 'object' and format to 'resource-<type>' (e.g., 'resource-stripe')
+     */
     schema?: {
         [key: string]: unknown;
     };
 };
+/**
+ * The flow structure containing modules and optional preprocessor/failure handlers
+ */
 export type FlowValue = {
+    /**
+     * Array of steps that execute in sequence. Each step can be a script, subflow, loop, or branch
+     */
     modules: Array<FlowModule>;
+    /**
+     * Special module that executes when the flow fails. Receives error object with message, name, stack, and step_id. Must have id 'failure'. Only supports script/rawscript types
+     */
     failure_module?: FlowModule;
+    /**
+     * Special module that runs before the first step on external triggers. Must have id 'preprocessor'. Only supports script/rawscript types. Cannot reference other step results
+     */
     preprocessor_module?: FlowModule;
+    /**
+     * If true, all steps run on the same worker for better performance
+     */
     same_worker?: boolean;
+    /**
+     * Maximum number of concurrent executions of this flow
+     */
     concurrent_limit?: number;
+    /**
+     * Expression to group concurrent executions (e.g., by user ID)
+     */
     concurrency_key?: string;
+    /**
+     * Time window in seconds for concurrent_limit
+     */
     concurrency_time_window_s?: number;
+    /**
+     * Delay in seconds to debounce flow executions
+     */
     debounce_delay_s?: number;
+    /**
+     * Expression to group debounced executions
+     */
     debounce_key?: string;
+    /**
+     * JavaScript expression to conditionally skip the entire flow
+     */
     skip_expr?: string;
+    /**
+     * Cache duration in seconds for flow results
+     */
     cache_ttl?: number;
+    cache_ignore_s3_path?: boolean;
+    /**
+     * Environment variables available to all steps
+     */
     flow_env?: {
         [key: string]: (string);
     };
+    /**
+     * Execution priority (higher numbers run first)
+     */
     priority?: number;
+    /**
+     * JavaScript expression to return early from the flow
+     */
     early_return?: string;
     /**
      * Whether this flow accepts chat-style input
@@ -32,166 +90,503 @@ export type FlowValue = {
      */
     notes?: Array<FlowNote>;
 };
+/**
+ * Retry configuration for failed module executions
+ */
 export type Retry = {
+    /**
+     * Retry with constant delay between attempts
+     */
     constant?: {
+        /**
+         * Number of retry attempts
+         */
         attempts?: number;
+        /**
+         * Seconds to wait between retries
+         */
         seconds?: number;
     };
+    /**
+     * Retry with exponential backoff (delay doubles each time)
+     */
     exponential?: {
+        /**
+         * Number of retry attempts
+         */
         attempts?: number;
+        /**
+         * Multiplier for exponential backoff
+         */
         multiplier?: number;
+        /**
+         * Initial delay in seconds
+         */
         seconds?: number;
+        /**
+         * Random jitter percentage (0-100) to avoid thundering herd
+         */
         random_factor?: number;
     };
+    /**
+     * Conditional retry based on error or result
+     */
     retry_if?: {
+        /**
+         * JavaScript expression that returns true to retry. Has access to 'result' and 'error' variables
+         */
         expr: string;
     };
 };
+/**
+ * Early termination condition for a module
+ */
 export type StopAfterIf = {
+    /**
+     * If true, following steps are skipped when this condition triggers
+     */
     skip_if_stopped?: boolean;
+    /**
+     * JavaScript expression evaluated after the module runs. Can use 'result' (step's result) or 'flow_input'. Return true to stop
+     */
     expr: string;
+    /**
+     * Custom error message shown when stopping
+     */
     error_message?: string;
 };
+/**
+ * A single step in a flow. Can be a script, subflow, loop, or branch
+ */
 export type FlowModule = {
+    /**
+     * Unique identifier for this step. Used to reference results via 'results.step_id'. Must be a valid identifier (alphanumeric, underscore, hyphen)
+     */
     id: string;
     value: FlowModuleValue;
+    /**
+     * Early termination condition evaluated after this step completes
+     */
     stop_after_if?: StopAfterIf;
+    /**
+     * For loops only - early termination condition evaluated after all iterations complete
+     */
     stop_after_all_iters_if?: StopAfterIf;
+    /**
+     * Conditionally skip this step based on previous results or flow inputs
+     */
     skip_if?: {
+        /**
+         * JavaScript expression that returns true to skip. Can use 'flow_input' or 'results.<step_id>'
+         */
         expr: string;
     };
+    /**
+     * Delay before executing this step (in seconds or as expression)
+     */
     sleep?: InputTransform;
+    /**
+     * Cache duration in seconds for this step's results
+     */
     cache_ttl?: number;
+    cache_ignore_s3_path?: boolean;
+    /**
+     * Maximum execution time in seconds (static value or expression)
+     */
     timeout?: InputTransform;
+    /**
+     * If true, this step's result is deleted after use to save memory
+     */
     delete_after_use?: boolean;
+    /**
+     * Short description of what this step does
+     */
     summary?: string;
+    /**
+     * Mock configuration for testing without executing the actual step
+     */
     mock?: {
+        /**
+         * If true, return mock value instead of executing
+         */
         enabled?: boolean;
+        /**
+         * Value to return when mocked
+         */
         return_value?: unknown;
     };
+    /**
+     * Configuration for approval/resume steps that wait for user input
+     */
     suspend?: {
+        /**
+         * Number of approvals required before continuing
+         */
         required_events?: number;
+        /**
+         * Timeout in seconds before auto-continuing or canceling
+         */
         timeout?: number;
+        /**
+         * Form schema for collecting input when resuming
+         */
         resume_form?: {
+            /**
+             * JSON Schema for the resume form
+             */
             schema?: {
                 [key: string]: unknown;
             };
         };
+        /**
+         * If true, only authenticated users can approve
+         */
         user_auth_required?: boolean;
+        /**
+         * Expression or list of groups that can approve
+         */
         user_groups_required?: InputTransform;
+        /**
+         * If true, the user who started the flow cannot approve
+         */
         self_approval_disabled?: boolean;
+        /**
+         * If true, hide the cancel button on the approval form
+         */
         hide_cancel?: boolean;
+        /**
+         * If true, continue flow on timeout instead of canceling
+         */
         continue_on_disapprove_timeout?: boolean;
     };
+    /**
+     * Execution priority for this step (higher numbers run first)
+     */
     priority?: number;
+    /**
+     * If true, flow continues even if this step fails
+     */
     continue_on_error?: boolean;
+    /**
+     * Retry configuration if this step fails
+     */
     retry?: Retry;
 };
+/**
+ * Maps input parameters for a step. Can be a static value or a JavaScript expression that references previous results or flow inputs
+ */
 export type InputTransform = StaticTransform | JavascriptTransform;
+/**
+ * Static value passed directly to the step. Use for hardcoded values or resource references like '$res:path/to/resource'
+ */
 export type StaticTransform = {
+    /**
+     * The static value. For resources, use format '$res:path/to/resource'
+     */
     value?: unknown;
     type: 'static';
 };
+/**
+ * JavaScript expression evaluated at runtime. Can reference previous step results via 'results.step_id' or flow inputs via 'flow_input.property'. Inside loops, use 'flow_input.iter.value' for the current iteration value
+ */
 export type JavascriptTransform = {
+    /**
+     * JavaScript expression returning the value. Available variables - results (object with all previous step results), flow_input (flow inputs), flow_input.iter (in loops)
+     */
     expr: string;
     type: 'javascript';
 };
+/**
+ * The actual implementation of a flow step. Can be a script (inline or referenced), subflow, loop, branch, or special module type
+ */
 export type FlowModuleValue = RawScript | PathScript | PathFlow | ForloopFlow | WhileloopFlow | BranchOne | BranchAll | Identity | AiAgent;
+/**
+ * Inline script with code defined directly in the flow. Use 'bun' as default language if unspecified. The script receives arguments from input_transforms
+ */
 export type RawScript = {
+    /**
+     * Map of parameter names to their values (static or JavaScript expressions). These become the script's input arguments
+     */
     input_transforms: {
         [key: string]: InputTransform;
     };
+    /**
+     * The script source code. Should export a 'main' function
+     */
     content: string;
+    /**
+     * Programming language for this script
+     */
     language: 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php';
+    /**
+     * Optional path for saving this script
+     */
     path?: string;
+    /**
+     * Lock file content for dependencies
+     */
     lock?: string;
     type: 'rawscript';
+    /**
+     * Worker group tag for execution routing
+     */
     tag?: string;
+    /**
+     * Maximum concurrent executions of this script
+     */
     concurrent_limit?: number;
+    /**
+     * Time window for concurrent_limit
+     */
     concurrency_time_window_s?: number;
+    /**
+     * Custom key for grouping concurrent executions
+     */
     custom_concurrency_key?: string;
+    /**
+     * If true, this script is a trigger that can start the flow
+     */
     is_trigger?: boolean;
+    /**
+     * External resources this script accesses (S3 objects, resources, etc.)
+     */
     assets?: Array<{
+        /**
+         * Path to the asset
+         */
         path: string;
-        kind: 's3object' | 'resource' | 'ducklake';
+        /**
+         * Type of asset
+         */
+        kind: 's3object' | 'resource' | 'ducklake' | 'datatable';
+        /**
+         * Access level for this asset
+         */
         access_type?: 'r' | 'w' | 'rw';
+        /**
+         * Alternative access level
+         */
         alt_access_type?: 'r' | 'w' | 'rw';
     }>;
 };
+/**
+ * Programming language for this script
+ */
 export type language = 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php';
+/**
+ * Reference to an existing script by path. Use this when calling a previously saved script instead of writing inline code
+ */
 export type PathScript = {
+    /**
+     * Map of parameter names to their values (static or JavaScript expressions). These become the script's input arguments
+     */
     input_transforms: {
         [key: string]: InputTransform;
     };
+    /**
+     * Path to the script in the workspace (e.g., 'f/scripts/send_email')
+     */
     path: string;
+    /**
+     * Optional specific version hash of the script to use
+     */
     hash?: string;
     type: 'script';
+    /**
+     * Override the script's default worker group tag
+     */
     tag_override?: string;
+    /**
+     * If true, this script is a trigger that can start the flow
+     */
     is_trigger?: boolean;
 };
+/**
+ * Reference to an existing flow by path. Use this to call another flow as a subflow
+ */
 export type PathFlow = {
+    /**
+     * Map of parameter names to their values (static or JavaScript expressions). These become the subflow's input arguments
+     */
     input_transforms: {
         [key: string]: InputTransform;
     };
+    /**
+     * Path to the flow in the workspace (e.g., 'f/flows/process_user')
+     */
     path: string;
     type: 'flow';
 };
+/**
+ * Executes nested modules in a loop over an iterator. Inside the loop, use 'flow_input.iter.value' to access the current iteration value, and 'flow_input.iter.index' for the index. Supports parallel execution for better performance on I/O-bound operations
+ */
 export type ForloopFlow = {
+    /**
+     * Steps to execute for each iteration. These can reference the iteration value via 'flow_input.iter.value'
+     */
     modules: Array<FlowModule>;
+    /**
+     * JavaScript expression that returns an array to iterate over. Can reference 'results.step_id' or 'flow_input'
+     */
     iterator: InputTransform;
+    /**
+     * If true, iteration failures don't stop the loop. Failed iterations return null
+     */
     skip_failures: boolean;
     type: 'forloopflow';
+    /**
+     * If true, iterations run concurrently (faster for I/O-bound operations). Use with parallelism to control concurrency
+     */
     parallel?: boolean;
+    /**
+     * Maximum number of concurrent iterations when parallel=true. Limits resource usage. Can be static number or expression
+     */
     parallelism?: InputTransform;
     squash?: boolean;
 };
+/**
+ * Executes nested modules repeatedly while a condition is true. The loop checks the condition after each iteration. Use stop_after_if on modules to control loop termination
+ */
 export type WhileloopFlow = {
+    /**
+     * Steps to execute in each iteration. Use stop_after_if to control when the loop ends
+     */
     modules: Array<FlowModule>;
+    /**
+     * If true, iteration failures don't stop the loop. Failed iterations return null
+     */
     skip_failures: boolean;
     type: 'whileloopflow';
+    /**
+     * If true, iterations run concurrently (use with caution in while loops)
+     */
     parallel?: boolean;
+    /**
+     * Maximum number of concurrent iterations when parallel=true
+     */
     parallelism?: InputTransform;
     squash?: boolean;
 };
+/**
+ * Conditional branching where only the first matching branch executes. Branches are evaluated in order, and the first one with a true expression runs. If no branches match, the default branch executes
+ */
 export type BranchOne = {
+    /**
+     * Array of branches to evaluate in order. The first branch with expr evaluating to true executes
+     */
     branches: Array<{
+        /**
+         * Short description of this branch condition
+         */
         summary?: string;
+        /**
+         * JavaScript expression that returns boolean. Can use 'results.step_id' or 'flow_input'. First true expr wins
+         */
         expr: string;
+        /**
+         * Steps to execute if this branch's expr is true
+         */
         modules: Array<FlowModule>;
     }>;
+    /**
+     * Steps to execute if no branch expressions match
+     */
     default: Array<FlowModule>;
     type: 'branchone';
 };
+/**
+ * Parallel branching where all branches execute simultaneously. Unlike BranchOne, all branches run regardless of conditions. Useful for executing independent tasks concurrently
+ */
 export type BranchAll = {
+    /**
+     * Array of branches that all execute (either in parallel or sequentially)
+     */
     branches: Array<{
+        /**
+         * Short description of this branch's purpose
+         */
         summary?: string;
+        /**
+         * If true, failure in this branch doesn't fail the entire flow
+         */
         skip_failure?: boolean;
+        /**
+         * Steps to execute in this branch
+         */
         modules: Array<FlowModule>;
     }>;
     type: 'branchall';
+    /**
+     * If true, all branches execute concurrently. If false, they execute sequentially
+     */
     parallel?: boolean;
 };
+/**
+ * AI agent step that can use tools to accomplish tasks. The agent receives inputs and can call any of its configured tools to complete the task
+ */
 export type AiAgent = {
+    /**
+     * Input parameters for the AI agent mapped to their values
+     */
     input_transforms: {
-        [key: string]: InputTransform;
+        provider: InputTransform;
+        output_type: InputTransform;
+        user_message: InputTransform;
+        system_prompt?: InputTransform;
+        streaming?: InputTransform;
+        messages_context_length?: InputTransform;
+        output_schema?: InputTransform;
+        user_images?: InputTransform;
+        max_completion_tokens?: InputTransform;
+        temperature?: InputTransform;
     };
+    /**
+     * Array of tools the agent can use. The agent decides which tools to call based on the task
+     */
     tools: Array<{
+        /**
+         * Unique identifier for this tool. Cannot contain spaces - use underscores instead (e.g., 'get_user_data' not 'get user data')
+         */
         id: string;
+        /**
+         * Short description of what this tool does (shown to the AI)
+         */
         summary?: string;
+        /**
+         * The implementation of a tool. Can be a flow module (script/flow) or an MCP tool reference
+         */
         value: (({
             tool_type: 'flowmodule';
         } & FlowModuleValue) | {
             tool_type: 'mcp';
+            /**
+             * Path to the MCP resource/server configuration
+             */
             resource_path: string;
+            /**
+             * Whitelist of specific tools to include from this MCP server
+             */
             include_tools?: Array<(string)>;
+            /**
+             * Blacklist of tools to exclude from this MCP server
+             */
             exclude_tools?: Array<(string)>;
         });
     }>;
     type: 'aiagent';
+    /**
+     * If true, the agent can execute multiple tool calls in parallel
+     */
     parallel?: boolean;
 };
+/**
+ * Pass-through module that returns its input unchanged. Useful for flow structure or as a placeholder
+ */
 export type Identity = {
     type: 'identity';
+    /**
+     * If true, marks this as a flow identity (special handling)
+     */
     flow?: boolean;
 };
 export type FlowStatus = {
@@ -546,6 +941,7 @@ export type NewScript = {
     concurrent_limit?: number;
     concurrency_time_window_s?: number;
     cache_ttl?: number;
+    cache_ignore_s3_path?: boolean;
     dedicated_worker?: boolean;
     ws_error_handler_muted?: boolean;
     priority?: number;
@@ -620,7 +1016,7 @@ export type QueuedJob = {
     canceled_by?: string;
     canceled_reason?: string;
     last_ping?: string;
-    job_kind: 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent';
+    job_kind: 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow';
     schedule_path?: string;
     /**
      * The user (u/userfoo) or group (g/groupfoo) whom
@@ -644,7 +1040,7 @@ export type QueuedJob = {
     preprocessed?: boolean;
     worker?: string;
 };
-export type job_kind = 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent';
+export type job_kind = 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow';
 export type CompletedJob = {
     workspace_id?: string;
     id: string;
@@ -665,7 +1061,7 @@ export type CompletedJob = {
     canceled: boolean;
     canceled_by?: string;
     canceled_reason?: string;
-    job_kind: 'script' | 'preview' | 'dependencies' | 'flow' | 'flowdependencies' | 'appdependencies' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent';
+    job_kind: 'script' | 'preview' | 'dependencies' | 'flow' | 'flowdependencies' | 'appdependencies' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow';
     schedule_path?: string;
     /**
      * The user (u/userfoo) or group (g/groupfoo) whom
@@ -723,7 +1119,7 @@ export type ExportableCompletedJob = {
     raw_lock?: string;
     canceled_by?: string;
     canceled_reason?: string;
-    job_kind: 'script' | 'preview' | 'dependencies' | 'flow' | 'flowdependencies' | 'appdependencies' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript';
+    job_kind: 'script' | 'preview' | 'dependencies' | 'flow' | 'flowdependencies' | 'appdependencies' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow';
     /**
      * Trigger path for the job (replaces schedule_path)
      */
@@ -768,7 +1164,6 @@ export type ExportableCompletedJob = {
      */
     status?: string;
 };
-export type job_kind2 = 'script' | 'preview' | 'dependencies' | 'flow' | 'flowdependencies' | 'appdependencies' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript';
 export type trigger_kind = 'webhook' | 'http' | 'websocket' | 'kafka' | 'email' | 'nats' | 'schedule' | 'app' | 'ui' | 'postgres' | 'sqs' | 'gcp';
 /**
  * Queued job with full data for export/import operations
@@ -796,7 +1191,7 @@ export type ExportableQueuedJob = {
     raw_lock?: string;
     canceled_by?: string;
     canceled_reason?: string;
-    job_kind: 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript';
+    job_kind: 'script' | 'preview' | 'dependencies' | 'flowdependencies' | 'appdependencies' | 'flow' | 'flowpreview' | 'script_hub' | 'identity' | 'deploymentcallback' | 'singlestepflow' | 'flowscript' | 'flownode' | 'appscript' | 'aiagent' | 'unassigned_script' | 'unassigned_flow' | 'unassigned_singlestepflow';
     /**
      * Trigger path for the job (replaces schedule_path)
      */
@@ -1055,6 +1450,14 @@ export type Preview = {
     lock?: string;
 };
 export type kind2 = 'code' | 'identity' | 'http';
+export type PreviewInline = {
+    /**
+     * The code to run
+     */
+    content: string;
+    args: ScriptArgs;
+    language: ScriptLang;
+};
 export type WorkflowTask = {
     args: ScriptArgs;
 };
@@ -1374,6 +1777,14 @@ export type EditSchedule = {
      */
     dynamic_skip?: string;
 };
+/**
+ * job trigger kind (schedule, http, websocket...)
+ */
+export type JobTriggerKind = 'webhook' | 'default_email' | 'email' | 'schedule' | 'http' | 'websocket' | 'postgres' | 'kafka' | 'nats' | 'mqtt' | 'sqs' | 'gcp';
+/**
+ * job trigger mode
+ */
+export type TriggerMode = 'enabled' | 'disabled' | 'suspended';
 export type TriggerExtraProperty = {
     path: string;
     script_path: string;
@@ -1385,7 +1796,7 @@ export type TriggerExtraProperty = {
     edited_by: string;
     edited_at: string;
     is_flow: boolean;
-    enabled: boolean;
+    mode: TriggerMode;
 };
 export type AuthenticationMethod = 'none' | 'windmill' | 'api_key' | 'basic_http' | 'custom_script' | 'signature';
 export type RunnableKind = 'script' | 'flow';
@@ -1471,7 +1882,7 @@ export type NewHttpTrigger = {
     authentication_method: AuthenticationMethod;
     is_static_website: boolean;
     wrap_body?: boolean;
-    enabled?: boolean;
+    mode?: TriggerMode;
     raw_string?: boolean;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
@@ -1544,7 +1955,7 @@ export type NewWebsocketTrigger = {
     script_path: string;
     is_flow: boolean;
     url: string;
-    enabled?: boolean;
+    mode?: TriggerMode;
     filters: Array<{
         key: string;
         value: unknown;
@@ -1621,7 +2032,7 @@ export type NewMqttTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled?: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1636,7 +2047,7 @@ export type EditMqttTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1675,7 +2086,7 @@ export type GcpTriggerData = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled?: boolean;
+    mode?: TriggerMode;
     auto_acknowledge_msg?: boolean;
     /**
      * Time in seconds within which the message must be acknowledged. If not provided, defaults to the subscription's acknowledgment deadline (600 seconds).
@@ -1705,19 +2116,17 @@ export type SqsTrigger = TriggerExtraProperty & {
     retry?: Retry;
 };
 export type LoggedWizardStatus = 'OK' | 'SKIP' | 'FAIL';
-export type DucklakeInstanceCatalogDbStatusLogs = {
+export type CustomInstanceDbLogs = {
     super_admin?: LoggedWizardStatus;
     database_credentials?: LoggedWizardStatus;
     valid_dbname?: LoggedWizardStatus;
-    /**
-     * Created database status log
-     */
     created_database?: LoggedWizardStatus;
     db_connect?: LoggedWizardStatus;
     grant_permissions?: LoggedWizardStatus;
 };
-export type DucklakeInstanceCatalogDbStatus = {
-    logs: DucklakeInstanceCatalogDbStatusLogs;
+export type CustomInstanceDbTag = 'ducklake' | 'datatable';
+export type CustomInstanceDb = {
+    logs: CustomInstanceDbLogs;
     /**
      * Whether the operation completed successfully
      */
@@ -1726,6 +2135,7 @@ export type DucklakeInstanceCatalogDbStatus = {
      * Error message if the operation failed
      */
     error?: (string) | null;
+    tag?: CustomInstanceDbTag;
 };
 export type NewSqsTrigger = {
     queue_url: string;
@@ -1735,7 +2145,7 @@ export type NewSqsTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled?: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1748,7 +2158,7 @@ export type EditSqsTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1796,7 +2206,7 @@ export type NewPostgresTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled: boolean;
+    mode?: TriggerMode;
     postgres_resource_path: string;
     publication?: PublicationData;
     error_handler_path?: string;
@@ -1809,7 +2219,7 @@ export type EditPostgresTrigger = {
     path: string;
     script_path: string;
     is_flow: boolean;
-    enabled: boolean;
+    mode?: TriggerMode;
     postgres_resource_path: string;
     publication?: PublicationData;
     error_handler_path?: string;
@@ -1834,7 +2244,7 @@ export type NewKafkaTrigger = {
     kafka_resource_path: string;
     group_id: string;
     topics: Array<(string)>;
-    enabled?: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1872,7 +2282,7 @@ export type NewNatsTrigger = {
     stream_name?: string;
     consumer_name?: string;
     subjects: Array<(string)>;
-    enabled?: boolean;
+    mode?: TriggerMode;
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
@@ -1906,7 +2316,7 @@ export type NewEmailTrigger = {
     error_handler_path?: string;
     error_handler_args?: ScriptArgs;
     retry?: Retry;
-    enabled?: boolean;
+    mode?: TriggerMode;
 };
 export type EditEmailTrigger = {
     path: string;
@@ -2230,6 +2640,16 @@ export type DucklakeSettings = {
         };
     };
 };
+export type DataTableSettings = {
+    datatables: {
+        [key: string]: {
+            database: {
+                resource_type: 'postgresql' | 'instance';
+                resource_path?: string;
+            };
+        };
+    };
+};
 export type DynamicInputData = {
     /**
      * Name of the function to execute for dynamic select
@@ -2553,7 +2973,7 @@ export type TeamsChannel = {
 };
 export type AssetUsageKind = 'script' | 'flow';
 export type AssetUsageAccessType = 'r' | 'w' | 'rw';
-export type AssetKind = 's3object' | 'resource' | 'ducklake';
+export type AssetKind = 's3object' | 'resource' | 'ducklake' | 'datatable';
 export type Asset = {
     path: string;
     kind: AssetKind;
@@ -2588,7 +3008,7 @@ export type ParameterPerPage = number;
 /**
  * trigger kind (schedule, http, websocket...)
  */
-export type ParameterJobTriggerKind = 'webhook' | 'default_email' | 'email' | 'schedule' | 'http' | 'websocket' | 'postgres' | 'kafka' | 'nats' | 'mqtt' | 'sqs' | 'gcp' | 'poll' | 'cli';
+export type ParameterJobTriggerKind = JobTriggerKind;
 /**
  * order by desc order (default true)
  */
@@ -2650,6 +3070,10 @@ export type ParameterScriptStartPath = string;
  * mask to filter by schedule path
  */
 export type ParameterSchedulePath = string;
+/**
+ * mask to filter by trigger path
+ */
+export type ParameterTriggerPath = string;
 /**
  * mask to filter exact matching path
  */
@@ -2759,6 +3183,20 @@ export type ParameterRunnableKind = 'script' | 'flow';
 export type BackendVersionResponse = (string);
 export type BackendUptodateResponse = (string);
 export type GetLicenseIdResponse = (string);
+export type QueryDocumentationData = {
+    /**
+     * query to send to the AI documentation assistant
+     */
+    requestBody: {
+        /**
+         * The documentation query to send to the AI assistant
+         */
+        query: string;
+    };
+};
+export type QueryDocumentationResponse = ({
+    [key: string]: unknown;
+});
 export type GetOpenApiYamlResponse = (string);
 export type GetAuditLogData = {
     id: number;
@@ -3011,16 +3449,22 @@ export type ExistsUsernameData = {
     };
 };
 export type ExistsUsernameResponse = (boolean);
-export type GetDucklakeInstanceCatalogDbStatusResponse = ({
-    [key: string]: DucklakeInstanceCatalogDbStatus;
+export type RefreshCustomInstanceUserPwdResponse = ({
+    [key: string]: unknown;
+});
+export type ListCustomInstanceDbsResponse = ({
+    [key: string]: CustomInstanceDb;
 });
-export type SetupDucklakeCatalogDbData = {
+export type SetupCustomInstanceDbData = {
     /**
      * The name of the database to create
      */
     name: string;
+    requestBody: {
+        tag?: CustomInstanceDbTag;
+    };
 };
-export type SetupDucklakeCatalogDbResponse = (DucklakeInstanceCatalogDbStatus);
+export type SetupCustomInstanceDbResponse = (CustomInstanceDb);
 export type GetGlobalData = {
     key: string;
 };
@@ -3134,6 +3578,7 @@ export type RefreshUserTokenData = {
 export type RefreshUserTokenResponse = (string);
 export type GetTutorialProgressResponse = ({
     progress?: number;
+    skipped_all?: boolean;
 });
 export type UpdateTutorialProgressData = {
     /**
@@ -3141,6 +3586,7 @@ export type UpdateTutorialProgressData = {
      */
     requestBody: {
         progress?: number;
+        skipped_all?: boolean;
     };
 };
 export type UpdateTutorialProgressResponse = (string);
@@ -3371,6 +3817,7 @@ export type GetSettingsResponse = ({
     error_handler_muted_on_cancel: boolean;
     large_file_storage?: LargeFileStorage;
     ducklake?: DucklakeSettings;
+    datatable?: DataTableSettings;
     git_sync?: WorkspaceGitSyncSettings;
     deploy_ui?: WorkspaceDeployUISettings;
     default_app?: string;
@@ -3635,6 +4082,10 @@ export type ListDucklakesData = {
     workspace: string;
 };
 export type ListDucklakesResponse = (Array<(string)>);
+export type ListDataTablesData = {
+    workspace: string;
+};
+export type ListDataTablesResponse = (Array<(string)>);
 export type EditDucklakeConfigData = {
     /**
      * Ducklake settings
@@ -3645,6 +4096,16 @@ export type EditDucklakeConfigData = {
     workspace: string;
 };
 export type EditDucklakeConfigResponse = (unknown);
+export type EditDataTableConfigData = {
+    /**
+     * DataTable settings
+     */
+    requestBody: {
+        settings: DataTableSettings;
+    };
+    workspace: string;
+};
+export type EditDataTableConfigResponse = (unknown);
 export type EditWorkspaceGitSyncConfigData = {
     /**
      * Workspace Git sync settings
@@ -3820,6 +4281,7 @@ export type ListTokensData = {
 export type ListTokensResponse = (Array<TruncatedToken>);
 export type GetOidcTokenData = {
     audience: string;
+    expiresIn?: number;
     workspace: string;
 };
 export type GetOidcTokenResponse = (string);
@@ -6181,6 +6643,14 @@ export type RunScriptPreviewData = {
     workspace: string;
 };
 export type RunScriptPreviewResponse = (string);
+export type RunScriptPreviewInlineData = {
+    /**
+     * preview
+     */
+    requestBody: PreviewInline;
+    workspace: string;
+};
+export type RunScriptPreviewInlineResponse = (unknown);
 export type RunScriptPreviewAndWaitResultData = {
     /**
      * preview
@@ -6347,6 +6817,14 @@ export type ListQueueData = {
      * filter on jobs with a given tag/worker group
      */
     tag?: string;
+    /**
+     * trigger kind (schedule, http, websocket...)
+     */
+    triggerKind?: JobTriggerKind;
+    /**
+     * mask to filter by trigger path
+     */
+    triggerPath?: string;
     /**
      * worker this job was ran on
      */
@@ -6609,6 +7087,48 @@ export type CancelSelectionData = {
     workspace: string;
 };
 export type CancelSelectionResponse = (Array<(string)>);
+export type ResumeSuspendedTriggerJobsData = {
+    /**
+     * Optional list of job IDs to reassign
+     */
+    requestBody?: {
+        /**
+         * Optional list of specific job UUIDs to reassign. If not provided, all suspended jobs for the trigger will be reassigned.
+         */
+        job_ids?: Array<(string)>;
+    };
+    /**
+     * The kind of trigger
+     */
+    triggerKind: JobTriggerKind;
+    /**
+     * The path of the trigger (can contain forward slashes)
+     */
+    triggerPath: string;
+    workspace: string;
+};
+export type ResumeSuspendedTriggerJobsResponse = (string);
+export type CancelSuspendedTriggerJobsData = {
+    /**
+     * Optional list of job IDs to cancel
+     */
+    requestBody?: {
+        /**
+         * Optional list of specific job UUIDs to cancel. If not provided, all suspended jobs for the trigger will be canceled.
+         */
+        job_ids?: Array<(string)>;
+    };
+    /**
+     * The kind of trigger
+     */
+    triggerKind: JobTriggerKind;
+    /**
+     * The path of the trigger (can contain forward slashes)
+     */
+    triggerPath: string;
+    workspace: string;
+};
+export type CancelSuspendedTriggerJobsResponse = (string);
 export type ListCompletedJobsData = {
     /**
      * allow wildcards (*) in the filter of label, tag, worker
@@ -6868,7 +7388,7 @@ export type ListJobsData = {
     /**
      * trigger kind (schedule, http, websocket...)
      */
-    triggerKind?: 'webhook' | 'default_email' | 'email' | 'schedule' | 'http' | 'websocket' | 'postgres' | 'kafka' | 'nats' | 'mqtt' | 'sqs' | 'gcp' | 'poll' | 'cli';
+    triggerKind?: JobTriggerKind;
     /**
      * worker this job was ran on
      */
@@ -7370,14 +7890,14 @@ export type ExistsRouteData = {
     workspace: string;
 };
 export type ExistsRouteResponse = (boolean);
-export type SetHttpTriggerEnabledData = {
+export type SetHttpTriggerModeData = {
     path: string;
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetHttpTriggerEnabledResponse = (string);
+export type SetHttpTriggerModeResponse = (string);
 export type CreateWebsocketTriggerData = {
     /**
      * new websocket trigger
@@ -7428,17 +7948,17 @@ export type ExistsWebsocketTriggerData = {
     workspace: string;
 };
 export type ExistsWebsocketTriggerResponse = (boolean);
-export type SetWebsocketTriggerEnabledData = {
+export type SetWebsocketTriggerModeData = {
     path: string;
     /**
      * updated websocket trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetWebsocketTriggerEnabledResponse = (string);
+export type SetWebsocketTriggerModeResponse = (string);
 export type TestWebsocketConnectionData = {
     /**
      * test websocket connection
@@ -7501,17 +8021,17 @@ export type ExistsKafkaTriggerData = {
     workspace: string;
 };
 export type ExistsKafkaTriggerResponse = (boolean);
-export type SetKafkaTriggerEnabledData = {
+export type SetKafkaTriggerModeData = {
     path: string;
     /**
      * updated kafka trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetKafkaTriggerEnabledResponse = (string);
+export type SetKafkaTriggerModeResponse = (string);
 export type TestKafkaConnectionData = {
     /**
      * test kafka connection
@@ -7574,17 +8094,17 @@ export type ExistsNatsTriggerData = {
     workspace: string;
 };
 export type ExistsNatsTriggerResponse = (boolean);
-export type SetNatsTriggerEnabledData = {
+export type SetNatsTriggerModeData = {
     path: string;
     /**
      * updated nats trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetNatsTriggerEnabledResponse = (string);
+export type SetNatsTriggerModeResponse = (string);
 export type TestNatsConnectionData = {
     /**
      * test nats connection
@@ -7647,17 +8167,17 @@ export type ExistsSqsTriggerData = {
     workspace: string;
 };
 export type ExistsSqsTriggerResponse = (boolean);
-export type SetSqsTriggerEnabledData = {
+export type SetSqsTriggerModeData = {
     path: string;
     /**
      * updated sqs trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetSqsTriggerEnabledResponse = (string);
+export type SetSqsTriggerModeResponse = (string);
 export type TestSqsConnectionData = {
     /**
      * test sqs connection
@@ -7720,17 +8240,17 @@ export type ExistsMqttTriggerData = {
     workspace: string;
 };
 export type ExistsMqttTriggerResponse = (boolean);
-export type SetMqttTriggerEnabledData = {
+export type SetMqttTriggerModeData = {
     path: string;
     /**
      * updated mqtt trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetMqttTriggerEnabledResponse = (string);
+export type SetMqttTriggerModeResponse = (string);
 export type TestMqttConnectionData = {
     /**
      * test mqtt connection
@@ -7793,17 +8313,17 @@ export type ExistsGcpTriggerData = {
     workspace: string;
 };
 export type ExistsGcpTriggerResponse = (boolean);
-export type SetGcpTriggerEnabledData = {
+export type SetGcpTriggerModeData = {
     path: string;
     /**
      * updated gcp trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetGcpTriggerEnabledResponse = (string);
+export type SetGcpTriggerModeResponse = (string);
 export type TestGcpConnectionData = {
     /**
      * test gcp connection
@@ -7984,17 +8504,17 @@ export type ExistsPostgresTriggerData = {
     workspace: string;
 };
 export type ExistsPostgresTriggerResponse = (boolean);
-export type SetPostgresTriggerEnabledData = {
+export type SetPostgresTriggerModeData = {
     path: string;
     /**
      * updated postgres trigger enable
      */
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetPostgresTriggerEnabledResponse = (string);
+export type SetPostgresTriggerModeResponse = (string);
 export type TestPostgresConnectionData = {
     /**
      * test postgres connection
@@ -8067,14 +8587,14 @@ export type ExistsEmailLocalPartData = {
     workspace: string;
 };
 export type ExistsEmailLocalPartResponse = (boolean);
-export type SetEmailTriggerEnabledData = {
+export type SetEmailTriggerModeData = {
     path: string;
     requestBody: {
-        enabled: boolean;
+        mode: TriggerMode;
     };
     workspace: string;
 };
-export type SetEmailTriggerEnabledResponse = (string);
+export type SetEmailTriggerModeResponse = (string);
 export type ListInstanceGroupsResponse = (Array<InstanceGroup>);
 export type ListInstanceGroupsWithWorkspacesResponse = (Array<InstanceGroupWithWorkspaces>);
 export type GetInstanceGroupData = {
@@ -9067,7 +9587,7 @@ export type ListExtendedJobsData = {
     /**
      * trigger kind (schedule, http, websocket...)
      */
-    triggerKind?: 'webhook' | 'default_email' | 'email' | 'schedule' | 'http' | 'websocket' | 'postgres' | 'kafka' | 'nats' | 'mqtt' | 'sqs' | 'gcp' | 'poll' | 'cli';
+    triggerKind?: JobTriggerKind;
     workspace: string;
 };
 export type ListExtendedJobsResponse = (ExtendedJobs);