windmill-components 1.623.2 → 1.642.0

package/package/gen/schemas.gen.js

@@ -17,6 +17,10 @@ export const $OpenFlow = {
         schema: {
             type: 'object',
             description: "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')"
+        },
+        on_behalf_of_email: {
+            type: 'string',
+            description: 'The flow will be run with the permissions of the user with this email.'
         }
     },
     required: ['summary', 'value']
@@ -327,13 +331,17 @@ export const $InputTransform = {
         },
         {
             '$ref': '#/components/schemas/JavascriptTransform'
+        },
+        {
+            '$ref': '#/components/schemas/AiTransform'
         }
     ],
     discriminator: {
         propertyName: 'type',
         mapping: {
             static: '#/components/schemas/StaticTransform',
-            javascript: '#/components/schemas/JavascriptTransform'
+            javascript: '#/components/schemas/JavascriptTransform',
+            ai: '#/components/schemas/AiTransform'
         }
     }
 };
@@ -366,6 +374,108 @@ export const $JavascriptTransform = {
     },
     required: ['expr', 'type']
 };
+export const $AiTransform = {
+    type: 'object',
+    description: 'Value resolved by the AI runtime for this input. The AI engine decides how to satisfy the parameter.',
+    properties: {
+        type: {
+            type: 'string',
+            enum: ['ai']
+        }
+    },
+    required: ['type']
+};
+export const $ProviderConfig = {
+    type: 'object',
+    description: 'Complete AI provider configuration with resource reference and model selection',
+    properties: {
+        kind: {
+            type: 'string',
+            description: 'Supported AI provider types',
+            enum: ['openai', 'azure_openai', 'anthropic', 'mistral', 'deepseek', 'googleai', 'groq', 'openrouter', 'togetherai', 'customai', 'aws_bedrock']
+        },
+        resource: {
+            type: 'string',
+            description: "Resource reference in format '$res:{resource_path}' pointing to provider credentials"
+        },
+        model: {
+            type: 'string',
+            description: "Model identifier (e.g., 'gpt-4', 'claude-3-opus-20240229', 'gemini-pro')"
+        }
+    },
+    required: ['kind', 'resource', 'model']
+};
+export const $MemoryConfig = {
+    description: 'Conversation memory configuration',
+    oneOf: [
+        {
+            type: 'object',
+            description: 'No conversation memory/context',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['off']
+                }
+            },
+            required: ['kind']
+        },
+        {
+            type: 'object',
+            description: 'Automatic context management',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['auto']
+                },
+                context_length: {
+                    type: 'integer',
+                    description: 'Maximum number of messages to retain in context'
+                },
+                memory_id: {
+                    type: 'string',
+                    description: 'Identifier for persistent memory across agent invocations'
+                }
+            },
+            required: ['kind']
+        },
+        {
+            type: 'object',
+            description: 'Explicit message history',
+            properties: {
+                kind: {
+                    type: 'string',
+                    enum: ['manual']
+                },
+                messages: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        description: 'A single message in conversation history',
+                        properties: {
+                            role: {
+                                type: 'string',
+                                enum: ['user', 'assistant', 'system']
+                            },
+                            content: {
+                                type: 'string'
+                            }
+                        },
+                        required: ['role', 'content']
+                    }
+                }
+            },
+            required: ['kind', 'messages']
+        }
+    ],
+    discriminator: {
+        propertyName: 'kind',
+        mapping: {
+            off: '#/components/schemas/MemoryOff',
+            auto: '#/components/schemas/MemoryAuto',
+            manual: '#/components/schemas/MemoryManual'
+        }
+    }
+};
 export const $FlowModuleValue = {
     description: 'The actual implementation of a flow step. Can be a script (inline or referenced), subflow, loop, branch, or special module type',
     oneOf: [
@@ -430,7 +540,7 @@ export const $RawScript = {
         language: {
             type: 'string',
             description: 'Programming language for this script',
-            enum: ['deno', 'bun', 'python3', 'go', 'bash', 'powershell', 'postgresql', 'mysql', 'bigquery', 'snowflake', 'mssql', 'oracledb', 'graphql', 'nativets', 'php']
+            enum: ['deno', 'bun', 'python3', 'go', 'bash', 'powershell', 'postgresql', 'mysql', 'bigquery', 'snowflake', 'mssql', 'oracledb', 'graphql', 'nativets', 'php', 'rust', 'ansible', 'csharp', 'nu', 'java', 'ruby', 'duckdb']
         },
         path: {
             type: 'string',
@@ -482,11 +592,13 @@ export const $RawScript = {
                     },
                     access_type: {
                         type: 'string',
+                        nullable: true,
                         description: 'Access level for this asset',
                         enum: ['r', 'w', 'rw']
                     },
                     alt_access_type: {
                         type: 'string',
+                        nullable: true,
                         description: 'Alternative access level',
                         enum: ['r', 'w', 'rw']
                     }
@@ -714,34 +826,151 @@ export const $AiAgent = {
             description: 'Input parameters for the AI agent mapped to their values',
             properties: {
                 provider: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    description: 'Provider configuration - can be static (ProviderConfig), JavaScript expression, or AI-determined',
+                    oneOf: [
+                        {
+                            type: 'object',
+                            description: 'Static provider configuration passed directly to the AI agent',
+                            properties: {
+                                value: {
+                                    '$ref': '#/components/schemas/ProviderConfig'
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['static']
+                                }
+                            },
+                            required: ['type', 'value']
+                        },
+                        {
+                            '$ref': '#/components/schemas/JavascriptTransform'
+                        },
+                        {
+                            '$ref': '#/components/schemas/AiTransform'
+                        }
+                    ],
+                    discriminator: {
+                        propertyName: 'type',
+                        mapping: {
+                            static: '#/components/schemas/StaticProviderTransform',
+                            javascript: '#/components/schemas/JavascriptTransform',
+                            ai: '#/components/schemas/AiTransform'
+                        }
+                    }
                 },
                 output_type: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `Output format type.
+Valid values: 'text' (default) - plain text response, 'image' - image generation
+`
                 },
                 user_message: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: "The user's prompt/message to the AI agent. Supports variable interpolation with flow.input syntax."
                 },
                 system_prompt: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: "System instructions that guide the AI's behavior, persona, and response style. Optional."
                 },
                 streaming: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `Boolean. If true, stream the AI response incrementally.
+Streaming events include: token_delta, tool_call, tool_call_arguments, tool_execution, tool_result
+`
                 },
                 memory: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    description: 'Memory configuration - can be static (MemoryConfig), JavaScript expression, or AI-determined',
+                    oneOf: [
+                        {
+                            type: 'object',
+                            description: 'Static memory configuration passed directly to the AI agent',
+                            properties: {
+                                value: {
+                                    '$ref': '#/components/schemas/MemoryConfig'
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['static']
+                                }
+                            },
+                            required: ['type', 'value']
+                        },
+                        {
+                            '$ref': '#/components/schemas/JavascriptTransform'
+                        },
+                        {
+                            '$ref': '#/components/schemas/AiTransform'
+                        }
+                    ],
+                    discriminator: {
+                        propertyName: 'type',
+                        mapping: {
+                            static: '#/components/schemas/StaticMemoryTransform',
+                            javascript: '#/components/schemas/JavascriptTransform',
+                            ai: '#/components/schemas/AiTransform'
+                        }
+                    }
                 },
                 output_schema: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `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'] }
+`
                 },
                 user_images: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `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' }]
+`
                 },
                 max_completion_tokens: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `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.
+`
                 },
                 temperature: {
-                    '$ref': '#/components/schemas/InputTransform'
+                    allOf: [
+                        {
+                            '$ref': '#/components/schemas/InputTransform'
+                        }
+                    ],
+                    description: `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
+`
                 }
             },
             required: ['provider', 'user_message', 'output_type']
