windmill-cli 1.625.0 → 1.628.0

package/types/gen/types.gen.d.ts

@@ -287,10 +287,7 @@ export type FlowModule = {
 /**
  * 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 | {
-    type: 'ai';
-};
-export type type = 'ai';
+export type InputTransform = StaticTransform | JavascriptTransform | AiTransform;
 /**
  * Static value passed directly to the step. Use for hardcoded values or resource references like '$res:path/to/resource'
  */
@@ -311,6 +308,56 @@ export type JavascriptTransform = {
     expr: string;
     type: 'javascript';
 };
+/**
+ * Value resolved by the AI runtime for this input. The AI engine decides how to satisfy the parameter.
+ */
+export type AiTransform = {
+    type: 'ai';
+};
+/**
+ * Complete AI provider configuration with resource reference and model selection
+ */
+export type ProviderConfig = {
+    /**
+     * Supported AI provider types
+     */
+    kind: 'openai' | 'azure_openai' | 'anthropic' | 'mistral' | 'deepseek' | 'googleai' | 'groq' | 'openrouter' | 'togetherai' | 'customai' | 'aws_bedrock';
+    /**
+     * Resource reference in format '$res:{resource_path}' pointing to provider credentials
+     */
+    resource: string;
+    /**
+     * Model identifier (e.g., 'gpt-4', 'claude-3-opus-20240229', 'gemini-pro')
+     */
+    model: string;
+};
+/**
+ * Supported AI provider types
+ */
+export type kind = 'openai' | 'azure_openai' | 'anthropic' | 'mistral' | 'deepseek' | 'googleai' | 'groq' | 'openrouter' | 'togetherai' | 'customai' | 'aws_bedrock';
+/**
+ * Conversation memory configuration
+ */
+export type MemoryConfig = {
+    kind: 'off';
+} | {
+    kind: 'auto';
+    /**
+     * Maximum number of messages to retain in context
+     */
+    context_length?: number;
+    /**
+     * Identifier for persistent memory across agent invocations
+     */
+    memory_id?: string;
+} | {
+    kind: 'manual';
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+};
+export type kind2 = 'off';
 /**
  * The actual implementation of a flow step. Can be a script (inline or referenced), subflow, loop, branch, or special module type
  */
@@ -332,7 +379,7 @@ export type RawScript = {
     /**
      * Programming language for this script
      */
-    language: 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php';
+    language: 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'duckdb';
     /**
      * Optional path for saving this script
      */
@@ -377,17 +424,17 @@ export type RawScript = {
         /**
          * Access level for this asset
          */
-        access_type?: 'r' | 'w' | 'rw';
+        access_type?: ('r' | 'w' | 'rw') | null;
         /**
          * Alternative access level
          */
-        alt_access_type?: 'r' | 'w' | 'rw';
+        alt_access_type?: ('r' | 'w' | 'rw') | null;
     }>;
 };
 /**
  * Programming language for this script
  */
-export type language = 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php';
+export type language = 'deno' | 'bun' | 'python3' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'duckdb';
 /**
  * Reference to an existing script by path. Use this when calling a previously saved script instead of writing inline code
  */
@@ -544,16 +591,69 @@ export type AiAgent = {
      * Input parameters for the AI agent mapped to their values
      */
     input_transforms: {
-        provider: InputTransform;
-        output_type: InputTransform;
-        user_message: InputTransform;
-        system_prompt?: InputTransform;
-        streaming?: InputTransform;
-        memory?: InputTransform;
-        output_schema?: InputTransform;
-        user_images?: InputTransform;
-        max_completion_tokens?: InputTransform;
-        temperature?: InputTransform;
+        /**
+         * Provider configuration - can be static (ProviderConfig), JavaScript expression, or AI-determined
+         */
+        provider: ({
+            value: ProviderConfig;
+            type: 'static';
+        } | JavascriptTransform | AiTransform);
+        /**
+         * Output format type.
+         * Valid values: 'text' (default) - plain text response, 'image' - image generation
+         *
+         */
+        output_type: (InputTransform);
+        /**
+         * The user's prompt/message to the AI agent. Supports variable interpolation with flow.input syntax.
+         */
+        user_message: (InputTransform);
+        /**
+         * System instructions that guide the AI's behavior, persona, and response style. Optional.
+         */
+        system_prompt?: (InputTransform);
+        /**
+         * Boolean. If true, stream the AI response incrementally.
+         * Streaming events include: token_delta, tool_call, tool_call_arguments, tool_execution, tool_result
+         *
+         */
+        streaming?: (InputTransform);
+        /**
+         * Memory configuration - can be static (MemoryConfig), JavaScript expression, or AI-determined
+         */
+        memory?: ({
+            value: MemoryConfig;
+            type: 'static';
+        } | JavascriptTransform | AiTransform);
+        /**
+         * JSON Schema object defining structured output format. Used when you need the AI to return data in a specific shape.
+         * Supports standard JSON Schema properties: type, properties, required, items, enum, pattern, minLength, maxLength, minimum, maximum, etc.
+         * Example: { type: 'object', properties: { name: { type: 'string' }, age: { type: 'integer' } }, required: ['name'] }
+         *
+         */
+        output_schema?: (InputTransform);
+        /**
+         * Array of image references for vision-capable models.
+         * Format: Array<{ bucket: string, key: string }> - S3 object references
+         * Example: [{ bucket: 'my-bucket', key: 'images/photo.jpg' }]
+         *
+         */
+        user_images?: (InputTransform);
+        /**
+         * Integer. Maximum number of tokens the AI will generate in its response.
+         * Range: 1 to 4,294,967,295. Typical values: 256-4096 for most use cases.
+         *
+         */
+        max_completion_tokens?: (InputTransform);
+        /**
+         * Float. Controls randomness/creativity of responses.
+         * Range: 0.0 to 2.0 (provider-dependent)
+         * - 0.0 = deterministic, focused responses
+         * - 0.7 = balanced (common default)
+         * - 1.0+ = more creative/random
+         *
+         */
+        temperature?: (InputTransform);
     };
     /**
      * Array of tools the agent can use. The agent decides which tools to call based on the task
@@ -596,6 +696,7 @@ export type AiAgent = {
      */
     parallel?: boolean;
 };
+export type type = 'static';
 /**
  * Pass-through module that returns its input unchanged. Useful for flow structure or as a placeholder
  */
@@ -1096,7 +1197,7 @@ export type Script = {
     has_preprocessor: boolean;
     on_behalf_of_email?: string;
 };
-export type kind = 'script' | 'failure' | 'trigger' | 'command' | 'approval' | 'preprocessor';
+export type kind3 = 'script' | 'failure' | 'trigger' | 'command' | 'approval' | 'preprocessor';
 export type NewScript = {
     path: string;
     parent_hash?: string;
@@ -1609,7 +1710,7 @@ export type MainArgSignature = {
     has_preprocessor: (boolean) | null;
 };
 export type type5 = 'Valid' | 'Invalid';
-export type ScriptLang = 'python3' | 'deno' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'bun' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'duckdb';
+export type ScriptLang = 'python3' | 'deno' | 'go' | 'bash' | 'powershell' | 'postgresql' | 'mysql' | 'bigquery' | 'snowflake' | 'mssql' | 'oracledb' | 'graphql' | 'nativets' | 'bun' | 'php' | 'rust' | 'ansible' | 'csharp' | 'nu' | 'java' | 'ruby' | 'duckdb' | 'bunnative';
 export type Preview = {
     /**
      * The code to run
@@ -1630,7 +1731,7 @@ export type Preview = {
     dedicated_worker?: boolean;
     lock?: string;
 };
-export type kind2 = 'code' | 'identity' | 'http';
+export type kind4 = 'code' | 'identity' | 'http';
 export type PreviewInline = {
     /**
      * The code to run
@@ -1726,39 +1827,111 @@ export type EditResourceType = {
     description?: string;
 };
 export type Schedule = {
+    /**
+     * The unique path identifier for this schedule
+     */
     path: string;
+    /**
+     * Username of the last person who edited this schedule
+     */
     edited_by: string;
+    /**
+     * Timestamp of the last edit
+     */
     edited_at: string;
+    /**
+     * Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon
+     */
     schedule: string;
+    /**
+     * IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')
+     */
     timezone: string;
+    /**
+     * Whether the schedule is currently active and will trigger jobs
+     */
     enabled: boolean;
+    /**
+     * Path to the script or flow to execute when triggered
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     args?: ScriptArgs;
+    /**
+     * Additional permissions for this schedule
+     */
     extra_perms: {
         [key: string]: (boolean);
     };
+    /**
+     * Email of the user who owns this schedule, used for permissioned_as
+     */
     email: string;
+    /**
+     * Last error message if the schedule failed to trigger
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the scheduled job fails
+     */
     on_failure?: string;
+    /**
+     * Number of consecutive failures before the on_failure handler is triggered (default 1)
+     */
     on_failure_times?: number;
+    /**
+     * If true, trigger on_failure handler only on exactly N failures, not on every failure after N
+     */
     on_failure_exact?: boolean;
     on_failure_extra_args?: ScriptArgs;
+    /**
+     * Path to a script or flow to run when the schedule recovers after failures
+     */
     on_recovery?: string;
+    /**
+     * Number of consecutive successes before the on_recovery handler is triggered (default 1)
+     */
     on_recovery_times?: number;
     on_recovery_extra_args?: ScriptArgs;
+    /**
+     * Path to a script or flow to run after each successful execution
+     */
     on_success?: string;
     on_success_extra_args?: ScriptArgs;
+    /**
+     * If true, the workspace-level error handler will not be triggered for this schedule's failures
+     */
     ws_error_handler_muted?: boolean;
     retry?: Retry;
+    /**
+     * Short summary describing the purpose of this schedule
+     */
     summary?: string;
+    /**
+     * Detailed description of what this schedule does
+     */
     description?: string;
+    /**
+     * If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)
+     */
     no_flow_overlap?: boolean;
+    /**
+     * Worker tag to route jobs to specific worker groups
+     */
     tag?: string;
+    /**
+     * ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time
+     */
     paused_until?: string;
+    /**
+     * Cron parser version. Use 'v2' for extended syntax with additional features
+     */
     cron_version?: string;
     /**
-     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.
+     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)
      */
     dynamic_skip?: string;
 };
@@ -1772,189 +1945,159 @@ export type ScheduleWJobs = Schedule & {
 export type ErrorHandler = 'custom' | 'slack' | 'teams' | 'email';
 export type NewSchedule = {
     /**
-     * The path where the schedule will be created
+     * The unique path identifier for this schedule
      */
     path: string;
     /**
-     * The cron schedule to trigger the script or flow. Should include seconds.
+     * Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon
      */
     schedule: string;
     /**
-     * The timezone to use for the cron schedule
+     * IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')
      */
     timezone: string;
     /**
-     * The path to the script or flow to trigger
+     * Path to the script or flow to execute when triggered
      */
     script_path: string;
     /**
-     * Whether the schedule is for a flow
+     * True if script_path points to a flow, false if it points to a script
      */
     is_flow: boolean;
-    /**
-     * The arguments to pass to the script or flow
-     */
     args: ScriptArgs;
     /**
-     * Whether the schedule is enabled
+     * Whether the schedule is currently active and will trigger jobs
      */
     enabled?: boolean;
     /**
-     * The path to the script or flow to trigger on failure
+     * Path to a script or flow to run when the scheduled job fails
      */
     on_failure?: string;
     /**
-     * The number of times to retry on failure
+     * Number of consecutive failures before the on_failure handler is triggered (default 1)
      */
     on_failure_times?: number;
     /**
-     * Whether the schedule should only run on the exact time
+     * If true, trigger on_failure handler only on exactly N failures, not on every failure after N
      */
     on_failure_exact?: boolean;
-    /**
-     * The arguments to pass to the script or flow on failure
-     */
     on_failure_extra_args?: ScriptArgs;
     /**
-     * The path to the script or flow to trigger on recovery
+     * Path to a script or flow to run when the schedule recovers after failures
      */
     on_recovery?: string;
     /**
-     * The number of times to retry on recovery
+     * Number of consecutive successes before the on_recovery handler is triggered (default 1)
      */
     on_recovery_times?: number;
-    /**
-     * The arguments to pass to the script or flow on recovery
-     */
     on_recovery_extra_args?: ScriptArgs;
     /**
-     * The path to the script or flow to trigger on success
+     * Path to a script or flow to run after each successful execution
      */
     on_success?: string;
-    /**
-     * The arguments to pass to the script or flow on success
-     */
     on_success_extra_args?: ScriptArgs;
     /**
-     * Whether the WebSocket error handler is muted
+     * If true, the workspace-level error handler will not be triggered for this schedule's failures
      */
     ws_error_handler_muted?: boolean;
-    /**
-     * The retry configuration for the schedule
-     */
     retry?: Retry;
     /**
-     * Whether the schedule should not run if a flow is already running
+     * If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)
      */
     no_flow_overlap?: boolean;
     /**
-     * The summary of the schedule
+     * Short summary describing the purpose of this schedule
      */
     summary?: string;
     /**
-     * The description of the schedule
+     * Detailed description of what this schedule does
      */
     description?: string;
     /**
-     * The tag of the schedule
+     * Worker tag to route jobs to specific worker groups
      */
     tag?: string;
     /**
-     * The date and time the schedule will be paused until
+     * ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time
      */
     paused_until?: string;
     /**
-     * The version of the cron schedule to use (last is v2)
+     * Cron parser version. Use 'v2' for extended syntax with additional features
      */
     cron_version?: string;
     /**
-     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.
+     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)
      */
     dynamic_skip?: string;
 };
 export type EditSchedule = {
     /**
-     * The cron schedule to trigger the script or flow. Should include seconds.
+     * Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon
      */
     schedule: string;
     /**
-     * The timezone to use for the cron schedule
+     * IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')
      */
     timezone: string;
-    /**
-     * The arguments to pass to the script or flow
-     */
     args: ScriptArgs;
     /**
-     * The path to the script or flow to trigger on failure
+     * Path to a script or flow to run when the scheduled job fails
      */
     on_failure?: string;
     /**
-     * The number of times to retry on failure
+     * Number of consecutive failures before the on_failure handler is triggered (default 1)
      */
     on_failure_times?: number;
     /**
-     * Whether the schedule should only run on the exact time
+     * If true, trigger on_failure handler only on exactly N failures, not on every failure after N
      */
     on_failure_exact?: boolean;
-    /**
-     * The arguments to pass to the script or flow on failure
-     */
     on_failure_extra_args?: ScriptArgs;
     /**
-     * The path to the script or flow to trigger on recovery
+     * Path to a script or flow to run when the schedule recovers after failures
      */
     on_recovery?: string;
     /**
-     * The number of times to retry on recovery
+     * Number of consecutive successes before the on_recovery handler is triggered (default 1)
      */
     on_recovery_times?: number;
-    /**
-     * The arguments to pass to the script or flow on recovery
-     */
     on_recovery_extra_args?: ScriptArgs;
     /**
-     * The path to the script or flow to trigger on success
+     * Path to a script or flow to run after each successful execution
      */
     on_success?: string;
-    /**
-     * The arguments to pass to the script or flow on success
-     */
     on_success_extra_args?: ScriptArgs;
     /**
-     * Whether the WebSocket error handler is muted
+     * If true, the workspace-level error handler will not be triggered for this schedule's failures
      */
     ws_error_handler_muted?: boolean;
-    /**
-     * The retry configuration for the schedule
-     */
     retry?: Retry;
     /**
-     * Whether the schedule should not run if a flow is already running
+     * If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)
      */
     no_flow_overlap?: boolean;
     /**
-     * The summary of the schedule
+     * Short summary describing the purpose of this schedule
      */
     summary?: string;
     /**
-     * The description of the schedule
+     * Detailed description of what this schedule does
      */
     description?: string;
     /**
-     * The tag of the schedule
+     * Worker tag to route jobs to specific worker groups
      */
     tag?: string;
     /**
-     * The date and time the schedule will be paused until
+     * ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time
      */
     paused_until?: string;
     /**
-     * The version of the cron schedule to use (last is v2)
+     * Cron parser version. Use 'v2' for extended syntax with additional features
      */
     cron_version?: string;
     /**
-     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.
+     * Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)
      */
     dynamic_skip?: string;
 };
@@ -1967,16 +2110,43 @@ export type JobTriggerKind = 'webhook' | 'default_email' | 'email' | 'schedule'
  */
 export type TriggerMode = 'enabled' | 'disabled' | 'suspended';
 export type TriggerExtraProperty = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when triggered
+     */
     script_path: string;
+    /**
+     * Email of the user who owns this trigger, used for permissioned_as
+     */
     email: string;
+    /**
+     * Additional permissions for this trigger
+     */
     extra_perms: {
         [key: string]: (boolean);
     };
+    /**
+     * The workspace this trigger belongs to
+     */
     workspace_id: string;
+    /**
+     * Username of the last person who edited this trigger
+     */
     edited_by: string;
+    /**
+     * Timestamp of the last edit
+     */
     edited_at: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Trigger mode (enabled/disabled)
+     */
     mode: TriggerMode;
 };
 export type AuthenticationMethod = 'none' | 'windmill' | 'api_key' | 'basic_http' | 'custom_script' | 'signature';
@@ -2020,82 +2190,262 @@ export type GenerateOpenapiSpec = {
 export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch';
 export type HttpRequestType = 'sync' | 'async' | 'sync_sse';
 export type HttpTrigger = TriggerExtraProperty & {
+    /**
+     * The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /.
+     */
     route_path: string;
+    /**
+     * Configuration for serving static assets (s3 bucket, storage path, filename)
+     */
     static_asset_config?: {
+        /**
+         * S3 bucket path for static assets
+         */
         s3: string;
+        /**
+         * Storage path for static assets
+         */
         storage?: string;
+        /**
+         * Filename for the static asset
+         */
         filename?: string;
     };
+    /**
+     * HTTP method (get, post, put, delete, patch) that triggers this endpoint
+     */
     http_method: HttpMethod;
+    /**
+     * Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)
+     */
     authentication_resource_path?: string;
+    /**
+     * Short summary describing the purpose of this trigger
+     */
     summary?: string;
+    /**
+     * Detailed description of what this trigger does
+     */
     description?: string;
+    /**
+     * How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events
+     */
     request_type: HttpRequestType;
+    /**
+     * How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'
+     */
     authentication_method: AuthenticationMethod;
+    /**
+     * If true, serves static files from S3/storage instead of running a script
+     */
     is_static_website: boolean;
+    /**
+     * If true, the route includes the workspace ID in the path
+     */
     workspaced_route: boolean;
+    /**
+     * If true, wraps the request body in a 'body' parameter
+     */
     wrap_body: boolean;
+    /**
+     * If true, passes the request body as a raw string instead of parsing as JSON
+     */
     raw_string: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewHttpTrigger = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when triggered
+     */
     script_path: string;
+    /**
+     * The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /.
+     */
     route_path: string;
+    /**
+     * If true, the route includes the workspace ID in the path
+     */
     workspaced_route?: boolean;
+    /**
+     * Short summary describing the purpose of this trigger
+     */
     summary?: string;
+    /**
+     * Detailed description of what this trigger does
+     */
     description?: string;
+    /**
+     * Configuration for serving static assets (s3 bucket, storage path, filename)
+     */
     static_asset_config?: {
+        /**
+         * S3 bucket path for static assets
+         */
         s3: string;
+        /**
+         * Storage path for static assets
+         */
         storage?: string;
+        /**
+         * Filename for the static asset
+         */
         filename?: string;
     };
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * HTTP method (get, post, put, delete, patch) that triggers this endpoint
+     */
     http_method: HttpMethod;
+    /**
+     * Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)
+     */
     authentication_resource_path?: string;
     /**
      * Deprecated, use request_type instead
      */
     is_async?: boolean;
+    /**
+     * How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events
+     */
     request_type?: HttpRequestType;
+    /**
+     * How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'
+     */
     authentication_method: AuthenticationMethod;
+    /**
+     * If true, serves static files from S3/storage instead of running a script
+     */
     is_static_website: boolean;
+    /**
+     * If true, wraps the request body in a 'body' parameter
+     */
     wrap_body?: boolean;
     mode?: TriggerMode;
+    /**
+     * If true, passes the request body as a raw string instead of parsing as JSON
+     */
     raw_string?: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditHttpTrigger = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when triggered
+     */
     script_path: string;
+    /**
+     * The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /.
+     */
     route_path?: string;
+    /**
+     * Short summary describing the purpose of this trigger
+     */
     summary?: string;
+    /**
+     * Detailed description of what this trigger does
+     */
     description?: string;
+    /**
+     * If true, the route includes the workspace ID in the path
+     */
     workspaced_route?: boolean;
+    /**
+     * Configuration for serving static assets (s3 bucket, storage path, filename)
+     */
     static_asset_config?: {
+        /**
+         * S3 bucket path for static assets
+         */
         s3: string;
+        /**
+         * Storage path for static assets
+         */
         storage?: string;
+        /**
+         * Filename for the static asset
+         */
         filename?: string;
     };
+    /**
+     * Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)
+     */
     authentication_resource_path?: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * HTTP method (get, post, put, delete, patch) that triggers this endpoint
+     */
     http_method: HttpMethod;
     /**
      * Deprecated, use request_type instead
      */
     is_async?: boolean;
+    /**
+     * How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events
+     */
     request_type?: HttpRequestType;
+    /**
+     * How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'
+     */
     authentication_method: AuthenticationMethod;
+    /**
+     * If true, serves static files from S3/storage instead of running a script
+     */
     is_static_website: boolean;
+    /**
+     * If true, wraps the request body in a 'body' parameter
+     */
     wrap_body?: boolean;
+    /**
+     * If true, passes the request body as a raw string instead of parsing as JSON
+     */
     raw_string?: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
-    retry?: Retry;
+    /**
+     * Retry configuration for failed executions
+     */
+    retry?: Retry;
 };
 export type TriggersCount = {
     primary_schedule?: {
@@ -2116,55 +2466,163 @@ export type TriggersCount = {
     nextcloud_count?: number;
 };
 export type WebsocketTrigger = TriggerExtraProperty & {
+    /**
+     * The WebSocket URL to connect to (can be a static URL or computed by a runnable)
+     */
     url: string;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Array of key-value filters to match incoming messages (only matching messages trigger the script)
+     */
     filters: Array<{
         key: string;
         value: unknown;
     }>;
+    /**
+     * Messages to send immediately after connecting (can be raw strings or computed by runnables)
+     */
     initial_messages?: Array<WebsocketTriggerInitialMessage>;
+    /**
+     * Arguments to pass to the script/flow that computes the WebSocket URL
+     */
     url_runnable_args?: ScriptArgs;
+    /**
+     * If true, the script can return a message to send back through the WebSocket
+     */
     can_return_message: boolean;
+    /**
+     * If true, error results are sent back through the WebSocket
+     */
     can_return_error_result: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewWebsocketTrigger = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * The WebSocket URL to connect to (can be a static URL or computed by a runnable)
+     */
     url: string;
     mode?: TriggerMode;
+    /**
+     * Array of key-value filters to match incoming messages (only matching messages trigger the script)
+     */
     filters: Array<{
         key: string;
         value: unknown;
     }>;
+    /**
+     * Messages to send immediately after connecting (can be raw strings or computed by runnables)
+     */
     initial_messages?: Array<WebsocketTriggerInitialMessage>;
+    /**
+     * Arguments to pass to the script/flow that computes the WebSocket URL
+     */
     url_runnable_args?: ScriptArgs;
+    /**
+     * If true, the script can return a message to send back through the WebSocket
+     */
     can_return_message: boolean;
+    /**
+     * If true, error results are sent back through the WebSocket
+     */
     can_return_error_result: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditWebsocketTrigger = {
+    /**
+     * The WebSocket URL to connect to (can be a static URL or computed by a runnable)
+     */
     url: string;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Array of key-value filters to match incoming messages (only matching messages trigger the script)
+     */
     filters: Array<{
         key: string;
         value: unknown;
     }>;
+    /**
+     * Messages to send immediately after connecting (can be raw strings or computed by runnables)
+     */
     initial_messages?: Array<WebsocketTriggerInitialMessage>;
+    /**
+     * Arguments to pass to the script/flow that computes the WebSocket URL
+     */
     url_runnable_args?: ScriptArgs;
+    /**
+     * If true, the script can return a message to send back through the WebSocket
+     */
     can_return_message: boolean;
+    /**
+     * If true, error results are sent back through the WebSocket
+     */
     can_return_error_result: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type WebsocketTriggerInitialMessage = {
@@ -2191,91 +2649,277 @@ export type MqttSubscribeTopic = {
 };
 export type MqttClientVersion = 'v3' | 'v5';
 export type MqttTrigger = TriggerExtraProperty & {
+    /**
+     * Path to the MQTT resource containing broker connection configuration
+     */
     mqtt_resource_path: string;
+    /**
+     * Array of MQTT topics to subscribe to, each with topic name and QoS level
+     */
     subscribe_topics: Array<MqttSubscribeTopic>;
+    /**
+     * MQTT v3 specific configuration (clean_session)
+     */
     v3_config?: MqttV3Config;
+    /**
+     * MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)
+     */
     v5_config?: MqttV5Config;
+    /**
+     * MQTT client ID for this connection
+     */
     client_id?: string;
+    /**
+     * MQTT protocol version ('v3' or 'v5')
+     */
     client_version?: MqttClientVersion;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewMqttTrigger = {
+    /**
+     * Path to the MQTT resource containing broker connection configuration
+     */
     mqtt_resource_path: string;
+    /**
+     * Array of MQTT topics to subscribe to, each with topic name and QoS level
+     */
     subscribe_topics: Array<MqttSubscribeTopic>;
+    /**
+     * MQTT client ID for this connection
+     */
     client_id?: string;
+    /**
+     * MQTT v3 specific configuration (clean_session)
+     */
     v3_config?: MqttV3Config;
+    /**
+     * MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)
+     */
     v5_config?: MqttV5Config;
+    /**
+     * MQTT protocol version ('v3' or 'v5')
+     */
     client_version?: MqttClientVersion;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditMqttTrigger = {
+    /**
+     * Path to the MQTT resource containing broker connection configuration
+     */
     mqtt_resource_path: string;
+    /**
+     * Array of MQTT topics to subscribe to, each with topic name and QoS level
+     */
     subscribe_topics: Array<MqttSubscribeTopic>;
+    /**
+     * MQTT client ID for this connection
+     */
     client_id?: string;
+    /**
+     * MQTT v3 specific configuration (clean_session)
+     */
     v3_config?: MqttV3Config;
+    /**
+     * MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)
+     */
     v5_config?: MqttV5Config;
+    /**
+     * MQTT protocol version ('v3' or 'v5')
+     */
     client_version?: MqttClientVersion;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
+/**
+ * Delivery mode for messages. 'push' for HTTP push delivery where messages are sent to a webhook endpoint, 'pull' for polling where the trigger actively fetches messages.
+ */
 export type DeliveryType = 'push' | 'pull';
+/**
+ * Configuration for push delivery mode.
+ */
 export type PushConfig = {
+    /**
+     * The audience claim for OIDC tokens used in push authentication.
+     */
     audience?: string;
+    /**
+     * If true, push messages will include OIDC authentication tokens.
+     */
     authenticate: boolean;
 };
+/**
+ * A Google Cloud Pub/Sub trigger that executes a script or flow when messages are received.
+ */
 export type GcpTrigger = TriggerExtraProperty & {
+    /**
+     * Path to the GCP resource containing service account credentials for authentication.
+     */
     gcp_resource_path: string;
+    /**
+     * Google Cloud Pub/Sub topic ID to subscribe to.
+     */
     topic_id: string;
+    /**
+     * Google Cloud Pub/Sub subscription ID.
+     */
     subscription_id: string;
+    /**
+     * ID of the server currently handling this trigger (internal use).
+     */
     server_id?: string;
     delivery_type: DeliveryType;
     delivery_config?: PushConfig;
     subscription_mode: SubscriptionMode;
+    /**
+     * Timestamp of last server heartbeat (internal use).
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed.
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails.
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler.
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions.
+     */
     retry?: Retry;
 };
 /**
  * The mode of subscription. 'existing' means using an existing GCP subscription, while 'create_update' involves creating or updating a new subscription.
  */
 export type SubscriptionMode = 'existing' | 'create_update';
+/**
+ * Data for creating or updating a Google Cloud Pub/Sub trigger.
+ */
 export type GcpTriggerData = {
+    /**
+     * Path to the GCP resource containing service account credentials for authentication.
+     */
     gcp_resource_path: string;
     subscription_mode: SubscriptionMode;
+    /**
+     * Google Cloud Pub/Sub topic ID to subscribe to.
+     */
     topic_id: string;
+    /**
+     * Google Cloud Pub/Sub subscription ID.
+     */
     subscription_id?: string;
+    /**
+     * Base URL for push delivery endpoint.
+     */
     base_endpoint?: string;
     delivery_type?: DeliveryType;
     delivery_config?: PushConfig;
+    /**
+     * The unique path identifier for this trigger.
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received.
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script.
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * If true, automatically acknowledge messages after processing.
+     */
     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).
      */
     ack_deadline?: number;
+    /**
+     * Path to a script or flow to run when the triggered job fails.
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler.
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions.
+     */
     retry?: Retry;
 };
 export type GetAllTopicSubscription = {
@@ -2286,15 +2930,45 @@ export type DeleteGcpSubscription = {
 };
 export type AwsAuthResourceType = 'oidc' | 'credentials';
 export type SqsTrigger = TriggerExtraProperty & {
+    /**
+     * The full URL of the AWS SQS queue to poll for messages
+     */
     queue_url: string;
+    /**
+     * Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect
+     */
     aws_auth_resource_type: AwsAuthResourceType;
+    /**
+     * Path to the AWS resource containing credentials or OIDC configuration
+     */
     aws_resource_path: string;
+    /**
+     * Array of SQS message attribute names to include with each message
+     */
     message_attributes?: Array<(string)>;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type LoggedWizardStatus = 'OK' | 'SKIP' | 'FAIL';
@@ -2320,29 +2994,89 @@ export type CustomInstanceDb = {
     tag?: CustomInstanceDbTag;
 };
 export type NewSqsTrigger = {
+    /**
+     * The full URL of the AWS SQS queue to poll for messages
+     */
     queue_url: string;
+    /**
+     * Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect
+     */
     aws_auth_resource_type: AwsAuthResourceType;
+    /**
+     * Path to the AWS resource containing credentials or OIDC configuration
+     */
     aws_resource_path: string;
+    /**
+     * Array of SQS message attribute names to include with each message
+     */
     message_attributes?: Array<(string)>;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditSqsTrigger = {
+    /**
+     * The full URL of the AWS SQS queue to poll for messages
+     */
     queue_url: string;
+    /**
+     * Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect
+     */
     aws_auth_resource_type: AwsAuthResourceType;
+    /**
+     * Path to the AWS resource containing credentials or OIDC configuration
+     */
     aws_resource_path: string;
+    /**
+     * Array of SQS message attribute names to include with each message
+     */
     message_attributes?: Array<(string)>;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type Slot = {
@@ -2372,126 +3106,393 @@ export type TemplateScript = {
     language: Language;
 };
 export type PostgresTrigger = TriggerExtraProperty & {
+    /**
+     * Path to the PostgreSQL resource containing connection configuration
+     */
     postgres_resource_path: string;
+    /**
+     * Name of the PostgreSQL publication to subscribe to for change data capture
+     */
     publication_name: string;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Name of the PostgreSQL logical replication slot to use
+     */
     replication_slot_name: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewPostgresTrigger = {
+    /**
+     * Name of the PostgreSQL logical replication slot to use
+     */
     replication_slot_name?: string;
+    /**
+     * Name of the PostgreSQL publication to subscribe to for change data capture
+     */
     publication_name?: string;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when database changes are detected
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to the PostgreSQL resource containing connection configuration
+     */
     postgres_resource_path: string;
+    /**
+     * Configuration for creating/managing the publication (tables, operations)
+     */
     publication?: PublicationData;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditPostgresTrigger = {
+    /**
+     * Name of the PostgreSQL logical replication slot to use
+     */
     replication_slot_name: string;
+    /**
+     * Name of the PostgreSQL publication to subscribe to for change data capture
+     */
     publication_name: string;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when database changes are detected
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
     mode?: TriggerMode;
+    /**
+     * Path to the PostgreSQL resource containing connection configuration
+     */
     postgres_resource_path: string;
+    /**
+     * Configuration for creating/managing the publication (tables, operations)
+     */
     publication?: PublicationData;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type KafkaTrigger = TriggerExtraProperty & {
+    /**
+     * Path to the Kafka resource containing connection configuration
+     */
     kafka_resource_path: string;
+    /**
+     * Kafka consumer group ID for this trigger
+     */
     group_id: string;
+    /**
+     * Array of Kafka topic names to subscribe to
+     */
     topics: Array<(string)>;
     filters: Array<{
         key: string;
         value: unknown;
     }>;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewKafkaTrigger = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Path to the Kafka resource containing connection configuration
+     */
     kafka_resource_path: string;
+    /**
+     * Kafka consumer group ID for this trigger
+     */
     group_id: string;
+    /**
+     * Array of Kafka topic names to subscribe to
+     */
     topics: Array<(string)>;
     filters: Array<{
         key: string;
         value: unknown;
     }>;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditKafkaTrigger = {
+    /**
+     * Path to the Kafka resource containing connection configuration
+     */
     kafka_resource_path: string;
+    /**
+     * Kafka consumer group ID for this trigger
+     */
     group_id: string;
+    /**
+     * Array of Kafka topic names to subscribe to
+     */
     topics: Array<(string)>;
     filters: Array<{
         key: string;
         value: unknown;
     }>;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NatsTrigger = TriggerExtraProperty & {
+    /**
+     * Path to the NATS resource containing connection configuration
+     */
     nats_resource_path: string;
+    /**
+     * If true, uses NATS JetStream for durable message delivery
+     */
     use_jetstream: boolean;
+    /**
+     * JetStream stream name (required when use_jetstream is true)
+     */
     stream_name?: string;
+    /**
+     * JetStream consumer name (required when use_jetstream is true)
+     */
     consumer_name?: string;
+    /**
+     * Array of NATS subjects to subscribe to
+     */
     subjects: Array<(string)>;
+    /**
+     * ID of the server currently handling this trigger (internal)
+     */
     server_id?: string;
+    /**
+     * Timestamp of last server heartbeat (internal)
+     */
     last_server_ping?: string;
+    /**
+     * Last error message if the trigger failed
+     */
     error?: string;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type NewNatsTrigger = {
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Path to the NATS resource containing connection configuration
+     */
     nats_resource_path: string;
+    /**
+     * If true, uses NATS JetStream for durable message delivery
+     */
     use_jetstream: boolean;
+    /**
+     * JetStream stream name (required when use_jetstream is true)
+     */
     stream_name?: string;
+    /**
+     * JetStream consumer name (required when use_jetstream is true)
+     */
     consumer_name?: string;
+    /**
+     * Array of NATS subjects to subscribe to
+     */
     subjects: Array<(string)>;
     mode?: TriggerMode;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EditNatsTrigger = {
+    /**
+     * Path to the NATS resource containing connection configuration
+     */
     nats_resource_path: string;
+    /**
+     * If true, uses NATS JetStream for durable message delivery
+     */
     use_jetstream: boolean;
+    /**
+     * JetStream stream name (required when use_jetstream is true)
+     */
     stream_name?: string;
+    /**
+     * JetStream consumer name (required when use_jetstream is true)
+     */
     consumer_name?: string;
+    /**
+     * Array of NATS subjects to subscribe to
+     */
     subjects: Array<(string)>;
+    /**
+     * The unique path identifier for this trigger
+     */
     path: string;
+    /**
+     * Path to the script or flow to execute when a message is received
+     */
     script_path: string;
+    /**
+     * True if script_path points to a flow, false if it points to a script
+     */
     is_flow: boolean;
+    /**
+     * Path to a script or flow to run when the triggered job fails
+     */
     error_handler_path?: string;
+    /**
+     * Arguments to pass to the error handler
+     */
     error_handler_args?: ScriptArgs;
+    /**
+     * Retry configuration for failed executions
+     */
     retry?: Retry;
 };
 export type EmailTrigger = TriggerExtraProperty & {
@@ -3161,7 +4162,7 @@ export type WorkspaceItemDiff = {
 /**
  * Type of the item
  */
-export type kind3 = 'script' | 'flow' | 'app' | 'resource' | 'variable' | 'resource_type';
+export type kind5 = 'script' | 'flow' | 'app' | 'resource' | 'variable' | 'resource_type';
 export type CompareSummary = {
     /**
      * Total number of items with differences