windmill-components 1.623.1 → 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,169 +1407,583 @@ export const $FlowNote = {
     },
     required: ['id', 'text', 'color', 'type']
 };
-export const $FlowConversation = {
+export const $HealthStatusResponse = {
     type: 'object',
-    required: ['id', 'workspace_id', 'flow_path', 'created_at', 'updated_at', 'created_by'],
+    description: 'Health status response (cached with 5s TTL)',
+    required: ['status', 'checked_at', 'database_healthy', 'workers_alive'],
     properties: {
-        id: {
-            type: 'string',
-            format: 'uuid',
-            description: 'Unique identifier for the conversation'
-        },
-        workspace_id: {
-            type: 'string',
-            description: 'The workspace ID where the conversation belongs'
-        },
-        flow_path: {
-            type: 'string',
-            description: 'Path of the flow this conversation is for'
-        },
-        title: {
+        status: {
             type: 'string',
-            description: 'Optional title for the conversation',
-            nullable: true
+            enum: ['healthy', 'degraded', 'unhealthy'],
+            description: 'Overall health status'
         },
-        created_at: {
+        checked_at: {
             type: 'string',
             format: 'date-time',
-            description: 'When the conversation was created'
+            description: 'Timestamp when the health check was actually performed (not cache return time)'
         },
-        updated_at: {
-            type: 'string',
-            format: 'date-time',
-            description: 'When the conversation was last updated'
+        database_healthy: {
+            type: 'boolean',
+            description: 'Whether the database is reachable'
         },
-        created_by: {
-            type: 'string',
-            description: 'Username who created the conversation'
+        workers_alive: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of workers that pinged within last 5 minutes'
         }
     }
 };
-export const $FlowConversationMessage = {
+export const $DetailedHealthResponse = {
     type: 'object',
-    required: ['id', 'conversation_id', 'message_type', 'content', 'created_at'],
+    description: 'Detailed health status response (always fresh, no caching)',
+    required: ['status', 'checked_at', 'version', 'checks'],
     properties: {
-        id: {
-            type: 'string',
-            format: 'uuid',
-            description: 'Unique identifier for the message'
-        },
-        conversation_id: {
-            type: 'string',
-            format: 'uuid',
-            description: 'The conversation this message belongs to'
-        },
-        message_type: {
-            type: 'string',
-            enum: ['user', 'assistant', 'system', 'tool'],
-            description: 'Type of the message'
-        },
-        content: {
-            type: 'string',
-            description: 'The message content'
-        },
-        job_id: {
+        status: {
             type: 'string',
-            format: 'uuid',
-            nullable: true,
-            description: 'Associated job ID if this message came from a flow run'
+            enum: ['healthy', 'degraded', 'unhealthy'],
+            description: 'Overall health status'
         },
-        created_at: {
+        checked_at: {
             type: 'string',
             format: 'date-time',
-            description: 'When the message was created'
+            description: 'Timestamp when the health check was performed'
         },
-        step_name: {
+        version: {
             type: 'string',
-            description: 'The step name that produced that message'
+            description: 'Server version (e.g., "EE 1.615.3")'
         },
-        success: {
-            type: 'boolean',
-            description: 'Whether the message is a success'
+        checks: {
+            '$ref': '#/components/schemas/HealthChecks'
         }
     }
 };
-export const $EndpointTool = {
+export const $HealthChecks = {
     type: 'object',
-    required: ['name', 'description', 'instructions', 'path', 'method'],
+    description: 'Detailed health checks',
+    required: ['database', 'readiness'],
     properties: {
-        name: {
-            type: 'string',
-            description: 'The tool name/operation ID'
-        },
-        description: {
-            type: 'string',
-            description: 'Short description of the tool'
-        },
-        instructions: {
-            type: 'string',
-            description: 'Detailed instructions for using the tool'
-        },
-        path: {
-            type: 'string',
-            description: 'API endpoint path'
-        },
-        method: {
-            type: 'string',
-            description: 'HTTP method (GET, POST, etc.)'
+        database: {
+            '$ref': '#/components/schemas/DatabaseHealth'
         },
-        path_params_schema: {
-            type: 'object',
-            description: 'JSON schema for path parameters',
+        workers: {
+            '$ref': '#/components/schemas/WorkersHealth',
+            description: 'Worker status (null if database is unreachable)',
             nullable: true
         },
-        query_params_schema: {
-            type: 'object',
-            description: 'JSON schema for query parameters',
+        queue: {
+            '$ref': '#/components/schemas/QueueHealth',
+            description: 'Queue status (null if database is unreachable)',
             nullable: true
         },
-        body_schema: {
-            type: 'object',
-            description: 'JSON schema for request body',
-            nullable: true
+        readiness: {
+            '$ref': '#/components/schemas/ReadinessHealth'
         }
     }
 };
-export const $AIProvider = {
-    type: 'string',
-    enum: ['openai', 'azure_openai', 'anthropic', 'mistral', 'deepseek', 'googleai', 'groq', 'openrouter', 'togetherai', 'aws_bedrock', 'customai']
-};
-export const $GitSyncObjectType = {
-    type: 'string',
-    enum: ['script', 'flow', 'app', 'folder', 'resource', 'variable', 'secret', 'resourcetype', 'schedule', 'user', 'group', 'trigger', 'settings', 'key']
+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 $AIProviderModel = {
+export const $PoolStats = {
     type: 'object',
+    description: 'Database connection pool statistics',
+    required: ['size', 'idle', 'max_connections'],
     properties: {
-        model: {
-            type: 'string'
+        size: {
+            type: 'integer',
+            description: 'Current number of connections in the pool'
         },
-        provider: {
-            '$ref': '#/components/schemas/AIProvider'
+        idle: {
+            type: 'integer',
+            description: 'Number of idle connections'
+        },
+        max_connections: {
+            type: 'integer',
+            description: 'Maximum number of connections allowed'
         }
-    },
-    required: ['model', 'provider']
+    }
 };
-export const $AIProviderConfig = {
+export const $WorkersHealth = {
     type: 'object',
+    description: 'Workers health status',
+    required: ['healthy', 'active_count', 'worker_groups', 'min_version', 'versions'],
     properties: {
-        resource_path: {
-            type: 'string'
+        healthy: {
+            type: 'boolean',
+            description: 'Whether any workers are active'
         },
-        models: {
+        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'
         }
-    },
-    required: ['resource_path', 'models']
+    }
 };
-export const $AIConfig = {
+export const $QueueHealth = {
     type: 'object',
+    description: 'Job queue status',
+    required: ['pending_jobs', 'running_jobs'],
     properties: {
-        providers: {
-            type: 'object',
+        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',
+    properties: {
+        enabled: {
+            type: 'boolean',
+            default: false
+        },
+        domain: {
+            type: 'string'
+        },
+        operator: {
+            type: 'boolean',
+            default: false,
+            description: 'If true, auto-invited users are added as operators. If false, they are added as developers.'
+        },
+        mode: {
+            type: 'string',
+            enum: ['invite', 'add'],
+            default: 'invite'
+        },
+        instance_groups: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        },
+        instance_groups_roles: {
+            type: 'object',
+            additionalProperties: {
+                type: 'string'
+            }
+        }
+    }
+};
+export const $ErrorHandlerConfig = {
+    type: 'object',
+    description: 'Configuration for the workspace error handler',
+    properties: {
+        path: {
+            type: 'string',
+            description: 'Path to the error handler script or flow'
+        },
+        extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        },
+        muted_on_cancel: {
+            type: 'boolean',
+            default: false
+        },
+        muted_on_user_path: {
+            type: 'boolean',
+            default: false
+        }
+    }
+};
+export const $SuccessHandlerConfig = {
+    type: 'object',
+    description: 'Configuration for the workspace success handler',
+    properties: {
+        path: {
+            type: 'string',
+            description: 'Path to the success handler script or flow'
+        },
+        extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        }
+    }
+};
+export const $EditErrorHandler = {
+    description: 'Request body for editing the workspace error handler. Accepts both new grouped format and legacy flat format for backward compatibility.',
+    oneOf: [
+        {
+            '$ref': '#/components/schemas/EditErrorHandlerNew'
+        },
+        {
+            '$ref': '#/components/schemas/EditErrorHandlerLegacy'
+        }
+    ]
+};
+export const $EditErrorHandlerNew = {
+    type: 'object',
+    description: 'New grouped format for editing error handler',
+    properties: {
+        path: {
+            type: 'string',
+            description: 'Path to the error handler script or flow'
+        },
+        extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        },
+        muted_on_cancel: {
+            type: 'boolean',
+            default: false
+        },
+        muted_on_user_path: {
+            type: 'boolean',
+            default: false
+        }
+    }
+};
+export const $EditErrorHandlerLegacy = {
+    type: 'object',
+    description: 'Legacy flat format for editing error handler (deprecated, use new format)',
+    properties: {
+        error_handler: {
+            type: 'string',
+            description: 'Path to the error handler script or flow'
+        },
+        error_handler_extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        },
+        error_handler_muted_on_cancel: {
+            type: 'boolean',
+            default: false
+        }
+    }
+};
+export const $EditSuccessHandler = {
+    description: 'Request body for editing the workspace success handler. Accepts both new grouped format and legacy flat format for backward compatibility.',
+    oneOf: [
+        {
+            '$ref': '#/components/schemas/EditSuccessHandlerNew'
+        },
+        {
+            '$ref': '#/components/schemas/EditSuccessHandlerLegacy'
+        }
+    ]
+};
+export const $EditSuccessHandlerNew = {
+    type: 'object',
+    description: 'New grouped format for editing success handler',
+    properties: {
+        path: {
+            type: 'string',
+            description: 'Path to the success handler script or flow'
+        },
+        extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        }
+    }
+};
+export const $EditSuccessHandlerLegacy = {
+    type: 'object',
+    description: 'Legacy flat format for editing success handler (deprecated, use new format)',
+    properties: {
+        success_handler: {
+            type: 'string',
+            description: 'Path to the success handler script or flow'
+        },
+        success_handler_extra_args: {
+            '$ref': '#/components/schemas/ScriptArgs'
+        }
+    }
+};
+export const $VaultSettings = {
+    type: 'object',
+    required: ['address', 'mount_path'],
+    properties: {
+        address: {
+            type: 'string',
+            description: 'HashiCorp Vault server address (e.g., https://vault.company.com:8200)'
+        },
+        mount_path: {
+            type: 'string',
+            description: 'KV v2 secrets engine mount path (e.g., windmill)'
+        },
+        jwt_role: {
+            type: 'string',
+            description: 'Vault JWT auth role name for Windmill (optional, if not provided token auth is used)'
+        },
+        namespace: {
+            type: 'string',
+            description: 'Vault Enterprise namespace (optional)'
+        },
+        token: {
+            type: 'string',
+            description: 'Static Vault token for testing/development (optional, if provided this is used instead of JWT authentication)'
+        }
+    }
+};
+export const $SecretMigrationFailure = {
+    type: 'object',
+    required: ['workspace_id', 'path', 'error'],
+    properties: {
+        workspace_id: {
+            type: 'string',
+            description: 'Workspace ID where the secret is located'
+        },
+        path: {
+            type: 'string',
+            description: 'Path of the secret that failed to migrate'
+        },
+        error: {
+            type: 'string',
+            description: 'Error message'
+        }
+    }
+};
+export const $SecretMigrationReport = {
+    type: 'object',
+    required: ['total_secrets', 'migrated_count', 'failed_count', 'failures'],
+    properties: {
+        total_secrets: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Total number of secrets found'
+        },
+        migrated_count: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of secrets successfully migrated'
+        },
+        failed_count: {
+            type: 'integer',
+            format: 'int64',
+            description: 'Number of secrets that failed to migrate'
+        },
+        failures: {
+            type: 'array',
+            items: {
+                '$ref': '#/components/schemas/SecretMigrationFailure'
+            },
+            description: 'Details of any failures encountered during migration'
+        }
+    }
+};
+export const $JwksResponse = {
+    type: 'object',
+    required: ['keys'],
+    properties: {
+        keys: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: true
+            },
+            description: 'Array of JSON Web Keys for JWT verification'
+        }
+    }
+};
+export const $FlowConversation = {
+    type: 'object',
+    required: ['id', 'workspace_id', 'flow_path', 'created_at', 'updated_at', 'created_by'],
+    properties: {
+        id: {
+            type: 'string',
+            format: 'uuid',
+            description: 'Unique identifier for the conversation'
+        },
+        workspace_id: {
+            type: 'string',
+            description: 'The workspace ID where the conversation belongs'
+        },
+        flow_path: {
+            type: 'string',
+            description: 'Path of the flow this conversation is for'
+        },
+        title: {
+            type: 'string',
+            description: 'Optional title for the conversation',
+            nullable: true
+        },
+        created_at: {
+            type: 'string',
+            format: 'date-time',
+            description: 'When the conversation was created'
+        },
+        updated_at: {
+            type: 'string',
+            format: 'date-time',
+            description: 'When the conversation was last updated'
+        },
+        created_by: {
+            type: 'string',
+            description: 'Username who created the conversation'
+        }
+    }
+};
+export const $FlowConversationMessage = {
+    type: 'object',
+    required: ['id', 'conversation_id', 'message_type', 'content', 'created_at'],
+    properties: {
+        id: {
+            type: 'string',
+            format: 'uuid',
+            description: 'Unique identifier for the message'
+        },
+        conversation_id: {
+            type: 'string',
+            format: 'uuid',
+            description: 'The conversation this message belongs to'
+        },
+        message_type: {
+            type: 'string',
+            enum: ['user', 'assistant', 'system', 'tool'],
+            description: 'Type of the message'
+        },
+        content: {
+            type: 'string',
+            description: 'The message content'
+        },
+        job_id: {
+            type: 'string',
+            format: 'uuid',
+            nullable: true,
+            description: 'Associated job ID if this message came from a flow run'
+        },
+        created_at: {
+            type: 'string',
+            format: 'date-time',
+            description: 'When the message was created'
+        },
+        step_name: {
+            type: 'string',
+            description: 'The step name that produced that message'
+        },
+        success: {
+            type: 'boolean',
+            description: 'Whether the message is a success'
+        }
+    }
+};
+export const $EndpointTool = {
+    type: 'object',
+    required: ['name', 'description', 'instructions', 'path', 'method'],
+    properties: {
+        name: {
+            type: 'string',
+            description: 'The tool name/operation ID'
+        },
+        description: {
+            type: 'string',
+            description: 'Short description of the tool'
+        },
+        instructions: {
+            type: 'string',
+            description: 'Detailed instructions for using the tool'
+        },
+        path: {
+            type: 'string',
+            description: 'API endpoint path'
+        },
+        method: {
+            type: 'string',
+            description: 'HTTP method (GET, POST, etc.)'
+        },
+        path_params_schema: {
+            type: 'object',
+            description: 'JSON schema for path parameters',
+            nullable: true
+        },
+        query_params_schema: {
+            type: 'object',
+            description: 'JSON schema for query parameters',
+            nullable: true
+        },
+        body_schema: {
+            type: 'object',
+            description: 'JSON schema for request body',
+            nullable: true
+        }
+    }
+};
+export const $AIProvider = {
+    type: 'string',
+    enum: ['openai', 'azure_openai', 'anthropic', 'mistral', 'deepseek', 'googleai', 'groq', 'openrouter', 'togetherai', 'aws_bedrock', 'customai']
+};
+export const $GitSyncObjectType = {
+    type: 'string',
+    enum: ['script', 'flow', 'app', 'folder', 'resource', 'variable', 'secret', 'resourcetype', 'schedule', 'user', 'group', 'trigger', 'settings', 'key']
+};
+export const $AIProviderModel = {
+    type: 'object',
+    properties: {
+        model: {
+            type: 'string'
+        },
+        provider: {
+            '$ref': '#/components/schemas/AIProvider'
+        }
+    },
+    required: ['model', 'provider']
+};
+export const $AIProviderConfig = {
+    type: 'object',
+    properties: {
+        resource_path: {
+            type: 'string'
+        },
+        models: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        }
+    },
+    required: ['resource_path', 'models']
+};
+export const $AIConfig = {
+    type: 'object',
+    properties: {
+        providers: {
+            type: 'object',
             additionalProperties: {
                 '$ref': '#/components/schemas/AIProviderConfig'
             }
@@ -1781,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',
@@ -2551,6 +3194,15 @@ export const $Login = {
     },
     required: ['email', 'password']
 };
+export const $PasswordResetResponse = {
+    type: 'object',
+    properties: {
+        message: {
+            type: 'string'
+        }
+    },
+    required: ['message']
+};
 export const $EditWorkspaceUser = {
     type: 'object',
     properties: {
@@ -2936,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',
@@ -3186,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']
@@ -3323,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']
@@ -3430,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']
@@ -3519,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',
@@ -3530,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']
@@ -3699,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']
@@ -3762,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']
@@ -3841,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']
@@ -3959,6 +4758,12 @@ export const $TriggersCount = {
         },
         sqs_count: {
             type: 'number'
+        },
+        nextcloud_count: {
+            type: 'number'
+        },
+        google_count: {
+            type: 'number'
         }
     }
 };
@@ -3971,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: {
@@ -3998,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'
         }
     },
@@ -4027,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: {
@@ -4056,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'
         }
     },
@@ -4085,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: {
@@ -4111,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'
         }
     },
@@ -4221,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']
@@ -4267,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']
@@ -4315,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']
@@ -4382,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']
@@ -4430,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',
@@ -4475,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']
@@ -4517,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']
@@ -4611,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']
@@ -4653,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']
@@ -4792,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']
@@ -4826,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']
@@ -4865,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']
@@ -4909,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'
+            },
+            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: [
@@ -5026,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']
@@ -5069,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']
@@ -5114,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']
@@ -5419,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']
@@ -5982,9 +7075,7 @@ export const $AppWithLastVersion = {
             type: 'string',
             format: 'date-time'
         },
-        value: {
-            type: 'object'
-        },
+        value: {},
         policy: {
             '$ref': '#/components/schemas/Policy'
         },
@@ -6000,9 +7091,15 @@ export const $AppWithLastVersion = {
         },
         custom_path: {
             type: 'string'
+        },
+        raw_app: {
+            type: 'boolean'
+        },
+        bundle_secret: {
+            type: 'string'
         }
     },
-    required: ['id', 'workspace_id', 'path', 'summary', 'versions', 'created_by', 'created_at', 'value', 'policy', 'execution_mode', 'extra_perms']
+    required: ['id', 'workspace_id', 'path', 'summary', 'versions', 'created_by', 'created_at', 'value', 'policy', 'execution_mode', 'extra_perms', 'raw_app']
 };
 export const $AppWithLastVersionWDraft = {
     allOf: [
@@ -6193,6 +7290,9 @@ export const $DucklakeSettings = {
                             }
                         },
                         required: ['path']
+                    },
+                    extra_args: {
+                        type: 'string'
                     }
                 }
             }
@@ -6227,6 +7327,34 @@ export const $DataTableSettings = {
         }
     }
 };
+export const $DataTableSchema = {
+    type: 'object',
+    required: ['datatable_name', 'schemas'],
+    properties: {
+        datatable_name: {
+            type: 'string'
+        },
+        schemas: {
+            type: 'object',
+            description: "Hierarchical schema: schema_name -> table_name -> column_name -> compact_type (e.g. 'int4', 'text?', 'int4?=0')",
+            additionalProperties: {
+                type: 'object',
+                description: 'Tables in this schema',
+                additionalProperties: {
+                    type: 'object',
+                    description: 'Columns in this table',
+                    additionalProperties: {
+                        type: 'string',
+                        description: "Compact type: 'type[?][=default]' where ? means nullable"
+                    }
+                }
+            }
+        },
+        error: {
+            type: 'string'
+        }
+    }
+};
 export const $DynamicInputData = {
     type: 'object',
     properties: {
@@ -6609,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: {
@@ -6848,7 +7995,7 @@ export const $WorkspaceItemDiff = {
     properties: {
         kind: {
             type: 'string',
-            enum: ['script', 'flow', 'app', 'resource', 'variable'],
+            enum: ['script', 'flow', 'app', 'resource', 'variable', 'resource_type'],
             description: 'Type of the item'
         },
         path: {
@@ -6879,7 +8026,7 @@ export const $WorkspaceItemDiff = {
 };
 export const $CompareSummary = {
     type: 'object',
-    required: ['total_diffs', 'total_ahead', 'total_behind', 'scripts_changed', 'flows_changed', 'apps_changed', 'resources_changed', 'variables_changed', 'conflicts'],
+    required: ['total_diffs', 'total_ahead', 'total_behind', 'scripts_changed', 'flows_changed', 'apps_changed', 'resources_changed', 'variables_changed', 'resource_types_changed', 'folders_changed', 'conflicts'],
     properties: {
         total_diffs: {
             type: 'integer',
@@ -6913,6 +8060,14 @@ export const $CompareSummary = {
             type: 'integer',
             description: 'Number of variables with differences'
         },
+        resource_types_changed: {
+            type: 'integer',
+            description: 'Number of resource types with differences'
+        },
+        folders_changed: {
+            type: 'integer',
+            description: 'Number of folders with differences'
+        },
         conflicts: {
             type: 'integer',
             description: 'Number of items that are both ahead and behind (conflicts)'
@@ -7071,11 +8226,12 @@ export const $TeamsChannel = {
 };
 export const $AssetUsageKind = {
     type: 'string',
-    enum: ['script', 'flow']
+    enum: ['script', 'flow', 'job']
 };
 export const $AssetUsageAccessType = {
     type: 'string',
-    enum: ['r', 'w', 'rw']
+    enum: ['r', 'w', 'rw'],
+    nullable: true
 };
 export const $AssetKind = {
     type: 'string',
@@ -7093,3 +8249,340 @@ 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', 'google']
+};
+export const $NativeTrigger = {
+    type: 'object',
+    description: 'A native trigger stored in Windmill',
+    properties: {
+        external_id: {
+            type: 'string',
+            description: 'The unique identifier from the external service'
+        },
+        workspace_id: {
+            type: 'string',
+            description: 'The workspace this trigger belongs to'
+        },
+        service_name: {
+            '$ref': '#/components/schemas/NativeServiceName'
+        },
+        script_path: {
+            type: 'string',
+            description: 'The path to the script or flow that will be triggered'
+        },
+        is_flow: {
+            type: 'boolean',
+            description: 'Whether the trigger targets a flow (true) or a script (false)'
+        },
+        service_config: {
+            type: 'object',
+            description: 'Configuration for the trigger including event_type and service_config',
+            additionalProperties: true
+        },
+        error: {
+            type: 'string',
+            nullable: true,
+            description: 'Error message if the trigger is in an error state'
+        }
+    },
+    required: ['external_id', 'workspace_id', 'service_name', 'script_path', 'is_flow', 'service_config']
+};
+export const $NativeTriggerWithExternal = {
+    type: 'object',
+    description: 'Full trigger response containing both Windmill data and external service data',
+    properties: {
+        external_id: {
+            type: 'string',
+            description: 'The unique identifier from the external service'
+        },
+        workspace_id: {
+            type: 'string',
+            description: 'The workspace this trigger belongs to'
+        },
+        service_name: {
+            '$ref': '#/components/schemas/NativeServiceName'
+        },
+        script_path: {
+            type: 'string',
+            description: 'The path to the script or flow that will be triggered'
+        },
+        is_flow: {
+            type: 'boolean',
+            description: 'Whether the trigger targets a flow (true) or a script (false)'
+        },
+        service_config: {
+            type: 'object',
+            description: 'Configuration for the trigger including event_type and service_config',
+            additionalProperties: true
+        },
+        error: {
+            type: 'string',
+            nullable: true,
+            description: 'Error message if the trigger is in an error state'
+        },
+        external_data: {
+            type: 'object',
+            description: 'Configuration data from the external service',
+            additionalProperties: true
+        }
+    },
+    required: ['external_id', 'workspace_id', 'service_name', 'script_path', 'is_flow', 'service_config', 'external_data']
+};
+export const $WorkspaceIntegrations = {
+    type: 'object',
+    properties: {
+        service_name: {
+            '$ref': '#/components/schemas/NativeServiceName'
+        },
+        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']
+};
+export const $WorkspaceOAuthConfig = {
+    type: 'object',
+    properties: {
+        client_id: {
+            type: 'string',
+            description: 'The OAuth client ID for the workspace'
+        },
+        client_secret: {
+            type: 'string',
+            description: 'The OAuth client secret for the workspace'
+        },
+        base_url: {
+            type: 'string',
+            format: 'uri',
+            description: 'The base URL of the workspace'
+        },
+        redirect_uri: {
+            type: 'string',
+            format: 'uri',
+            description: 'The OAuth redirect URI'
+        }
+    },
+    required: ['client_id', 'client_secret', 'base_url', 'redirect_uri']
+};
+export const $WebhookEvent = {
+    type: 'object',
+    properties: {
+        type: {
+            type: 'string',
+            enum: ['webhook']
+        },
+        request_type: {
+            '$ref': '#/components/schemas/WebhookRequestType'
+        }
+    },
+    required: ['type', 'request_type']
+};
+export const $WebhookRequestType = {
+    type: 'string',
+    description: 'The type of webhook request (define possible values here)',
+    enum: ['async', 'sync']
+};
+export const $RedirectUri = {
+    type: 'object',
+    properties: {
+        redirect_uri: {
+            type: 'string'
+        }
+    },
+    required: ['redirect_uri']
+};
+export const $NativeTriggerData = {
+    type: 'object',
+    description: 'Data for creating or updating a native trigger',
+    properties: {
+        script_path: {
+            type: 'string',
+            description: 'The path to the script or flow that will be triggered'
+        },
+        is_flow: {
+            type: 'boolean',
+            description: 'Whether the trigger targets a flow (true) or a script (false)'
+        },
+        service_config: {
+            type: 'object',
+            description: 'Service-specific configuration (e.g., event types, filters)',
+            additionalProperties: true
+        }
+    },
+    required: ['script_path', 'is_flow', 'service_config']
+};
+export const $CreateTriggerResponse = {
+    type: 'object',
+    description: 'Response returned when a native trigger is created',
+    properties: {
+        external_id: {
+            type: 'string',
+            description: 'The external ID of the created trigger from the external service'
+        }
+    },
+    required: ['external_id']
+};
+export const $SyncResult = {
+    type: 'object',
+    properties: {
+        already_in_sync: {
+            type: 'boolean'
+        },
+        added_count: {
+            type: 'integer'
+        },
+        added_triggers: {
+            type: 'array',
+            items: {
+                type: 'string'
+            }
+        },
+        total_external: {
+            type: 'integer'
+        },
+        total_windmill: {
+            type: 'integer'
+        }
+    },
+    required: ['already_in_sync', 'added_count', 'added_triggers', 'total_external', 'total_windmill']
+};
+export const $NextCloudEventType = {
+    type: 'object',
+    properties: {
+        id: {
+            type: 'string'
+        },
+        name: {
+            type: 'string'
+        },
+        description: {
+            type: 'string'
+        },
+        category: {
+            type: 'string'
+        },
+        path: {
+            type: 'string'
+        }
+    },
+    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']
+};