@@ -1178,6 +1407,179 @@ export const $FlowNote = {
     },
     required: ['id', 'text', 'color', 'type']
 };
+export const $HealthStatusResponse = {
+    type: 'object',
+    description: 'Health status response (cached with 5s TTL)',
+    required: ['status', 'checked_at', 'database_healthy', 'workers_alive'],
+    properties: {
+        status: {
+            type: 'string',
+            enum: ['healthy', 'degraded', 'unhealthy'],
+            description: 'Overall health status'
+        },
+        checked_at: {
+            type: 'string',
+            format: 'date-time',
+            description: 'Timestamp when the health check was actually performed (not cache return time)'
+        },
+        database_healthy: {
+            type: 'boolean',
+            description: 'Whether the database is reachable'
+        },
+        workers_alive: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of workers that pinged within last 5 minutes'
+        }
+    }
+};
+export const $DetailedHealthResponse = {
+    type: 'object',
+    description: 'Detailed health status response (always fresh, no caching)',
+    required: ['status', 'checked_at', 'version', 'checks'],
+    properties: {
+        status: {
+            type: 'string',
+            enum: ['healthy', 'degraded', 'unhealthy'],
+            description: 'Overall health status'
+        },
+        checked_at: {
+            type: 'string',
+            format: 'date-time',
+            description: 'Timestamp when the health check was performed'
+        },
+        version: {
+            type: 'string',
+            description: 'Server version (e.g., "EE 1.615.3")'
+        },
+        checks: {
+            '$ref': '#/components/schemas/HealthChecks'
+        }
+    }
+};
+export const $HealthChecks = {
+    type: 'object',
+    description: 'Detailed health checks',
+    required: ['database', 'readiness'],
+    properties: {
+        database: {
+            '$ref': '#/components/schemas/DatabaseHealth'
+        },
+        workers: {
+            '$ref': '#/components/schemas/WorkersHealth',
+            description: 'Worker status (null if database is unreachable)',
+            nullable: true
+        },
+        queue: {
+            '$ref': '#/components/schemas/QueueHealth',
+            description: 'Queue status (null if database is unreachable)',
+            nullable: true
+        },
+        readiness: {
+            '$ref': '#/components/schemas/ReadinessHealth'
+        }
+    }
+};
+export const $DatabaseHealth = {
+    type: 'object',
+    description: 'Database health status',
+    required: ['healthy', 'latency_ms', 'pool'],
+    properties: {
+        healthy: {
+            type: 'boolean',
+            description: 'Whether the database is reachable'
+        },
+        latency_ms: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Database query latency in milliseconds'
+        },
+        pool: {
+            '$ref': '#/components/schemas/PoolStats'
+        }
+    }
+};
+export const $PoolStats = {
+    type: 'object',
+    description: 'Database connection pool statistics',
+    required: ['size', 'idle', 'max_connections'],
+    properties: {
+        size: {
+            type: 'integer',
+            description: 'Current number of connections in the pool'
+        },
+        idle: {
+            type: 'integer',
+            description: 'Number of idle connections'
+        },
+        max_connections: {
+            type: 'integer',
+            description: 'Maximum number of connections allowed'
+        }
+    }
+};
+export const $WorkersHealth = {
+    type: 'object',
+    description: 'Workers health status',
+    required: ['healthy', 'active_count', 'worker_groups', 'min_version', 'versions'],
+    properties: {
+        healthy: {
+            type: 'boolean',
+            description: 'Whether any workers are active'
+        },
+        active_count: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of active workers (pinged in last 5 minutes)'
+        },
+        worker_groups: {
+            type: 'array',
+            items: {
+                type: 'string'
+            },
+            description: 'List of active worker groups'
+        },
+        min_version: {
+            type: 'string',
+            description: 'Minimum required worker version'
+        },
+        versions: {
+            type: 'array',
+            items: {
+                type: 'string'
+            },
+            description: 'List of active worker versions'
+        }
+    }
+};
+export const $QueueHealth = {
+    type: 'object',
+    description: 'Job queue status',
+    required: ['pending_jobs', 'running_jobs'],
+    properties: {
+        pending_jobs: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of pending jobs in the queue'
+        },
+        running_jobs: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of currently running jobs'
+        }
+    }
+};
+export const $ReadinessHealth = {
+    type: 'object',
+    description: 'Server readiness status',
+    required: ['healthy'],
+    properties: {
+        healthy: {
+            type: 'boolean',
+            description: 'Whether the server is ready to accept requests'
+        }
+    }
+};
 export const $AutoInviteConfig = {
     type: 'object',
     description: 'Configuration for auto-inviting users to the workspace',
@@ -2022,7 +2424,7 @@ export const $ScriptHistory = {
 export const $ScriptArgs = {
     type: 'object',
     description: 'The arguments to pass to the script or flow',
-    additionalProperties: {}
+    additionalProperties: true
 };
 export const $Input = {
     type: 'object',
@@ -3186,7 +3588,7 @@ export const $MainArgSignature = {
 };
 export const $ScriptLang = {
     type: 'string',
-    enum: ['python3', 'deno', 'go', 'bash', 'powershell', 'postgresql', 'mysql', 'bigquery', 'snowflake', 'mssql', 'oracledb', 'graphql', 'nativets', 'bun', 'php', 'rust', 'ansible', 'csharp', 'nu', 'java', 'ruby', 'duckdb']
+    enum: ['python3', 'deno', 'go', 'bash', 'powershell', 'postgresql', 'mysql', 'bigquery', 'snowflake', 'mssql', 'oracledb', 'graphql', 'nativets', 'bun', 'php', 'rust', 'ansible', 'csharp', 'nu', 'java', 'ruby', 'duckdb', 'bunnative']
 };
 export const $Preview = {
     type: 'object',
@@ -3436,100 +3838,142 @@ export const $Schedule = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this schedule'
         },
         edited_by: {
-            type: 'string'
+            type: 'string',
+            description: 'Username of the last person who edited this schedule'
         },
         edited_at: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of the last edit'
         },
         schedule: {
-            type: 'string'
+            type: 'string',
+            description: "Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon"
         },
         timezone: {
-            type: 'string'
+            type: 'string',
+            description: "IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')"
         },
         enabled: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'Whether the schedule is currently active and will trigger jobs'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when triggered'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            nullable: true
         },
         extra_perms: {
             type: 'object',
             additionalProperties: {
                 type: 'boolean'
-            }
+            },
+            description: 'Additional permissions for this schedule'
         },
         email: {
-            type: 'string'
+            type: 'string',
+            description: 'Email of the user who owns this schedule, used for permissioned_as'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Last error message if the schedule failed to trigger'
         },
         on_failure: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to a script or flow to run when the scheduled job fails'
         },
         on_failure_times: {
-            type: 'number'
+            type: 'number',
+            nullable: true,
+            description: 'Number of consecutive failures before the on_failure handler is triggered (default 1)'
         },
         on_failure_exact: {
-            type: 'boolean'
+            type: 'boolean',
+            nullable: true,
+            description: 'If true, trigger on_failure handler only on exactly N failures, not on every failure after N'
         },
         on_failure_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            nullable: true
         },
         on_recovery: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to a script or flow to run when the schedule recovers after failures'
         },
         on_recovery_times: {
-            type: 'number'
+            type: 'number',
+            nullable: true,
+            description: 'Number of consecutive successes before the on_recovery handler is triggered (default 1)'
         },
         on_recovery_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            nullable: true
         },
         on_success: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to a script or flow to run after each successful execution'
         },
         on_success_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            nullable: true
         },
         ws_error_handler_muted: {
-            type: 'boolean'
+            type: 'boolean',
+            description: "If true, the workspace-level error handler will not be triggered for this schedule's failures"
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            nullable: true
         },
         summary: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Short summary describing the purpose of this schedule'
         },
         description: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Detailed description of what this schedule does'
         },
         no_flow_overlap: {
-            type: 'boolean'
+            type: 'boolean',
+            description: "If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)"
         },
         tag: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Worker tag to route jobs to specific worker groups'
         },
         paused_until: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            nullable: true,
