@phala/cloud 0.2.1-beta.4 → 0.2.2

package/dist/types/app_revision.d.ts

@@ -0,0 +1,453 @@
+import { z } from "zod";
+export declare const CvmRefSchema: z.ZodObject<{
+    object_type: z.ZodLiteral<"cvm">;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    vm_uuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    object_type: "cvm";
+    name?: string | null | undefined;
+    id?: string | null | undefined;
+    app_id?: string | null | undefined;
+    vm_uuid?: string | null | undefined;
+}, {
+    object_type: "cvm";
+    name?: string | null | undefined;
+    id?: string | null | undefined;
+    app_id?: string | null | undefined;
+    vm_uuid?: string | null | undefined;
+}>;
+export type CvmRef = z.infer<typeof CvmRefSchema>;
+export declare const AppRevisionResponseSchema: z.ZodObject<{
+    app_id: z.ZodString;
+    vm_uuid: z.ZodString;
+    compose_hash: z.ZodString;
+    created_at: z.ZodString;
+    trace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operation_type: z.ZodString;
+    triggered_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"user">;
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }, {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }>>>;
+    cvm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"cvm">;
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        vm_uuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    }, {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    }>>>;
+    workspace: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"workspace">;
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }, {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    app_id: string;
+    vm_uuid: string;
+    created_at: string;
+    compose_hash: string;
+    operation_type: string;
+    workspace?: {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+    cvm?: {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    } | null | undefined;
+    trace_id?: string | null | undefined;
+    triggered_by?: {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+}, {
+    app_id: string;
+    vm_uuid: string;
+    created_at: string;
+    compose_hash: string;
+    operation_type: string;
+    workspace?: {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+    cvm?: {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    } | null | undefined;
+    trace_id?: string | null | undefined;
+    triggered_by?: {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+}>;
+export type AppRevisionResponse = z.infer<typeof AppRevisionResponseSchema>;
+export declare const AppRevisionDetailResponseSchema: z.ZodObject<{
+    app_id: z.ZodString;
+    vm_uuid: z.ZodString;
+    compose_hash: z.ZodString;
+    compose_file: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodString]>>>;
+    encrypted_env: z.ZodString;
+    user_config: z.ZodString;
+    created_at: z.ZodString;
+    trace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    operation_type: z.ZodString;
+    triggered_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"user">;
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }, {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }>>>;
+    cvm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"cvm">;
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        vm_uuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    }, {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    }>>>;
+    workspace: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        object_type: z.ZodLiteral<"workspace">;
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }, {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    app_id: string;
+    vm_uuid: string;
+    created_at: string;
+    compose_hash: string;
+    encrypted_env: string;
+    operation_type: string;
+    user_config: string;
+    workspace?: {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+    compose_file?: string | Record<string, any> | null | undefined;
+    cvm?: {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    } | null | undefined;
+    trace_id?: string | null | undefined;
+    triggered_by?: {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+}, {
+    app_id: string;
+    vm_uuid: string;
+    created_at: string;
+    compose_hash: string;
+    encrypted_env: string;
+    operation_type: string;
+    user_config: string;
+    workspace?: {
+        name: string;
+        id: string;
+        object_type: "workspace";
+        slug?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+    compose_file?: string | Record<string, any> | null | undefined;
+    cvm?: {
+        object_type: "cvm";
+        name?: string | null | undefined;
+        id?: string | null | undefined;
+        app_id?: string | null | undefined;
+        vm_uuid?: string | null | undefined;
+    } | null | undefined;
+    trace_id?: string | null | undefined;
+    triggered_by?: {
+        object_type: "user";
+        username?: string | null | undefined;
+        id?: string | null | undefined;
+        avatar_url?: string | null | undefined;
+    } | null | undefined;
+}>;
+export type AppRevisionDetailResponse = z.infer<typeof AppRevisionDetailResponseSchema>;
+export declare const AppRevisionsResponseSchema: z.ZodObject<{
+    revisions: z.ZodArray<z.ZodObject<{
+        app_id: z.ZodString;
+        vm_uuid: z.ZodString;
+        compose_hash: z.ZodString;
+        created_at: z.ZodString;
+        trace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        operation_type: z.ZodString;
+        triggered_by: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            object_type: z.ZodLiteral<"user">;
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        }, {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        }>>>;
+        cvm: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            object_type: z.ZodLiteral<"cvm">;
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            vm_uuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        }, {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        }>>>;
+        workspace: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            object_type: z.ZodLiteral<"workspace">;
+            id: z.ZodString;
+            name: z.ZodString;
+            slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        }, {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        app_id: string;
+        vm_uuid: string;
+        created_at: string;
+        compose_hash: string;
+        operation_type: string;
+        workspace?: {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+        cvm?: {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        } | null | undefined;
+        trace_id?: string | null | undefined;
+        triggered_by?: {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+    }, {
+        app_id: string;
+        vm_uuid: string;
+        created_at: string;
+        compose_hash: string;
+        operation_type: string;
+        workspace?: {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+        cvm?: {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        } | null | undefined;
+        trace_id?: string | null | undefined;
+        triggered_by?: {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+    }>, "many">;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    total_pages: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+    revisions: {
+        app_id: string;
+        vm_uuid: string;
+        created_at: string;
+        compose_hash: string;
+        operation_type: string;
+        workspace?: {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+        cvm?: {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        } | null | undefined;
+        trace_id?: string | null | undefined;
+        triggered_by?: {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+    }[];
+}, {
+    total: number;
+    page: number;
+    page_size: number;
+    total_pages: number;
+    revisions: {
+        app_id: string;
+        vm_uuid: string;
+        created_at: string;
+        compose_hash: string;
+        operation_type: string;
+        workspace?: {
+            name: string;
+            id: string;
+            object_type: "workspace";
+            slug?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+        cvm?: {
+            object_type: "cvm";
+            name?: string | null | undefined;
+            id?: string | null | undefined;
+            app_id?: string | null | undefined;
+            vm_uuid?: string | null | undefined;
+        } | null | undefined;
+        trace_id?: string | null | undefined;
+        triggered_by?: {
+            object_type: "user";
+            username?: string | null | undefined;
+            id?: string | null | undefined;
+            avatar_url?: string | null | undefined;
+        } | null | undefined;
+    }[];
+}>;
+export type AppRevisionsResponse = z.infer<typeof AppRevisionsResponseSchema>;

package/dist/types/client.d.ts

@@ -1,6 +1,38 @@
 import { z } from "zod";
 import type { FetchOptions, FetchRequest } from "ofetch";
 import type { PhalaCloudError } from "../utils/errors";
+/**
+ * Supported API versions
+ */
+export type ApiVersion = "2025-10-28" | "2026-01-21";
+/**
+ * Default API version (latest stable)
+ */
+export type DefaultApiVersion = "2026-01-21";
+/**
+ * Full HTTP response including status, headers, and parsed body
+ */
+export interface FullResponse<T = unknown> {
+    /** HTTP status code */
+    status: number;
+    /** HTTP status text */
+    statusText: string;
+    /** Response headers */
+    headers: Headers;
+    /** Parsed response body */
+    data: T;
+    /** Whether the response status is 2xx */
+    ok: boolean;
+}
+/**
+ * Options for the generic request method
+ */
+export interface RequestOptions extends Omit<FetchOptions, "method"> {
+    /** HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, etc.) */
+    method?: string;
+    /** Request body (for POST, PUT, PATCH) */
+    body?: RequestInit["body"] | Record<string, unknown>;
+}
 /**
  * Enhanced error type that includes both HTTP and validation errors
  */
@@ -25,7 +57,7 @@ export type SafeResult<T, E = SafeError> = {
  * - PHALA_CLOUD_API_KEY: API key for authentication
  * - PHALA_CLOUD_API_PREFIX: Base URL prefix for the API
  */
-export interface ClientConfig extends FetchOptions {
+export interface ClientConfig<V extends ApiVersion = ApiVersion> extends FetchOptions {
     /**
      * API key for authentication
      * If not provided, will read from PHALA_CLOUD_API_KEY environment variable
@@ -35,7 +67,7 @@ export interface ClientConfig extends FetchOptions {
     /**
      * Base URL for the API (overrides FetchOptions baseURL)
      * If not provided, will read from PHALA_CLOUD_API_PREFIX environment variable
-     * Defaults to "https://cloud-api.phala.network/v1"
+     * Defaults to "https://cloud-api.phala.com/api/v1"
      */
     baseURL?: string;
     /** Default timeout in milliseconds (overrides FetchOptions timeout) */
@@ -43,7 +75,7 @@ export interface ClientConfig extends FetchOptions {
     /**
      * API version to use
      */
-    version?: string;
+    version?: V;
     /**
      * Use cookie-based authentication instead of API key
      * When true, API key is not required and credentials: "include" is set
@@ -59,3 +91,9 @@ export interface ClientConfig extends FetchOptions {
         options: FetchOptions;
     }) => void | Promise<void>;
 }
+/**
+ * Resolved client configuration with version guaranteed
+ */
+export interface ResolvedClientConfig<V extends ApiVersion = ApiVersion> extends Omit<ClientConfig<V>, "version"> {
+    version: V;
+}

package/dist/types/cvm_id.d.ts

@@ -6,15 +6,15 @@ import { z } from "zod";
  * @example
  * ```typescript
  * const MySchema = CvmIdObjectSchema.extend({
- *   name: z.string()
+ *   custom_field: z.string()
  * }).refine(
- *   (data) => !!(data.id || data.uuid || data.app_id || data.instance_id),
- *   "One of id, uuid, app_id, or instance_id must be provided"
+ *   (data) => !!(data.id || data.uuid || data.app_id || data.instance_id || data.name),
+ *   "One of id, uuid, app_id, instance_id, or name must be provided"
  * );
  * ```
  */
 export declare const CvmIdObjectSchema: z.ZodObject<{
-    /** Direct CVM ID (any format) */
+    /** Direct CVM ID (any format) - accepts any string including names */
     id: z.ZodOptional<z.ZodString>;
     /** UUID format (with or without dashes) */
     uuid: z.ZodOptional<z.ZodString>;
@@ -22,12 +22,16 @@ export declare const CvmIdObjectSchema: z.ZodObject<{
     app_id: z.ZodOptional<z.ZodString>;
     /** Instance ID (40 characters, optionally prefixed with 'instance_') */
     instance_id: z.ZodOptional<z.ZodString>;
+    /** CVM name (RFC 1123 hostname format: 5-63 chars, starts with letter, alphanumeric + hyphens) */
+    name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
     uuid?: string | undefined;
 }, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
@@ -42,7 +46,7 @@ export declare const refineCvmId: <T extends z.ZodTypeAny>(schema: T) => z.ZodEf
  * For extending with additional fields, use CvmIdObjectSchema.extend() then call refineCvmId()
  */
 export declare const CvmIdBaseSchema: z.ZodEffects<z.ZodObject<{
-    /** Direct CVM ID (any format) */
+    /** Direct CVM ID (any format) - accepts any string including names */
     id: z.ZodOptional<z.ZodString>;
     /** UUID format (with or without dashes) */
     uuid: z.ZodOptional<z.ZodString>;
@@ -50,12 +54,16 @@ export declare const CvmIdBaseSchema: z.ZodEffects<z.ZodObject<{
     app_id: z.ZodOptional<z.ZodString>;
     /** Instance ID (40 characters, optionally prefixed with 'instance_') */
     instance_id: z.ZodOptional<z.ZodString>;
+    /** CVM name (RFC 1123 hostname format: 5-63 chars, starts with letter, alphanumeric + hyphens) */
+    name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
     uuid?: string | undefined;
 }, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
@@ -66,30 +74,34 @@ export declare const CvmIdBaseSchema: z.ZodEffects<z.ZodObject<{
  * Automatically detects and normalizes any CVM ID format
  *
  * Process:
- * 1. Extract raw value from any field (priority: id > uuid > app_id > instance_id)
+ * 1. Extract raw value from any field (priority: id > uuid > app_id > instance_id > name)
  * 2. Auto-detect format using regex patterns
  * 3. Apply appropriate normalization:
  *    - UUID (with or without dashes) → remove dashes
  *    - 40-char hex string → add 'app_' prefix
+ *    - Name field → use as-is (validated by RFC 1123)
  *    - Already prefixed or custom → use as-is
  *
  * @example
  * ```typescript
- * // All these work regardless of which field is used:
+ * // UUID formats
  * CvmIdSchema.parse({ id: "550e8400-e29b-41d4-a716-446655440000" });
  * CvmIdSchema.parse({ uuid: "550e8400-e29b-41d4-a716-446655440000" });
  * // → { cvmId: "550e8400e29b41d4a716446655440000" }
  *
+ * // App ID formats
  * CvmIdSchema.parse({ id: "50b0e827cc6c53f4010b57e588a18c5ef9388cc1" });
  * CvmIdSchema.parse({ app_id: "50b0e827cc6c53f4010b57e588a18c5ef9388cc1" });
  * // → { cvmId: "app_50b0e827cc6c53f4010b57e588a18c5ef9388cc1" }
  *
- * CvmIdSchema.parse({ id: "app_50b0e827cc6c53f4010b57e588a18c5ef9388cc1" });
- * // → { cvmId: "app_50b0e827cc6c53f4010b57e588a18c5ef9388cc1" }
+ * // Name formats (RFC 1123)
+ * CvmIdSchema.parse({ name: "my-app" });
+ * CvmIdSchema.parse({ id: "my-app" });  // also works via id field
+ * // → { cvmId: "my-app" }
  * ```
  */
 export declare const CvmIdSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
-    /** Direct CVM ID (any format) */
+    /** Direct CVM ID (any format) - accepts any string including names */
     id: z.ZodOptional<z.ZodString>;
     /** UUID format (with or without dashes) */
     uuid: z.ZodOptional<z.ZodString>;
@@ -97,18 +109,22 @@ export declare const CvmIdSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     app_id: z.ZodOptional<z.ZodString>;
     /** Instance ID (40 characters, optionally prefixed with 'instance_') */
     instance_id: z.ZodOptional<z.ZodString>;
+    /** CVM name (RFC 1123 hostname format: 5-63 chars, starts with letter, alphanumeric + hyphens) */
+    name: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
     uuid?: string | undefined;
 }, {
+    name?: string | undefined;
     id?: string | undefined;
     app_id?: string | undefined;
     instance_id?: string | undefined;
     uuid?: string | undefined;
 }>, any, any>, {
-    cvmId: string;
+    cvmId: any;
 }, any>;
 /**
  * Input type for CVM ID
@@ -117,6 +133,7 @@ export declare const CvmIdSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
  * ```typescript
  * const identifier: CvmIdInput = { id: "cvm-123" };
  * const identifier2: CvmIdInput = { uuid: "550e8400-e29b-41d4-a716-446655440000" };
+ * const identifier3: CvmIdInput = { name: "my-app" };
  * ```
  */
 export type CvmIdInput = {
@@ -124,4 +141,5 @@ export type CvmIdInput = {
     uuid?: string;
     app_id?: string;
     instance_id?: string;
+    name?: string;
 };