sealos-cli 0.1.0

package/src/generated/database.ts

@@ -0,0 +1,3969 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/databases": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all databases
+         * @description Returns all database clusters in the current namespace with their status and resource allocation.
+         */
+        get: operations["listDatabases"];
+        put?: never;
+        /**
+         * Create database
+         * @description Provisions a new database cluster. The database is created asynchronously — the request returns immediately and the cluster becomes available shortly after.
+         *
+         *     **Example — PostgreSQL with daily backup:**
+         *     ```json
+         *     {
+         *       "name": "my-postgres-db",
+         *       "type": "postgresql",
+         *       "version": "postgresql-14.8.0",
+         *       "quota": { "cpu": 1, "memory": 2, "storage": 5, "replicas": 1 },
+         *       "autoBackup": {
+         *         "start": true,
+         *         "type": "day",
+         *         "hour": "02",
+         *         "minute": "00",
+         *         "saveTime": 7,
+         *         "saveType": "days"
+         *       }
+         *     }
+         *     ```
+         *
+         *     **Example — Redis (minimal):**
+         *     ```json
+         *     {
+         *       "name": "my-redis",
+         *       "type": "redis",
+         *       "quota": { "cpu": 1, "memory": 1, "storage": 3, "replicas": 1 }
+         *     }
+         *     ```
+         */
+        post: operations["createDatabase"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get database details
+         * @description Returns detailed information about a specific database including its current status, resource allocation, and configuration.
+         */
+        get: operations["getDatabase"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete database
+         * @description Deletes a database cluster. **Irreversible** — depending on `terminationPolicy`, persistent volumes may also be removed. This operation is idempotent: if the database does not exist, `204` is returned.
+         */
+        delete: operations["deleteDatabase"];
+        options?: never;
+        head?: never;
+        /**
+         * Update database resources
+         * @description Updates a database's resource allocation (CPU, memory, storage, replicas). Only provide fields you want to change — all fields are optional.
+         *
+         *     Key points:
+         *     - CPU: one of `1, 2, 3, 4, 5, 6, 7, 8` cores
+         *     - Memory: one of `1, 2, 4, 6, 8, 12, 16, 32` GB
+         *     - Storage: `1–300` GB (can only be expanded, not shrunk)
+         *     - Replicas: `1–20`
+         */
+        patch: operations["updateDatabase"];
+        trace?: never;
+    };
+    "/databases/{databaseName}/start": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start database
+         * @description Resumes a paused or stopped database. This operation is idempotent: if the database is already running, `204` is returned.
+         */
+        post: operations["startDatabase"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/pause": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Pause database
+         * @description Gracefully stops a running database while preserving all data and configuration. The database can be resumed with the `start` operation.
+         */
+        post: operations["pauseDatabase"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/restart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Restart database
+         * @description Performs a rolling restart of all database replicas. This operation is idempotent: if a restart is already in progress, `204` is returned.
+         */
+        post: operations["restartDatabase"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/backups": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List database backups
+         * @description Returns all manual and automatic backups associated with the specified database, including status and creation timestamp.
+         */
+        get: operations["listDatabaseBackups"];
+        put?: never;
+        /**
+         * Create database backup
+         * @description Initiates a manual backup of the database. The backup is created asynchronously.
+         */
+        post: operations["createDatabaseBackup"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/backups/{backupName}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete database backup
+         * @description Deletes a backup. **Irreversible.** This operation is idempotent: if the backup does not exist, `204` is returned.
+         */
+        delete: operations["deleteDatabaseBackup"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/backups/{backupName}/restore": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Restore database from backup
+         * @description Creates a new database cluster restored from the specified backup. Useful for point-in-time recovery or cloning a database for testing.
+         *
+         *     Key points:
+         *     - All body fields are optional — if `name` is omitted a name is auto-generated, if `replicas` is omitted the source cluster replica count is used.
+         *     - The restored database is a completely new cluster — it does not modify or delete the backup.
+         */
+        post: operations["restoreDatabase"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/enable-public": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Enable public access
+         * @description Exposes the database externally via a NodePort or LoadBalancer service. After this succeeds, external connection details are available via `GET /databases/{databaseName}`.
+         */
+        post: operations["enablePublicAccess"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/{databaseName}/disable-public": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Disable public access
+         * @description Removes the external NodePort or LoadBalancer service, restricting database access to within the cluster.
+         */
+        post: operations["disablePublicAccess"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/databases/versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List available database versions
+         * @description Returns all supported database versions per engine type. Use these version strings when creating a new database.
+         *
+         *     This endpoint does not require authentication — it queries the cluster using the server’s own service account.
+         */
+        get: operations["listDatabaseVersions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/logs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get database log entries
+         * @description Returns paginated log entries from a specific database pod. Use `/logs/files` first to discover available log file paths.
+         */
+        get: operations["getDatabaseLogsData"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/logs/files": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List database log files
+         * @description Returns metadata about available log files for a specific database pod. Use the returned paths with `GET /logs` to fetch log entries.
+         */
+        get: operations["listDatabaseLogFiles"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** @description Resource configuration for database update. All fields are optional. */
+        UpdateResourceSchema: {
+            /**
+             * @description CPU cores. Allowed values: 1, 2, 3, 4, 5, 6, 7, or 8 (converted to millicores in K8s)
+             * @example 2
+             * @enum {number}
+             */
+            cpu?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+            /**
+             * @description Memory in GB. Allowed values: 1, 2, 4, 6, 8, 12, 16, or 32 GB (converted to Gi in K8s)
+             * @example 4
+             * @enum {number}
+             */
+            memory?: 1 | 2 | 4 | 6 | 8 | 12 | 16 | 32;
+            /**
+             * @description Storage in GB (1–300). Storage can only be expanded, not shrunk (converted to Gi in K8s)
+             * @example 20
+             */
+            storage?: number;
+            /**
+             * @description Number of replicas (1–20)
+             * @example 2
+             */
+            replicas?: number;
+        };
+        /** @description Full Kubernetes cluster resource object */
+        K8sClusterResource: {
+            [key: string]: unknown;
+        };
+        OpsRequest: {
+            /** @example apps.kubeblocks.io/v1alpha1 */
+            apiVersion?: string;
+            /** @example OpsRequest */
+            kind?: string;
+            metadata?: {
+                name?: string;
+                namespace?: string;
+                labels?: {
+                    [key: string]: string;
+                };
+            };
+            spec?: {
+                [key: string]: unknown;
+            };
+            status?: {
+                [key: string]: unknown;
+            };
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listDatabases: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of databases retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Database name
+                         * @example my-postgres-db
+                         */
+                        name?: string;
+                        /**
+                         * @description Unique identifier
+                         * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+                         */
+                        uid?: string;
+                        /**
+                         * @description Database engine
+                         * @example postgresql
+                         */
+                        type?: string;
+                        /**
+                         * @description Database version
+                         * @example postgresql-14.8.0
+                         */
+                        version?: string;
+                        /**
+                         * @description Resource type identifier — always "cluster"
+                         * @example cluster
+                         */
+                        resourceType?: string;
+                        /**
+                         * @description Current cluster status
+                         * @example Running
+                         * @enum {string}
+                         */
+                        status?: "Running" | "Stopped" | "Creating" | "Updating" | "Failed" | "Deleting";
+                        /** @description Resource allocation for each database replica */
+                        quota?: {
+                            /**
+                             * @description CPU cores per replica
+                             * @example 1
+                             */
+                            cpu?: number;
+                            /**
+                             * @description Memory in GB per replica
+                             * @example 2
+                             */
+                            memory?: number;
+                            /**
+                             * @description Storage in GB per replica
+                             * @example 5
+                             */
+                            storage?: number;
+                            /**
+                             * @description Number of database replicas
+                             * @example 1
+                             */
+                            replicas?: number;
+                        };
+                    }[];
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Database configuration including type, version, resources, and optional backup/parameter settings */
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Cluster termination policy. "delete" removes the cluster but keeps PVCs, "wipeout" removes everything including data. Defaults to "delete" if not provided.
+                     * @default delete
+                     * @example delete
+                     * @enum {string}
+                     */
+                    terminationPolicy?: "delete" | "wipeout";
+                    /**
+                     * @description Database name. Must be a valid Kubernetes resource name (lowercase alphanumeric and hyphens)
+                     * @example my-postgres-db
+                     */
+                    name: string;
+                    /**
+                     * @description Database type/engine to deploy
+                     * @example postgresql
+                     * @enum {string}
+                     */
+                    type: "postgresql" | "mongodb" | "apecloud-mysql" | "mysql" | "redis" | "kafka" | "qdrant" | "nebula" | "weaviate" | "milvus" | "pulsar" | "clickhouse";
+                    /**
+                     * @description Database version (e.g., "14.8.0" for PostgreSQL). Must match available versions from /databases/versions endpoint. If not provided, the latest version for the specified database type will be automatically selected.
+                     * @example postgresql-14.8.0
+                     */
+                    version?: string;
+                    /** @description Resource allocation for the database cluster. All four fields are required. */
+                    quota: {
+                        /**
+                         * @description CPU cores allocated to each database instance. Allowed values: 1, 2, 3, 4, 5, 6, 7, or 8 (converted to millicores in Kubernetes)
+                         * @default 1
+                         * @example 1
+                         * @enum {number}
+                         */
+                        cpu: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+                        /**
+                         * @description Memory in GB allocated to each database instance - range [0.1, 32] (automatically converted to Gi in Kubernetes)
+                         * @default 1
+                         * @example 2
+                         */
+                        memory: number;
+                        /**
+                         * @description Persistent storage in GB for each database instance (automatically converted to Gi in Kubernetes)
+                         * @default 3
+                         * @example 5
+                         */
+                        storage: number;
+                        /**
+                         * @description Number of database replicas for high availability
+                         * @default 3
+                         * @example 1
+                         */
+                        replicas: number;
+                    };
+                    /** @description Automatic backup configuration (optional). If not provided, no automatic backups will be configured */
+                    autoBackup?: {
+                        /**
+                         * @description Enable automatic backups
+                         * @example true
+                         */
+                        start?: boolean;
+                        /**
+                         * @description Backup frequency type
+                         * @example day
+                         * @enum {string}
+                         */
+                        type?: "day" | "hour" | "week";
+                        /**
+                         * @description Days of the week to run backups (for weekly backups)
+                         * @example [
+                         *       "monday"
+                         *     ]
+                         */
+                        week?: ("monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday")[];
+                        /**
+                         * @description Hour to run backup (24-hour format, 00-23)
+                         * @example 02
+                         */
+                        hour?: string;
+                        /**
+                         * @description Minute to run backup (00-59)
+                         * @example 00
+                         */
+                        minute?: string;
+                        /**
+                         * @description Backup retention duration
+                         * @example 7
+                         */
+                        saveTime?: number;
+                        /**
+                         * @description Backup retention unit
+                         * @example days
+                         * @enum {string}
+                         */
+                        saveType?: "days" | "hours" | "weeks" | "months";
+                    };
+                    /** @description Database-specific parameter configuration (optional). Available parameters vary by database type */
+                    parameterConfig?: {
+                        /**
+                         * @description Maximum number of database connections
+                         * @example 100
+                         */
+                        maxConnections?: string;
+                        /**
+                         * @description Database timezone (e.g., "Asia/Shanghai", "UTC")
+                         * @example Asia/Shanghai
+                         */
+                        timeZone?: string;
+                        /**
+                         * @description MySQL-specific: whether table names are case-sensitive. 0=case-sensitive, 1=case-insensitive
+                         * @example 0
+                         * @enum {string}
+                         */
+                        lowerCaseTableNames?: "0" | "1";
+                        /**
+                         * @description Redis-specific: maximum memory usage in bytes
+                         * @example 512mb
+                         */
+                        maxmemory?: string;
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description Database created. The Kubernetes Cluster resource has been created and provisioning is underway. Poll `GET /databases/{databaseName}` until `status` is `"Running"`. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "name": "my-postgres-db",
+                     *       "status": "creating"
+                     *     }
+                     */
+                    "application/json": {
+                        /**
+                         * @description Name of the created database
+                         * @example my-postgres-db
+                         */
+                        name: string;
+                        /**
+                         * @description Initial provisioning status — always "creating" at creation time
+                         * @example creating
+                         * @enum {string}
+                         */
+                        status: "creating";
+                    };
+                };
+            };
+            /** @description Bad request — invalid body, resource values, or parameter configuration */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — database with this name already exists */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database details retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Cluster termination policy. "delete" removes the cluster but keeps PVCs, "wipeout" removes everything including data.
+                         * @default delete
+                         * @example delete
+                         * @enum {string}
+                         */
+                        terminationPolicy: "delete" | "wipeout";
+                        /**
+                         * @description Database name (Kubernetes resource name — lowercase alphanumeric and hyphens)
+                         * @example my-postgres-db
+                         */
+                        name?: string;
+                        /**
+                         * @description Database engine type
+                         * @example postgresql
+                         * @enum {string}
+                         */
+                        type?: "postgresql" | "mongodb" | "apecloud-mysql" | "redis" | "kafka" | "qdrant" | "nebula" | "weaviate" | "milvus" | "pulsar" | "clickhouse";
+                        /**
+                         * @description Database version string (e.g. "postgresql-14.8.0")
+                         * @example postgresql-14.8.0
+                         */
+                        version?: string;
+                        /** @description Resource allocation for each database replica */
+                        quota?: {
+                            /**
+                             * @description CPU cores per replica
+                             * @example 1
+                             */
+                            cpu?: number;
+                            /**
+                             * @description Memory in GB per replica
+                             * @example 2
+                             */
+                            memory?: number;
+                            /**
+                             * @description Storage in GB per replica
+                             * @example 5
+                             */
+                            storage?: number;
+                            /**
+                             * @description Number of database replicas
+                             * @example 1
+                             */
+                            replicas?: number;
+                        };
+                        /** @description Automatic backup configuration */
+                        autoBackup?: {
+                            /**
+                             * @description Whether automatic backups are enabled
+                             * @example true
+                             */
+                            start?: boolean;
+                            /**
+                             * @description Backup frequency type
+                             * @example day
+                             * @enum {string}
+                             */
+                            type?: "day" | "hour" | "week";
+                            /**
+                             * @description Days of the week for weekly backups
+                             * @example [
+                             *       "monday"
+                             *     ]
+                             */
+                            week?: ("monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday")[];
+                            /**
+                             * @description Hour to run backup (24-hour format)
+                             * @example 02
+                             */
+                            hour?: string;
+                            /**
+                             * @description Minute to run backup
+                             * @example 00
+                             */
+                            minute?: string;
+                            /**
+                             * @description Backup retention duration
+                             * @example 7
+                             */
+                            saveTime?: number;
+                            /**
+                             * @description Backup retention unit
+                             * @example days
+                             * @enum {string}
+                             */
+                            saveType?: "days" | "hours" | "weeks" | "months";
+                        };
+                        /** @description Database-specific parameter configuration */
+                        parameterConfig?: {
+                            /**
+                             * @description Maximum number of database connections
+                             * @example 100
+                             */
+                            maxConnections?: string;
+                            /**
+                             * @description Database timezone
+                             * @example Asia/Shanghai
+                             */
+                            timeZone?: string;
+                            /**
+                             * @description MySQL-specific: case sensitivity for table names. 0=case-sensitive, 1=case-insensitive
+                             * @example 0
+                             * @enum {string}
+                             */
+                            lowerCaseTableNames?: "0" | "1";
+                            /**
+                             * @description Redis-specific: maximum memory usage
+                             * @example 512mb
+                             */
+                            maxmemory?: string;
+                        };
+                        /**
+                         * @description Unique identifier of the database resource
+                         * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+                         */
+                        uid?: string;
+                        /**
+                         * @description Current status of the database cluster
+                         * @example running
+                         * @enum {string}
+                         */
+                        status?: "creating" | "starting" | "stopping" | "stopped" | "running" | "updating" | "specUpdating" | "rebooting" | "upgrade" | "verticalScaling" | "volumeExpanding" | "failed" | "unknown" | "deleting";
+                        /**
+                         * @description Creation timestamp of the database cluster (ISO 8601)
+                         * @example 2024-01-15T10:30:00Z
+                         */
+                        createdAt?: string;
+                        /**
+                         * @description Resource type identifier — always "cluster"
+                         * @default cluster
+                         * @example cluster
+                         */
+                        resourceType: string;
+                        /**
+                         * @description Operational status flags from KubeBlocks (structure varies by version)
+                         * @example {}
+                         */
+                        operationalStatus?: {
+                            [key: string]: unknown;
+                        };
+                        /** @description Connection details for the database cluster */
+                        connection?: {
+                            /** @description Internal (in-cluster) connection details. null if not yet available. */
+                            privateConnection?: {
+                                /**
+                                 * @description host:port string for internal cluster access
+                                 * @example my-postgres-db-postgresql.ns-abc.svc.cluster.local:5432
+                                 */
+                                endpoint?: string;
+                                /**
+                                 * @description ClusterIP service hostname (internal only)
+                                 * @example my-postgres-db-postgresql.ns-abc.svc.cluster.local
+                                 */
+                                host?: string;
+                                /**
+                                 * @description Database port
+                                 * @example 5432
+                                 */
+                                port?: string;
+                                /**
+                                 * @description Database username
+                                 * @example postgres
+                                 */
+                                username?: string;
+                                /**
+                                 * @description Database password
+                                 * @example s3cr3tpassword
+                                 */
+                                password?: string;
+                                /**
+                                 * @description Ready-to-use connection string
+                                 * @example postgresql://postgres:s3cr3tpassword@my-postgres-db-postgresql.ns-abc.svc.cluster.local:5432/postgres
+                                 */
+                                connectionString?: string;
+                            } | null;
+                            /** @description External connection string via NodePort/LoadBalancer. null if public access is not enabled. */
+                            publicConnection?: string | null;
+                        };
+                        /** @description List of database pods and their current phase */
+                        pods?: {
+                            /**
+                             * @description Pod name
+                             * @example my-postgres-db-postgresql-0
+                             */
+                            name?: string;
+                            /**
+                             * @description Pod phase (e.g. "running", "pending", "failed")
+                             * @example running
+                             */
+                            status?: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deleteDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database deleted (or did not exist). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    updateDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        /** @description Resource updates to apply. All fields inside `quota` are optional — only provide fields you want to change. */
+        requestBody: {
+            content: {
+                "application/json": {
+                    quota: components["schemas"]["UpdateResourceSchema"];
+                };
+            };
+        };
+        responses: {
+            /** @description Database update initiated successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid resource values */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — database is currently being updated */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    startDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database start initiated (or was already running). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    pauseDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database pause initiated successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — database is already paused or a pause operation is in progress */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    restartDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database restart initiated (or was already restarting). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDatabaseBackups: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Backups retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Backup resource name
+                         * @example my-postgres-db-backup-20240115
+                         */
+                        name: string;
+                        /**
+                         * @description Optional description decoded from backup annotations. Empty string if none was provided.
+                         * @example weekly backup before schema migration
+                         */
+                        description: string;
+                        /**
+                         * Format: date-time
+                         * @description Creation timestamp of the backup resource
+                         * @example 2024-01-15T02:00:00Z
+                         */
+                        createdAt: string;
+                        /**
+                         * @description Current backup status as reported by Kubeblocks (lowercase)
+                         * @example completed
+                         * @enum {string}
+                         */
+                        status: "completed" | "inprogress" | "failed" | "unknown" | "running" | "deleting";
+                    }[];
+                };
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    createDatabaseBackup: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        /** @description Optional backup configuration including description annotation and explicit backup name */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description Optional description for the backup. Stored as label on the Backup resource (max 31 characters due to Kubernetes label value limit of 63 characters when hex-encoded) */
+                    description?: string;
+                    /** @description Optional custom backup name. If omitted, a name will be auto-generated using the database name prefix */
+                    name?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Backup creation initiated successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid body, description too long, or unsupported database type */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER" | "INVALID_VALUE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — a backup is currently in progress */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    deleteDatabaseBackup: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database that owns the backup (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+                /** @description Name of the backup to delete (format: lowercase alphanumeric and hyphens) */
+                backupName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Backup deleted (or did not exist). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — missing or invalid parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    restoreDatabase: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the source database (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+                /** @description Name of the backup to restore from (format: lowercase alphanumeric and hyphens) */
+                backupName: string;
+            };
+            cookie?: never;
+        };
+        /** @description Optional configuration for the restored database instance */
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /**
+                     * @description Name for the new restored database instance. Must be a valid Kubernetes resource name. If omitted, a name is auto-generated using the source database name as a prefix.
+                     * @example my-postgres-db-restored
+                     */
+                    name?: string;
+                    /**
+                     * @description Number of replicas for the restored cluster. If omitted, inherits the source cluster replica count.
+                     * @example 1
+                     */
+                    replicas?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Database restore initiated successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — missing path parameters or invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — backup or source database not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — a database with the target name already exists */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    enablePublicAccess: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Public access enabled successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid database name */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Conflict — public access is already enabled */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "ALREADY_EXISTS" | "CONFLICT";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    disablePublicAccess: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Name of the database to operate on (format: lowercase alphanumeric and hyphens) */
+                databaseName: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Public access disabled successfully. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Bad request — invalid path parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — database or public service not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDatabaseVersions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Database versions retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: number;
+                        message: string;
+                        data: {
+                            [key: string]: string[];
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    getDatabaseLogsData: {
+        parameters: {
+            query: {
+                /** @description Name of the pod to retrieve logs from */
+                podName: string;
+                /** @description Database engine type (determines log format and parsing) */
+                dbType: "mysql" | "mongodb" | "redis" | "postgresql";
+                /** @description Type of log to retrieve. Allowed values: "runtimeLog", "slowQuery", "errorLog" */
+                logType: "runtimeLog" | "slowQuery" | "errorLog";
+                /** @description Absolute path to the log file within the pod */
+                logPath: string;
+                /** @description Page number for pagination (starts at 1) */
+                page?: number;
+                /** @description Number of log entries per page (max 1000) */
+                pageSize?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Log entries retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: number;
+                        message: string;
+                        data: {
+                            logs: {
+                                timestamp: string;
+                                level: string;
+                                content: string;
+                            }[];
+                            metadata: {
+                                total: number;
+                                page: number;
+                                pageSize: number;
+                                processingTime: string;
+                                hasMore: boolean;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Bad request — invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — pod or log file not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listDatabaseLogFiles: {
+        parameters: {
+            query: {
+                /** @description Name of the pod to list log files from */
+                podName: string;
+                /** @description Database engine type (determines where to look for log files) */
+                dbType: "mysql" | "mongodb" | "redis" | "postgresql";
+                /** @description Type of logs to list. Allowed values: "runtimeLog", "slowQuery", "errorLog" */
+                logType: "runtimeLog" | "slowQuery" | "errorLog";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Log files retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        code: number;
+                        message: string;
+                        data: {
+                            name: string;
+                            path: string;
+                            dir: string;
+                            kind: string;
+                            attr: string;
+                            hardLinks: number;
+                            owner: string;
+                            group: string;
+                            size: number;
+                            updateTime: string;
+                            linkTo?: string;
+                            processed?: boolean;
+                        }[];
+                    };
+                };
+            };
+            /** @description Bad request — invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "validation_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "INVALID_PARAMETER";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description For INVALID_PARAMETER: Array<{ field, message }>. For INVALID_VALUE: optional string. Omitted for other codes. */
+                            details?: {
+                                /** @description Field path using dot/bracket notation, e.g. "resource.cpu" */
+                                field: string;
+                                /** @description Validation error message for this field */
+                                message: string;
+                            }[] | string;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized — invalid or missing kubeconfig */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authentication_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "AUTHENTICATION_REQUIRED";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Forbidden — insufficient permissions */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "authorization_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "PERMISSION_DENIED" | "INSUFFICIENT_BALANCE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Not found — pod not found or no log files available */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "resource_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "NOT_FOUND";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Typically omitted. May contain additional context in edge cases. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @enum {string}
+                             */
+                            type: "operation_error" | "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @enum {string}
+                             */
+                            code: "KUBERNETES_ERROR" | "OPERATION_FAILED" | "INTERNAL_ERROR";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw error string from the underlying system, for troubleshooting. */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Service unavailable — Kubernetes cluster unreachable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Structured error object containing type, code, message, and optional details */
+                        error: {
+                            /**
+                             * @description High-level error type for categorization
+                             * @constant
+                             */
+                            type: "internal_error";
+                            /**
+                             * @description Specific error code for programmatic handling and i18n
+                             * @constant
+                             */
+                            code: "SERVICE_UNAVAILABLE";
+                            /** @description Human-readable error message */
+                            message: string;
+                            /** @description Raw connection error from the underlying system (e.g. ECONNREFUSED). */
+                            details?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+}