+            description: 'ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time'
         },
         cron_version: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: "Cron parser version. Use 'v2' for extended syntax with additional features"
         },
         dynamic_skip: {
             type: 'string',
-            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.'
+            nullable: true,
+            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)'
         }
     },
     required: ['path', 'edited_by', 'edited_at', 'schedule', 'script_path', 'timezone', 'extra_perms', 'is_flow', 'enabled', 'email']
@@ -3573,104 +4017,116 @@ export const $NewSchedule = {
     properties: {
         path: {
             type: 'string',
-            description: 'The path where the schedule will be created'
+            description: 'The unique path identifier for this schedule'
         },
         schedule: {
             type: 'string',
-            description: 'The cron schedule to trigger the script or flow. Should include seconds.'
+            description: "Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon"
         },
         timezone: {
             type: 'string',
-            description: 'The timezone to use for the cron schedule'
+            description: "IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')"
         },
         script_path: {
             type: 'string',
-            description: 'The path to the script or flow to trigger'
+            description: 'Path to the script or flow to execute when triggered'
         },
         is_flow: {
             type: 'boolean',
-            description: 'Whether the schedule is for a flow'
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         enabled: {
             type: 'boolean',
-            description: 'Whether the schedule is enabled'
+            description: 'Whether the schedule is currently active and will trigger jobs'
         },
         on_failure: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on failure'
+            nullable: true,
+            description: 'Path to a script or flow to run when the scheduled job fails'
         },
         on_failure_times: {
             type: 'number',
-            description: 'The number of times to retry on failure'
+            nullable: true,
+            description: 'Number of consecutive failures before the on_failure handler is triggered (default 1)'
         },
         on_failure_exact: {
             type: 'boolean',
-            description: 'Whether the schedule should only run on the exact time'
+            nullable: true,
+            description: 'If true, trigger on_failure handler only on exactly N failures, not on every failure after N'
         },
         on_failure_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on failure'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         on_recovery: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on recovery'
+            nullable: true,
+            description: 'Path to a script or flow to run when the schedule recovers after failures'
         },
         on_recovery_times: {
             type: 'number',
-            description: 'The number of times to retry on recovery'
+            nullable: true,
+            description: 'Number of consecutive successes before the on_recovery handler is triggered (default 1)'
         },
         on_recovery_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on recovery'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         on_success: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on success'
+            nullable: true,
+            description: 'Path to a script or flow to run after each successful execution'
         },
         on_success_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on success'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         ws_error_handler_muted: {
             type: 'boolean',
-            description: 'Whether the WebSocket error handler is muted'
+            description: "If true, the workspace-level error handler will not be triggered for this schedule's failures"
         },
         retry: {
-            '$ref': '#/components/schemas/Retry',
-            description: 'The retry configuration for the schedule'
+            nullable: true,
+            '$ref': '#/components/schemas/Retry'
         },
         no_flow_overlap: {
             type: 'boolean',
-            description: 'Whether the schedule should not run if a flow is already running'
+            description: "If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)"
         },
         summary: {
             type: 'string',
-            description: 'The summary of the schedule'
+            nullable: true,
+            description: 'Short summary describing the purpose of this schedule'
         },
         description: {
             type: 'string',
-            description: 'The description of the schedule'
+            nullable: true,
+            description: 'Detailed description of what this schedule does'
         },
         tag: {
             type: 'string',
-            description: 'The tag of the schedule'
+            nullable: true,
+            description: 'Worker tag to route jobs to specific worker groups'
         },
         paused_until: {
             type: 'string',
-            description: 'The date and time the schedule will be paused until',
-            format: 'date-time'
+            nullable: true,
+            format: 'date-time',
+            description: 'ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time'
         },
         cron_version: {
             type: 'string',
-            description: 'The version of the cron schedule to use (last is v2)'
+            nullable: true,
+            description: "Cron parser version. Use 'v2' for extended syntax with additional features"
         },
         dynamic_skip: {
             type: 'string',
-            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.'
+            nullable: true,
+            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)'
         }
     },
     required: ['path', 'schedule', 'timezone', 'script_path', 'is_flow', 'args']
@@ -3680,88 +4136,100 @@ export const $EditSchedule = {
     properties: {
         schedule: {
             type: 'string',
-            description: 'The cron schedule to trigger the script or flow. Should include seconds.'
+            description: "Cron expression with 6 fields (seconds, minutes, hours, day of month, month, day of week). Example '0 0 12 * * *' for daily at noon"
         },
         timezone: {
             type: 'string',
-            description: 'The timezone to use for the cron schedule'
+            description: "IANA timezone for the schedule (e.g., 'UTC', 'Europe/Paris', 'America/New_York')"
         },
         args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         on_failure: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on failure'
+            nullable: true,
+            description: 'Path to a script or flow to run when the scheduled job fails'
         },
         on_failure_times: {
             type: 'number',
-            description: 'The number of times to retry on failure'
+            nullable: true,
+            description: 'Number of consecutive failures before the on_failure handler is triggered (default 1)'
         },
         on_failure_exact: {
             type: 'boolean',
-            description: 'Whether the schedule should only run on the exact time'
+            nullable: true,
+            description: 'If true, trigger on_failure handler only on exactly N failures, not on every failure after N'
         },
         on_failure_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on failure'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         on_recovery: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on recovery'
+            nullable: true,
+            description: 'Path to a script or flow to run when the schedule recovers after failures'
         },
         on_recovery_times: {
             type: 'number',
-            description: 'The number of times to retry on recovery'
+            nullable: true,
+            description: 'Number of consecutive successes before the on_recovery handler is triggered (default 1)'
         },
         on_recovery_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on recovery'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         on_success: {
             type: 'string',
-            description: 'The path to the script or flow to trigger on success'
+            nullable: true,
+            description: 'Path to a script or flow to run after each successful execution'
         },
         on_success_extra_args: {
-            '$ref': '#/components/schemas/ScriptArgs',
-            description: 'The arguments to pass to the script or flow on success'
+            nullable: true,
+            '$ref': '#/components/schemas/ScriptArgs'
         },
         ws_error_handler_muted: {
             type: 'boolean',
-            description: 'Whether the WebSocket error handler is muted'
+            description: "If true, the workspace-level error handler will not be triggered for this schedule's failures"
         },
         retry: {
-            '$ref': '#/components/schemas/Retry',
-            description: 'The retry configuration for the schedule'
+            nullable: true,
+            '$ref': '#/components/schemas/Retry'
         },
         no_flow_overlap: {
             type: 'boolean',
-            description: 'Whether the schedule should not run if a flow is already running'
+            description: "If true, skip this schedule's execution if the previous run is still in progress (prevents concurrent runs)"
         },
         summary: {
             type: 'string',
-            description: 'The summary of the schedule'
+            nullable: true,
+            description: 'Short summary describing the purpose of this schedule'
         },
         description: {
             type: 'string',
-            description: 'The description of the schedule'
+            nullable: true,
+            description: 'Detailed description of what this schedule does'
         },
         tag: {
             type: 'string',
-            description: 'The tag of the schedule'
+            nullable: true,
+            description: 'Worker tag to route jobs to specific worker groups'
         },
         paused_until: {
             type: 'string',
-            description: 'The date and time the schedule will be paused until',
-            format: 'date-time'
+            nullable: true,
+            format: 'date-time',
+            description: 'ISO 8601 datetime until which the schedule is paused. Schedule resumes automatically after this time'
         },
         cron_version: {
             type: 'string',
-            description: 'The version of the cron schedule to use (last is v2)'
+            nullable: true,
+            description: "Cron parser version. Use 'v2' for extended syntax with additional features"
         },
         dynamic_skip: {
             type: 'string',
-            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean.'
+            nullable: true,
+            description: 'Path to a script that validates scheduled datetimes. Receives scheduled_for datetime and returns boolean to skip (true) or run (false)'
         }
     },
     required: ['schedule', 'timezone', 'args']
@@ -3769,7 +4237,7 @@ export const $EditSchedule = {
 export const $JobTriggerKind = {
     description: 'job trigger kind (schedule, http, websocket...)',
     type: 'string',
-    enum: ['webhook', 'default_email', 'email', 'schedule', 'http', 'websocket', 'postgres', 'kafka', 'nats', 'mqtt', 'sqs', 'gcp']
+    enum: ['webhook', 'default_email', 'email', 'schedule', 'http', 'websocket', 'postgres', 'kafka', 'nats', 'mqtt', 'sqs', 'gcp', 'google']
 };
 export const $TriggerMode = {
     description: 'job trigger mode',
@@ -3780,35 +4248,44 @@ export const $TriggerExtraProperty = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when triggered'
         },
         email: {
-            type: 'string'
+            type: 'string',
+            description: 'Email of the user who owns this trigger, used for permissioned_as'
         },
         extra_perms: {
             type: 'object',
+            description: 'Additional permissions for this trigger',
             additionalProperties: {
                 type: 'boolean'
             }
         },
         workspace_id: {
-            type: 'string'
+            type: 'string',
+            description: 'The workspace this trigger belongs to'
         },
         edited_by: {
-            type: 'string'
+            type: 'string',
+            description: 'Username of the last person who edited this trigger'
         },
         edited_at: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of the last edit'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
-            '$ref': '#/components/schemas/TriggerMode'
+            '$ref': '#/components/schemas/TriggerMode',
+            description: 'Trigger mode (enabled/disabled)'
         }
     },
     required: ['path', 'script_path', 'email', 'extra_perms', 'workspace_id', 'edited_by', 'edited_at', 'is_flow', 'mode']
@@ -3949,61 +4426,83 @@ export const $HttpTrigger = {
     type: 'object',
     properties: {
         route_path: {
-            type: 'string'
+            type: 'string',
+            description: "The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /."
         },
         static_asset_config: {
             type: 'object',
+            nullable: true,
+            description: 'Configuration for serving static assets (s3 bucket, storage path, filename)',
             properties: {
                 s3: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'S3 bucket path for static assets'
                 },
                 storage: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Storage path for static assets'
                 },
                 filename: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Filename for the static asset'
                 }
             },
             required: ['s3']
         },
         http_method: {
-            '$ref': '#/components/schemas/HttpMethod'
+            '$ref': '#/components/schemas/HttpMethod',
+            description: 'HTTP method (get, post, put, delete, patch) that triggers this endpoint'
         },
         authentication_resource_path: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)'
         },
         summary: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Short summary describing the purpose of this trigger'
         },
         description: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Detailed description of what this trigger does'
         },
         request_type: {
-            '$ref': '#/components/schemas/HttpRequestType'
+            '$ref': '#/components/schemas/HttpRequestType',
+            description: "How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events"
         },
         authentication_method: {
-            '$ref': '#/components/schemas/AuthenticationMethod'
+            '$ref': '#/components/schemas/AuthenticationMethod',
+            description: "How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'"
         },
         is_static_website: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, serves static files from S3/storage instead of running a script'
         },
         workspaced_route: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the route includes the workspace ID in the path'
         },
         wrap_body: {
-            type: 'boolean'
+            type: 'boolean',
+            description: "If true, wraps the request body in a 'body' parameter"
         },
         raw_string: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, passes the request body as a raw string instead of parsing as JSON'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['route_path', 'request_type', 'authentication_method', 'http_method', 'is_static_website', 'workspaced_route', 'wrap_body', 'raw_string']
@@ -4012,77 +4511,102 @@ export const $NewHttpTrigger = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when triggered'
         },
         route_path: {
-            type: 'string'
+            type: 'string',
+            description: "The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /."
         },
         workspaced_route: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the route includes the workspace ID in the path'
         },
         summary: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Short summary describing the purpose of this trigger'
         },
         description: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Detailed description of what this trigger does'
         },
         static_asset_config: {
             type: 'object',
+            nullable: true,
+            description: 'Configuration for serving static assets (s3 bucket, storage path, filename)',
             properties: {
                 s3: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'S3 bucket path for static assets'
                 },
                 storage: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Storage path for static assets'
                 },
                 filename: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Filename for the static asset'
                 }
             },
             required: ['s3']
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         http_method: {
-            '$ref': '#/components/schemas/HttpMethod'
+            '$ref': '#/components/schemas/HttpMethod',
+            description: 'HTTP method (get, post, put, delete, patch) that triggers this endpoint'
         },
         authentication_resource_path: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)'
         },
         is_async: {
             type: 'boolean',
             description: 'Deprecated, use request_type instead'
         },
         request_type: {
-            '$ref': '#/components/schemas/HttpRequestType'
+            '$ref': '#/components/schemas/HttpRequestType',
+            description: "How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events"
         },
         authentication_method: {
-            '$ref': '#/components/schemas/AuthenticationMethod'
+            '$ref': '#/components/schemas/AuthenticationMethod',
+            description: "How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'"
         },
         is_static_website: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, serves static files from S3/storage instead of running a script'
         },
         wrap_body: {
-            type: 'boolean'
+            type: 'boolean',
+            description: "If true, wraps the request body in a 'body' parameter"
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         raw_string: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, passes the request body as a raw string instead of parsing as JSON'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'route_path', 'is_flow', 'authentication_method', 'http_method', 'is_static_website']
@@ -4091,74 +4615,99 @@ export const $EditHttpTrigger = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when triggered'
         },
         route_path: {
-            type: 'string'
+            type: 'string',
+            description: "The URL route path that will trigger this endpoint (e.g., 'api/myendpoint'). Must NOT start with a /."
         },
         summary: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Short summary describing the purpose of this trigger'
         },
         description: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Detailed description of what this trigger does'
         },
         workspaced_route: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the route includes the workspace ID in the path'
         },
         static_asset_config: {
             type: 'object',
+            nullable: true,
+            description: 'Configuration for serving static assets (s3 bucket, storage path, filename)',
             properties: {
                 s3: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'S3 bucket path for static assets'
                 },
                 storage: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Storage path for static assets'
                 },
                 filename: {
-                    type: 'string'
+                    type: 'string',
+                    description: 'Filename for the static asset'
                 }
             },
             required: ['s3']
         },
         authentication_resource_path: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'Path to the resource containing authentication configuration (for api_key, basic_http, custom_script, signature methods)'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         http_method: {
-            '$ref': '#/components/schemas/HttpMethod'
+            '$ref': '#/components/schemas/HttpMethod',
+            description: 'HTTP method (get, post, put, delete, patch) that triggers this endpoint'
         },
         is_async: {
             type: 'boolean',
             description: 'Deprecated, use request_type instead'
         },
         request_type: {
-            '$ref': '#/components/schemas/HttpRequestType'
+            '$ref': '#/components/schemas/HttpRequestType',
+            description: "How the request is handled - 'sync' waits for result, 'async' returns job ID immediately, 'sync_sse' streams results via Server-Sent Events"
         },
         authentication_method: {
-            '$ref': '#/components/schemas/AuthenticationMethod'
+            '$ref': '#/components/schemas/AuthenticationMethod',
+            description: "How requests are authenticated - 'none' (public), 'windmill' (Windmill token), 'api_key', 'basic_http', 'custom_script', 'signature'"
         },
         is_static_website: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, serves static files from S3/storage instead of running a script'
         },
         wrap_body: {
-            type: 'boolean'
+            type: 'boolean',
+            description: "If true, wraps the request body in a 'body' parameter"
         },
         raw_string: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, passes the request body as a raw string instead of parsing as JSON'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'kind', 'authentication_method', 'http_method', 'is_static_website']
@@ -4212,6 +4761,9 @@ export const $TriggersCount = {
         },
         nextcloud_count: {
             type: 'number'
+        },
+        google_count: {
+            type: 'number'
         }
     }
 };
@@ -4224,20 +4776,25 @@ export const $WebsocketTrigger = {
     type: 'object',
     properties: {
         url: {
-            type: 'string'
+            type: 'string',
+            description: 'The WebSocket URL to connect to (can be a static URL or computed by a runnable)'
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         filters: {
             type: 'array',
+            description: 'Array of key-value filters to match incoming messages (only matching messages trigger the script)',
             items: {
                 type: 'object',
                 properties: {
@@ -4251,26 +4808,35 @@ export const $WebsocketTrigger = {
         },
         initial_messages: {
             type: 'array',
+            nullable: true,
+            description: 'Messages to send immediately after connecting (can be raw strings or computed by runnables)',
             items: {
                 '$ref': '#/components/schemas/WebsocketTriggerInitialMessage'
             }
         },
         url_runnable_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            description: 'Arguments to pass to the script/flow that computes the WebSocket URL',
+            '$ref': '#/components/schemas/ScriptArgs',
+            nullable: true
         },
         can_return_message: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the script can return a message to send back through the WebSocket'
         },
         can_return_error_result: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, error results are sent back through the WebSocket'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
+            description: 'Arguments to pass to the error handler',
             '$ref': '#/components/schemas/ScriptArgs'
         },
         retry: {
+            description: 'Retry configuration for failed executions',
             '$ref': '#/components/schemas/Retry'
         }
     },
@@ -4280,22 +4846,27 @@ export const $NewWebsocketTrigger = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         url: {
-            type: 'string'
+            type: 'string',
+            description: 'The WebSocket URL to connect to (can be a static URL or computed by a runnable)'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         filters: {
             type: 'array',
+            description: 'Array of key-value filters to match incoming messages (only matching messages trigger the script)',
             items: {
                 type: 'object',
                 properties: {
@@ -4309,26 +4880,35 @@ export const $NewWebsocketTrigger = {
         },
         initial_messages: {
             type: 'array',
+            nullable: true,
+            description: 'Messages to send immediately after connecting (can be raw strings or computed by runnables)',
             items: {
                 '$ref': '#/components/schemas/WebsocketTriggerInitialMessage'
             }
         },
         url_runnable_args: {
+            description: 'Arguments to pass to the script/flow that computes the WebSocket URL',
+            nullable: true,
             '$ref': '#/components/schemas/ScriptArgs'
         },
         can_return_message: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the script can return a message to send back through the WebSocket'
         },
         can_return_error_result: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, error results are sent back through the WebSocket'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
+            description: 'Arguments to pass to the error handler',
             '$ref': '#/components/schemas/ScriptArgs'
         },
         retry: {
+            description: 'Retry configuration for failed executions',
             '$ref': '#/components/schemas/Retry'
         }
     },
@@ -4338,19 +4918,24 @@ export const $EditWebsocketTrigger = {
     type: 'object',
     properties: {
         url: {
-            type: 'string'
+            type: 'string',
+            description: 'The WebSocket URL to connect to (can be a static URL or computed by a runnable)'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         filters: {
             type: 'array',
+            description: 'Array of key-value filters to match incoming messages (only matching messages trigger the script)',
             items: {
                 type: 'object',
                 properties: {
@@ -4364,26 +4949,35 @@ export const $EditWebsocketTrigger = {
         },
         initial_messages: {
             type: 'array',
+            nullable: true,
+            description: 'Messages to send immediately after connecting (can be raw strings or computed by runnables)',
             items: {
                 '$ref': '#/components/schemas/WebsocketTriggerInitialMessage'
             }
         },
         url_runnable_args: {
+            description: 'Arguments to pass to the script/flow that computes the WebSocket URL',
+            nullable: true,
             '$ref': '#/components/schemas/ScriptArgs'
         },
         can_return_message: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, the script can return a message to send back through the WebSocket'
         },
         can_return_error_result: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, error results are sent back through the WebSocket'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
+            description: 'Arguments to pass to the error handler',
             '$ref': '#/components/schemas/ScriptArgs'
         },
         retry: {
+            description: 'Retry configuration for failed executions',
             '$ref': '#/components/schemas/Retry'
         }
     },
@@ -4474,44 +5068,60 @@ export const $MqttTrigger = {
     type: 'object',
     properties: {
         mqtt_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the MQTT resource containing broker connection configuration'
         },
         subscribe_topics: {
             type: 'array',
             items: {
                 '$ref': '#/components/schemas/MqttSubscribeTopic'
-            }
+            },
+            description: 'Array of MQTT topics to subscribe to, each with topic name and QoS level'
         },
         v3_config: {
-            '$ref': '#/components/schemas/MqttV3Config'
+            '$ref': '#/components/schemas/MqttV3Config',
+            nullable: true,
+            description: 'MQTT v3 specific configuration (clean_session)'
         },
         v5_config: {
-            '$ref': '#/components/schemas/MqttV5Config'
+            '$ref': '#/components/schemas/MqttV5Config',
+            nullable: true,
+            description: 'MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)'
         },
         client_id: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'MQTT client ID for this connection'
         },
         client_version: {
-            '$ref': '#/components/schemas/MqttClientVersion'
+            '$ref': '#/components/schemas/MqttClientVersion',
+            nullable: true,
+            description: "MQTT protocol version ('v3' or 'v5')"
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['subscribe_topics', 'mqtt_resource_path']
@@ -4520,46 +5130,62 @@ export const $NewMqttTrigger = {
     type: 'object',
     properties: {
         mqtt_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the MQTT resource containing broker connection configuration'
         },
         subscribe_topics: {
             type: 'array',
             items: {
                 '$ref': '#/components/schemas/MqttSubscribeTopic'
-            }
+            },
+            description: 'Array of MQTT topics to subscribe to, each with topic name and QoS level'
         },
         client_id: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'MQTT client ID for this connection'
         },
         v3_config: {
-            '$ref': '#/components/schemas/MqttV3Config'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttV3Config',
+            description: 'MQTT v3 specific configuration (clean_session)'
         },
         v5_config: {
-            '$ref': '#/components/schemas/MqttV5Config'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttV5Config',
+            description: 'MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)'
         },
         client_version: {
-            '$ref': '#/components/schemas/MqttClientVersion'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttClientVersion',
+            description: "MQTT protocol version ('v3' or 'v5')"
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'subscribe_topics', 'mqtt_resource_path']
@@ -4568,62 +5194,82 @@ export const $EditMqttTrigger = {
     type: 'object',
     properties: {
         mqtt_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the MQTT resource containing broker connection configuration'
         },
         subscribe_topics: {
             type: 'array',
             items: {
                 '$ref': '#/components/schemas/MqttSubscribeTopic'
-            }
+            },
+            description: 'Array of MQTT topics to subscribe to, each with topic name and QoS level'
         },
         client_id: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'MQTT client ID for this connection'
         },
         v3_config: {
-            '$ref': '#/components/schemas/MqttV3Config'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttV3Config',
+            description: 'MQTT v3 specific configuration (clean_session)'
         },
         v5_config: {
-            '$ref': '#/components/schemas/MqttV5Config'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttV5Config',
+            description: 'MQTT v5 specific configuration (clean_start, topic_alias_maximum, session_expiry_interval)'
         },
         client_version: {
-            '$ref': '#/components/schemas/MqttClientVersion'
+            nullable: true,
+            '$ref': '#/components/schemas/MqttClientVersion',
+            description: "MQTT protocol version ('v3' or 'v5')"
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'enabled', 'subscribe_topics', 'mqtt_resource_path']
 };
 export const $DeliveryType = {
     type: 'string',
-    enum: ['push', 'pull']
+    enum: ['push', 'pull'],
+    description: "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 const $PushConfig = {
     type: 'object',
+    description: 'Configuration for push delivery mode.',
     properties: {
         audience: {
-            type: 'string'
+            type: 'string',
+            description: 'The audience claim for OIDC tokens used in push authentication.'
         },
         authenticate: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, push messages will include OIDC authentication tokens.'
         }
     },
     required: ['authenticate', 'base_endpoint']
@@ -4635,43 +5281,54 @@ export const $GcpTrigger = {
         }
     ],
     type: 'object',
+    description: 'A Google Cloud Pub/Sub trigger that executes a script or flow when messages are received.',
     properties: {
         gcp_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the GCP resource containing service account credentials for authentication.'
         },
         topic_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Google Cloud Pub/Sub topic ID to subscribe to.'
         },
         subscription_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Google Cloud Pub/Sub subscription ID.'
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal use).'
         },
         delivery_type: {
             '$ref': '#/components/schemas/DeliveryType'
         },
         delivery_config: {
-            '$ref': '#/components/schemas/PushConfig'
+            '$ref': '#/components/schemas/PushConfig',
+            nullable: true
         },
         subscription_mode: {
             '$ref': '#/components/schemas/SubscriptionMode'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal use).'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed.'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails.'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler.'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions.'
         }
     },
     required: ['gcp_resource_path', 'topic_id', 'subscription_id', 'delivery_type', 'subscription_mode']
@@ -4683,42 +5340,52 @@ export const $SubscriptionMode = {
 };
 export const $GcpTriggerData = {
     type: 'object',
+    description: 'Data for creating or updating a Google Cloud Pub/Sub trigger.',
     properties: {
         gcp_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the GCP resource containing service account credentials for authentication.'
         },
         subscription_mode: {
             '$ref': '#/components/schemas/SubscriptionMode'
         },
         topic_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Google Cloud Pub/Sub topic ID to subscribe to.'
         },
         subscription_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Google Cloud Pub/Sub subscription ID.'
         },
         base_endpoint: {
-            type: 'string'
+            type: 'string',
+            description: 'Base URL for push delivery endpoint.'
         },
         delivery_type: {
             '$ref': '#/components/schemas/DeliveryType'
         },
         delivery_config: {
+            nullable: true,
             '$ref': '#/components/schemas/PushConfig'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger.'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received.'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script.'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         auto_acknowledge_msg: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, automatically acknowledge messages after processing.'
         },
         ack_deadline: {
             type: 'integer',
@@ -4728,13 +5395,16 @@ export const $GcpTriggerData = {
             description: "Time in seconds within which the message must be acknowledged. If not provided, defaults to the subscription's acknowledgment deadline (600 seconds)."
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails.'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler.'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions.'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'gcp_resource_path', 'topic_id', 'subscription_mode']
@@ -4770,38 +5440,49 @@ export const $SqsTrigger = {
     type: 'object',
     properties: {
         queue_url: {
-            type: 'string'
+            type: 'string',
+            description: 'The full URL of the AWS SQS queue to poll for messages'
         },
         aws_auth_resource_type: {
-            '$ref': '#/components/schemas/AwsAuthResourceType'
+            '$ref': '#/components/schemas/AwsAuthResourceType',
+            description: "Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect"
         },
         aws_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the AWS resource containing credentials or OIDC configuration'
         },
         message_attributes: {
             type: 'array',
+            nullable: true,
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of SQS message attribute names to include with each message'
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['queue_url', 'aws_resource_path', 'aws_auth_resource_type']
@@ -4864,40 +5545,51 @@ export const $NewSqsTrigger = {
     type: 'object',
     properties: {
         queue_url: {
-            type: 'string'
+            type: 'string',
+            description: 'The full URL of the AWS SQS queue to poll for messages'
         },
         aws_auth_resource_type: {
-            '$ref': '#/components/schemas/AwsAuthResourceType'
+            '$ref': '#/components/schemas/AwsAuthResourceType',
+            description: "Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect"
         },
         aws_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the AWS resource containing credentials or OIDC configuration'
         },
         message_attributes: {
             type: 'array',
+            nullable: true,
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of SQS message attribute names to include with each message'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['queue_url', 'aws_resource_path', 'path', 'script_path', 'is_flow', 'aws_auth_resource_type']
@@ -4906,40 +5598,51 @@ export const $EditSqsTrigger = {
     type: 'object',
     properties: {
         queue_url: {
-            type: 'string'
+            type: 'string',
+            description: 'The full URL of the AWS SQS queue to poll for messages'
         },
         aws_auth_resource_type: {
-            '$ref': '#/components/schemas/AwsAuthResourceType'
+            '$ref': '#/components/schemas/AwsAuthResourceType',
+            description: "Authentication type - 'credentials' for access key/secret, 'oidc' for OpenID Connect"
         },
         aws_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the AWS resource containing credentials or OIDC configuration'
         },
         message_attributes: {
             type: 'array',
+            nullable: true,
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of SQS message attribute names to include with each message'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['queue_url', 'aws_resource_path', 'path', 'script_path', 'is_flow', 'enabled', 'aws_auth_resource_type']
@@ -5045,32 +5748,41 @@ export const $PostgresTrigger = {
     type: 'object',
     properties: {
         postgres_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the PostgreSQL resource containing connection configuration'
         },
         publication_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL publication to subscribe to for change data capture'
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         replication_slot_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL logical replication slot to use'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['postgres_resource_path', 'replication_slot_name', 'publication_name']
@@ -5079,37 +5791,47 @@ export const $NewPostgresTrigger = {
     type: 'object',
     properties: {
         replication_slot_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL logical replication slot to use'
         },
         publication_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL publication to subscribe to for change data capture'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when database changes are detected'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         postgres_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the PostgreSQL resource containing connection configuration'
         },
         publication: {
-            '$ref': '#/components/schemas/PublicationData'
+            '$ref': '#/components/schemas/PublicationData',
+            description: 'Configuration for creating/managing the publication (tables, operations)'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'enabled', 'postgres_resource_path']
@@ -5118,37 +5840,47 @@ export const $EditPostgresTrigger = {
     type: 'object',
     properties: {
         replication_slot_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL logical replication slot to use'
         },
         publication_name: {
-            type: 'string'
+            type: 'string',
+            description: 'Name of the PostgreSQL publication to subscribe to for change data capture'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when database changes are detected'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         postgres_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the PostgreSQL resource containing connection configuration'
         },
         publication: {
-            '$ref': '#/components/schemas/PublicationData'
+            '$ref': '#/components/schemas/PublicationData',
+            description: 'Configuration for creating/managing the publication (tables, operations)'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'enabled', 'postgres_resource_path', 'publication_name', 'replication_slot_name']
@@ -5162,113 +5894,179 @@ export const $KafkaTrigger = {
     type: 'object',
     properties: {
         kafka_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the Kafka resource containing connection configuration'
         },
         group_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Kafka consumer group ID for this trigger'
         },
         topics: {
             type: 'array',
             items: {
-                type: 'string'
+                type: 'string'
+            },
+            description: 'Array of Kafka topic names to subscribe to'
+        },
+        filters: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    key: {
+                        type: 'string'
+                    },
+                    value: {}
+                },
+                required: ['key', 'value']
             }
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
-    required: ['kafka_resource_path', 'group_id', 'topics']
+    required: ['kafka_resource_path', 'group_id', 'topics', 'filters']
 };
 export const $NewKafkaTrigger = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         kafka_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the Kafka resource containing connection configuration'
         },
         group_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Kafka consumer group ID for this trigger'
         },
         topics: {
             type: 'array',
             items: {
                 type: 'string'
+            },
+            description: 'Array of Kafka topic names to subscribe to'
+        },
+        filters: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    key: {
+                        type: 'string'
+                    },
+                    value: {}
+                },
+                required: ['key', 'value']
             }
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
-    required: ['path', 'script_path', 'is_flow', 'kafka_resource_path', 'group_id', 'topics']
+    required: ['path', 'script_path', 'is_flow', 'kafka_resource_path', 'group_id', 'topics', 'filters']
 };
 export const $EditKafkaTrigger = {
     type: 'object',
     properties: {
         kafka_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the Kafka resource containing connection configuration'
         },
         group_id: {
-            type: 'string'
+            type: 'string',
+            description: 'Kafka consumer group ID for this trigger'
         },
         topics: {
             type: 'array',
             items: {
                 type: 'string'
+            },
+            description: 'Array of Kafka topic names to subscribe to'
+        },
+        filters: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    key: {
+                        type: 'string'
+                    },
+                    value: {}
+                },
+                required: ['key', 'value']
             }
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
-    required: ['path', 'script_path', 'kafka_resource_path', 'group_id', 'topics', 'is_flow']
+    required: ['path', 'script_path', 'kafka_resource_path', 'group_id', 'topics', 'filters', 'is_flow']
 };
 export const $NatsTrigger = {
     allOf: [
@@ -5279,41 +6077,54 @@ export const $NatsTrigger = {
     type: 'object',
     properties: {
         nats_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the NATS resource containing connection configuration'
         },
         use_jetstream: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, uses NATS JetStream for durable message delivery'
         },
         stream_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream stream name (required when use_jetstream is true)'
         },
         consumer_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream consumer name (required when use_jetstream is true)'
         },
         subjects: {
             type: 'array',
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of NATS subjects to subscribe to'
         },
         server_id: {
-            type: 'string'
+            type: 'string',
+            description: 'ID of the server currently handling this trigger (internal)'
         },
         last_server_ping: {
             type: 'string',
-            format: 'date-time'
+            format: 'date-time',
+            description: 'Timestamp of last server heartbeat (internal)'
         },
         error: {
-            type: 'string'
+            type: 'string',
+            description: 'Last error message if the trigger failed'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['nats_resource_path', 'use_jetstream', 'subjects']
@@ -5322,43 +6133,56 @@ export const $NewNatsTrigger = {
     type: 'object',
     properties: {
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         nats_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the NATS resource containing connection configuration'
         },
         use_jetstream: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, uses NATS JetStream for durable message delivery'
         },
         stream_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream stream name (required when use_jetstream is true)'
         },
         consumer_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream consumer name (required when use_jetstream is true)'
         },
         subjects: {
             type: 'array',
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of NATS subjects to subscribe to'
         },
         mode: {
             '$ref': '#/components/schemas/TriggerMode'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'is_flow', 'nats_resource_path', 'use_jetstream', 'subjects']
@@ -5367,40 +6191,53 @@ export const $EditNatsTrigger = {
     type: 'object',
     properties: {
         nats_resource_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the NATS resource containing connection configuration'
         },
         use_jetstream: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'If true, uses NATS JetStream for durable message delivery'
         },
         stream_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream stream name (required when use_jetstream is true)'
         },
         consumer_name: {
-            type: 'string'
+            type: 'string',
+            nullable: true,
+            description: 'JetStream consumer name (required when use_jetstream is true)'
         },
         subjects: {
             type: 'array',
             items: {
                 type: 'string'
-            }
+            },
+            description: 'Array of NATS subjects to subscribe to'
         },
         path: {
-            type: 'string'
+            type: 'string',
+            description: 'The unique path identifier for this trigger'
         },
         script_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to the script or flow to execute when a message is received'
         },
         is_flow: {
-            type: 'boolean'
+            type: 'boolean',
+            description: 'True if script_path points to a flow, false if it points to a script'
         },
         error_handler_path: {
-            type: 'string'
+            type: 'string',
+            description: 'Path to a script or flow to run when the triggered job fails'
         },
         error_handler_args: {
-            '$ref': '#/components/schemas/ScriptArgs'
+            '$ref': '#/components/schemas/ScriptArgs',
+            description: 'Arguments to pass to the error handler'
         },
         retry: {
-            '$ref': '#/components/schemas/Retry'
+            '$ref': '#/components/schemas/Retry',
+            description: 'Retry configuration for failed executions'
         }
     },
     required: ['path', 'script_path', 'nats_resource_path', 'use_jetstream', 'subjects', 'is_flow']
@@ -5672,6 +6509,9 @@ export const $WorkerPing = {
         },
         job_isolation: {
             type: 'string'
+        },
+        native_mode: {
+            type: 'boolean'
         }
     },
     required: ['worker', 'worker_instance', 'ping_at', 'started_at', 'ip', 'jobs_executed', 'worker_group', 'wm_version']
@@ -6235,9 +7075,7 @@ export const $AppWithLastVersion = {
             type: 'string',
             format: 'date-time'
         },
-        value: {
-            type: 'object'
-        },
+        value: {},
         policy: {
             '$ref': '#/components/schemas/Policy'
         },
@@ -6899,12 +7737,31 @@ export const $GlobalSetting = {
         name: {
             type: 'string'
         },
-        value: {
-            type: 'object'
-        }
+        value: {}
     },
     required: ['name', 'value']
 };
+export const $InstanceConfig = {
+    type: 'object',
+    description: 'Unified instance configuration combining global settings and worker group configs',
+    properties: {
+        global_settings: {
+            type: 'object',
+            description: `Global settings keyed by setting name. Known fields include base_url, license_key, retention_period_secs, smtp_settings, otel, etc. Unknown fields are preserved as-is.
+`,
+            additionalProperties: true
+        },
+        worker_configs: {
+            type: 'object',
+            description: `Worker group configurations keyed by group name (e.g. "default", "gpu"). Each value contains worker_tags, init_bash, autoscaling, etc.
+`,
+            additionalProperties: {
+                type: 'object',
+                additionalProperties: true
+            }
+        }
+    }
+};
 export const $Config = {
     type: 'object',
     properties: {
@@ -7373,7 +8230,8 @@ export const $AssetUsageKind = {
 };
 export const $AssetUsageAccessType = {
     type: 'string',
-    enum: ['r', 'w', 'rw']
+    enum: ['r', 'w', 'rw'],
+    nullable: true
 };
 export const $AssetKind = {
     type: 'string',
@@ -7391,9 +8249,58 @@ export const $Asset = {
     },
     required: ['path', 'kind']
 };
+export const $ProtectionRuleset = {
+    type: 'object',
+    description: 'A workspace protection rule defining restrictions and bypass permissions',
+    required: ['name', 'rules', 'bypass_groups', 'bypass_users'],
+    properties: {
+        name: {
+            type: 'string',
+            description: 'Unique name for the protection rule',
+            example: 'Production Protection'
+        },
+        workspace_id: {
+            type: 'string'
+        },
+        rules: {
+            '$ref': '#/components/schemas/ProtectionRules'
+        },
+        bypass_groups: {
+            '$ref': '#/components/schemas/RuleBypasserGroups'
+        },
+        bypass_users: {
+            '$ref': '#/components/schemas/RuleBypasserUsers'
+        }
+    }
+};
+export const $ProtectionRules = {
+    type: 'array',
+    description: 'Configuration of protection restrictions',
+    items: {
+        '$ref': '#/components/schemas/ProtectionRuleKind'
+    }
+};
+export const $ProtectionRuleKind = {
+    type: 'string',
+    enum: ['DisableDirectDeployment', 'DisableWorkspaceForking']
+};
+export const $RuleBypasserGroups = {
+    type: 'array',
+    description: 'Groups that can bypass this ruleset',
+    items: {
+        type: 'string'
+    }
+};
+export const $RuleBypasserUsers = {
+    type: 'array',
+    description: 'Users that can bypass this ruleset',
+    items: {
+        type: 'string'
+    }
+};
 export const $NativeServiceName = {
     type: 'string',
-    enum: ['nextcloud']
+    enum: ['nextcloud', 'google']
 };
 export const $NativeTrigger = {
     type: 'object',
@@ -7481,6 +8388,11 @@ export const $WorkspaceIntegrations = {
         oauth_data: {
             nullable: true,
             '$ref': '#/components/schemas/WorkspaceOAuthConfig'
+        },
+        resource_path: {
+            type: 'string',
+            nullable: true,
+            description: 'Path to the resource storing the OAuth token'
         }
     },
     required: ['service_name']
@@ -7612,3 +8524,65 @@ export const $NextCloudEventType = {
     },
     required: ['id', 'name', 'path']
 };
+export const $GoogleCalendarEntry = {
+    type: 'object',
+    properties: {
+        id: {
+            type: 'string'
+        },
+        summary: {
+            type: 'string'
+        },
+        primary: {
+            type: 'boolean',
+            default: false
+        }
+    },
+    required: ['id', 'summary']
+};
+export const $GoogleDriveFile = {
+    type: 'object',
+    properties: {
+        id: {
+            type: 'string'
+        },
+        name: {
+            type: 'string'
+        },
+        mime_type: {
+            type: 'string'
+        },
+        is_folder: {
+            type: 'boolean',
+            default: false
+        }
+    },
+    required: ['id', 'name', 'mime_type']
+};
+export const $GoogleDriveFilesResponse = {
+    type: 'object',
+    properties: {
+        files: {
+            type: 'array',
+            items: {
+                '$ref': '#/components/schemas/GoogleDriveFile'
+            }
+        },
+        next_page_token: {
+            type: 'string'
+        }
+    },
+    required: ['files']
+};
+export const $SharedDriveEntry = {
+    type: 'object',
+    properties: {
+        id: {
+            type: 'string'
+        },
+        name: {
+            type: 'string'
+        }
+    },
+    required: ['id', 'name']
+};