@phala/cloud 0.1.2 → 0.2.1-beta.1

package/dist/index.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AddComposeHashSchema: () => AddComposeHashSchema,
+  AllFamiliesResponseSchema: () => AllFamiliesResponseSchema,
   ApiErrorSchema: () => ApiErrorSchema,
   AuthError: () => AuthError,
   AvailableNodesSchema: () => AvailableNodesSchema,
@@ -50,12 +51,17 @@ __export(index_exports, {
   CvmNetworkSchema: () => CvmNetworkSchema,
   CvmNetworkUrlsSchema: () => CvmNetworkUrlsSchema,
   CvmNodeSchema: () => CvmNodeSchema,
+  CvmStateSchema: () => CvmStateSchema,
   CvmSystemInfoSchema: () => CvmSystemInfoSchema,
   DeleteCvmRequestSchema: () => DeleteCvmRequestSchema,
   DeployAppAuthRequestSchema: () => DeployAppAuthRequestSchema,
   DeployAppAuthSchema: () => DeployAppAuthSchema,
+  FamilyGroupSchema: () => FamilyGroupSchema,
+  FamilyInstanceTypesResponseSchema: () => FamilyInstanceTypesResponseSchema,
   GetAppEnvEncryptPubKeyRequestSchema: () => GetAppEnvEncryptPubKeyRequestSchema,
   GetAppEnvEncryptPubKeySchema: () => GetAppEnvEncryptPubKeySchema,
+  GetAvailableOSImagesRequestSchema: () => GetAvailableOSImagesRequestSchema,
+  GetAvailableOSImagesResponseSchema: () => GetAvailableOSImagesResponseSchema,
   GetCvmAttestationRequestSchema: () => GetCvmAttestationRequestSchema,
   GetCvmComposeFileRequestSchema: () => GetCvmComposeFileRequestSchema,
   GetCvmContainersStatsRequestSchema: () => GetCvmContainersStatsRequestSchema,
@@ -64,17 +70,21 @@ __export(index_exports, {
   GetCvmListRequestSchema: () => GetCvmListRequestSchema,
   GetCvmListSchema: () => GetCvmListSchema,
   GetCvmNetworkRequestSchema: () => GetCvmNetworkRequestSchema,
+  GetCvmStateRequestSchema: () => GetCvmStateRequestSchema,
   GetCvmStatsRequestSchema: () => GetCvmStatsRequestSchema,
   GetKmsInfoRequestSchema: () => GetKmsInfoRequestSchema,
   GetKmsListRequestSchema: () => GetKmsListRequestSchema,
   GetKmsListSchema: () => GetKmsListSchema,
   InstanceTypeSchema: () => InstanceTypeSchema,
   KmsInfoSchema: () => KmsInfoSchema,
-  ListInstanceTypesRequestSchema: () => ListInstanceTypesRequestSchema,
+  ListFamilyInstanceTypesRequestSchema: () => ListFamilyInstanceTypesRequestSchema,
   ListWorkspacesSchema: () => ListWorkspacesSchema,
   ManagedUserSchema: () => ManagedUserSchema,
+  MaxRetriesExceededError: () => MaxRetriesExceededError,
   NetworkError: () => NetworkError,
-  PaginatedInstanceTypesSchema: () => PaginatedInstanceTypesSchema,
+  NextAppIdsRequestSchema: () => NextAppIdsRequestSchema,
+  NextAppIdsSchema: () => NextAppIdsSchema,
+  OSImageVariantSchema: () => OSImageVariantSchema,
   PaginationMetadataSchema: () => PaginationMetadataSchema,
   PhalaCloudError: () => PhalaCloudError,
   ProvisionCvmComposeFileUpdateRequestSchema: () => ProvisionCvmComposeFileUpdateRequestSchema,
@@ -82,6 +92,7 @@ __export(index_exports, {
   ProvisionCvmRequestSchema: () => ProvisionCvmRequestSchema,
   ProvisionCvmSchema: () => ProvisionCvmSchema,
   RequestError: () => RequestError,
+  ResourceError: () => ResourceError,
   RestartCvmRequestSchema: () => RestartCvmRequestSchema,
   SUPPORTED_CHAINS: () => SUPPORTED_CHAINS,
   ServerError: () => ServerError,
@@ -92,10 +103,13 @@ __export(index_exports, {
   UnknownError: () => UnknownError,
   UpdateCvmResourcesRequestSchema: () => UpdateCvmResourcesRequestSchema,
   UpdateCvmVisibilityRequestSchema: () => UpdateCvmVisibilityRequestSchema,
+  UpdateOsImageRequestSchema: () => UpdateOsImageRequestSchema,
   VMSchema: () => VMSchema,
   ValidationError: () => ValidationError,
   VmInfoSchema: () => VmInfoSchema,
   WalletError: () => WalletError,
+  WatchAbortedError: () => WatchAbortedError,
+  WatchCvmStateRequestSchema: () => WatchCvmStateRequestSchema,
   WorkspaceResponseSchema: () => WorkspaceResponseSchema,
   addComposeHash: () => addComposeHash,
   addNetwork: () => addNetwork,
@@ -123,9 +137,11 @@ __export(index_exports, {
   executeTransactionWithRetry: () => executeTransactionWithRetry,
   extractNetworkClients: () => extractNetworkClients,
   formatErrorMessage: () => formatErrorMessage,
+  formatStructuredError: () => formatStructuredError,
   formatValidationErrors: () => formatValidationErrors,
   getAppEnvEncryptPubKey: () => getAppEnvEncryptPubKey,
   getAvailableNodes: () => getAvailableNodes,
+  getAvailableOsImages: () => getAvailableOsImages,
   getComposeHash: () => import_get_compose_hash3.getComposeHash,
   getCurrentUser: () => getCurrentUser,
   getCvmAttestation: () => getCvmAttestation,
@@ -135,14 +151,17 @@ __export(index_exports, {
   getCvmInfo: () => getCvmInfo,
   getCvmList: () => getCvmList,
   getCvmNetwork: () => getCvmNetwork,
+  getCvmState: () => getCvmState,
   getCvmStats: () => getCvmStats,
   getErrorMessage: () => getErrorMessage,
   getKmsInfo: () => getKmsInfo,
   getKmsList: () => getKmsList,
   getValidationFields: () => getValidationFields,
   getWorkspace: () => getWorkspace,
-  listInstanceTypes: () => listInstanceTypes,
+  listAllInstanceTypeFamilies: () => listAllInstanceTypeFamilies,
+  listFamilyInstanceTypes: () => listFamilyInstanceTypes,
   listWorkspaces: () => listWorkspaces,
+  nextAppIds: () => nextAppIds,
   parseApiError: () => parseApiError,
   parseEnv: () => parseEnv,
   parseEnvVars: () => parseEnvVars,
@@ -158,6 +177,7 @@ __export(index_exports, {
   safeDeployAppAuth: () => safeDeployAppAuth,
   safeGetAppEnvEncryptPubKey: () => safeGetAppEnvEncryptPubKey,
   safeGetAvailableNodes: () => safeGetAvailableNodes,
+  safeGetAvailableOsImages: () => safeGetAvailableOsImages,
   safeGetCurrentUser: () => safeGetCurrentUser,
   safeGetCvmAttestation: () => safeGetCvmAttestation,
   safeGetCvmComposeFile: () => safeGetCvmComposeFile,
@@ -166,12 +186,15 @@ __export(index_exports, {
   safeGetCvmInfo: () => safeGetCvmInfo,
   safeGetCvmList: () => safeGetCvmList,
   safeGetCvmNetwork: () => safeGetCvmNetwork,
+  safeGetCvmState: () => safeGetCvmState,
   safeGetCvmStats: () => safeGetCvmStats,
   safeGetKmsInfo: () => safeGetKmsInfo,
   safeGetKmsList: () => safeGetKmsList,
   safeGetWorkspace: () => safeGetWorkspace,
-  safeListInstanceTypes: () => safeListInstanceTypes,
+  safeListAllInstanceTypeFamilies: () => safeListAllInstanceTypeFamilies,
+  safeListFamilyInstanceTypes: () => safeListFamilyInstanceTypes,
   safeListWorkspaces: () => safeListWorkspaces,
+  safeNextAppIds: () => safeNextAppIds,
   safeProvisionCvm: () => safeProvisionCvm,
   safeProvisionCvmComposeFileUpdate: () => safeProvisionCvmComposeFileUpdate,
   safeRestartCvm: () => safeRestartCvm,
@@ -180,6 +203,7 @@ __export(index_exports, {
   safeStopCvm: () => safeStopCvm,
   safeUpdateCvmResources: () => safeUpdateCvmResources,
   safeUpdateCvmVisibility: () => safeUpdateCvmVisibility,
+  safeUpdateOsImage: () => safeUpdateOsImage,
   safeValidateActionParameters: () => safeValidateActionParameters,
   shutdownCvm: () => shutdownCvm,
   sortObject: () => sortObject,
@@ -188,10 +212,12 @@ __export(index_exports, {
   switchToNetwork: () => switchToNetwork,
   updateCvmResources: () => updateCvmResources,
   updateCvmVisibility: () => updateCvmVisibility,
+  updateOsImage: () => updateOsImage,
   validateActionParameters: () => validateActionParameters,
   validateNetworkPrerequisites: () => validateNetworkPrerequisites,
   verifyEnvEncryptPublicKey: () => import_verify_env_encrypt_public_key.verifyEnvEncryptPublicKey,
   waitForTransactionReceipt: () => waitForTransactionReceipt,
+  watchCvmState: () => watchCvmState,
   withComposeMethods: () => withComposeMethods
 });
 module.exports = __toCommonJS(index_exports);
@@ -210,8 +236,11 @@ var ApiErrorSchema = import_zod.z.object({
       import_zod.z.object({
         msg: import_zod.z.string(),
         type: import_zod.z.string().optional(),
-        ctx: import_zod.z.record(import_zod.z.unknown()).optional()
-      })
+        ctx: import_zod.z.record(import_zod.z.unknown()).optional(),
+        loc: import_zod.z.array(import_zod.z.union([import_zod.z.string(), import_zod.z.number()])).optional(),
+        input: import_zod.z.unknown().optional()
+      }).passthrough()
+      // Allow additional fields
     ),
     import_zod.z.record(import_zod.z.unknown())
   ]).optional(),
@@ -314,6 +343,9 @@ var UnknownError = class extends PhalaCloudError {
   }
 };
 function extractFieldPath(loc) {
+  if (!loc || !Array.isArray(loc)) {
+    return "unknown";
+  }
   const filtered = loc.filter((part) => {
     if (typeof part === "string") {
       return !["body", "query", "path", "header"].includes(part);
@@ -329,12 +361,21 @@ function parseValidationErrors(detail) {
       message: typeof detail === "string" ? detail : "Validation error"
     };
   }
-  const errors = detail.map((item) => ({
-    field: extractFieldPath(item.loc),
-    message: item.msg,
-    type: item.type,
-    context: item.ctx
-  }));
+  const errors = detail.map(
+    (item, index) => {
+      const field = extractFieldPath(item.loc);
+      let displayField = field;
+      if (field === "unknown" && item.type) {
+        displayField = item.type === "missing" ? "required field" : item.type;
+      }
+      return {
+        field: displayField,
+        message: item.msg,
+        type: item.type,
+        context: item.ctx
+      };
+    }
+  );
   const count = errors.length;
   const message = count === 1 ? `Validation failed: ${errors[0].message}` : `Validation failed (${count} issue${count > 1 ? "s" : ""})`;
   return { errors, message };
@@ -377,13 +418,21 @@ function parseApiError(requestError) {
   const status = requestError.status ?? 0;
   const statusText = requestError.statusText ?? "Unknown Error";
   const detail = requestError.detail;
+  const structured = parseStructuredError(detail);
+  if (structured) {
+    return new ResourceError(structured.message, {
+      status,
+      statusText,
+      detail,
+      errorCode: structured.error_code,
+      structuredDetails: structured.details,
+      suggestions: structured.suggestions,
+      links: structured.links
+    });
+  }
   const errorType = categorizeErrorType(status);
   const message = extractPrimaryMessage(status, detail, requestError.message);
-  const commonData = {
-    status,
-    statusText,
-    detail
-  };
+  const commonData = { status, statusText, detail };
   if (errorType === "validation" && Array.isArray(detail)) {
     const { errors } = parseValidationErrors(detail);
     return new ValidationError(message, {
@@ -445,6 +494,67 @@ function getErrorMessage(error) {
   }
   return "Unknown error occurred";
 }
+var ResourceError = class extends BusinessError {
+  constructor(message, data) {
+    super(message, data);
+    this.isResourceError = true;
+    this.errorCode = data.errorCode;
+    this.structuredDetails = data.structuredDetails;
+    this.suggestions = data.suggestions;
+    this.links = data.links;
+  }
+};
+function parseStructuredError(detail) {
+  if (!detail || typeof detail !== "object") {
+    return null;
+  }
+  const obj = detail;
+  if (obj.error_code && typeof obj.error_code === "string" && obj.message && typeof obj.message === "string") {
+    return {
+      error_code: obj.error_code,
+      message: obj.message,
+      details: obj.details,
+      suggestions: obj.suggestions,
+      links: obj.links
+    };
+  }
+  return null;
+}
+function formatStructuredError(error, options) {
+  const { showErrorCode = true, showSuggestions = true, showLinks = true } = options ?? {};
+  const parts = [];
+  if (showErrorCode && error.errorCode) {
+    parts.push(`Error [${error.errorCode}]: ${error.message}`);
+  } else {
+    parts.push(error.message);
+  }
+  if (error.structuredDetails && error.structuredDetails.length > 0) {
+    parts.push("");
+    parts.push("Details:");
+    error.structuredDetails.forEach((d) => {
+      if (d.message) {
+        parts.push(`  - ${d.message}`);
+      } else if (d.field && d.value !== void 0) {
+        parts.push(`  - ${d.field}: ${d.value}`);
+      }
+    });
+  }
+  if (showSuggestions && error.suggestions && error.suggestions.length > 0) {
+    parts.push("");
+    parts.push("Suggestions:");
+    error.suggestions.forEach((s) => {
+      parts.push(`  - ${s}`);
+    });
+  }
+  if (showLinks && error.links && error.links.length > 0) {
+    parts.push("");
+    parts.push("Learn more:");
+    error.links.forEach((link) => {
+      parts.push(`  - ${link.label}: ${link.url}`);
+    });
+  }
+  return parts.join("\n");
+}
 
 // src/client.ts
 var SUPPORTED_API_VERSIONS = ["2025-05-31", "2025-10-28"];
@@ -1002,10 +1112,6 @@ var { action: getAvailableNodes, safeAction: safeGetAvailableNodes } = defineSim
 
 // src/actions/list-instance-types.ts
 var import_zod5 = require("zod");
-var ListInstanceTypesRequestSchema = import_zod5.z.object({
-  page: import_zod5.z.number().int().min(1).optional().default(1),
-  page_size: import_zod5.z.number().int().min(1).max(1e3).optional().default(100)
-}).strict();
 var InstanceTypeSchema = import_zod5.z.object({
   id: import_zod5.z.string(),
   name: import_zod5.z.string(),
@@ -1014,22 +1120,34 @@ var InstanceTypeSchema = import_zod5.z.object({
   memory_mb: import_zod5.z.number(),
   hourly_rate: import_zod5.z.string(),
   requires_gpu: import_zod5.z.boolean(),
-  public: import_zod5.z.boolean(),
-  enabled: import_zod5.z.boolean()
+  default_disk_size_gb: import_zod5.z.number().default(20),
+  family: import_zod5.z.string().nullable()
 }).passthrough();
-var PaginatedInstanceTypesSchema = import_zod5.z.object({
+var FamilyGroupSchema = import_zod5.z.object({
+  name: import_zod5.z.string(),
+  items: import_zod5.z.array(InstanceTypeSchema),
+  total: import_zod5.z.number()
+}).strict();
+var AllFamiliesResponseSchema = import_zod5.z.object({
+  result: import_zod5.z.array(FamilyGroupSchema)
+}).strict();
+var FamilyInstanceTypesResponseSchema = import_zod5.z.object({
   items: import_zod5.z.array(InstanceTypeSchema),
   total: import_zod5.z.number(),
-  page: import_zod5.z.number(),
-  page_size: import_zod5.z.number(),
-  pages: import_zod5.z.number()
+  family: import_zod5.z.string()
 }).strict();
-var { action: listInstanceTypes, safeAction: safeListInstanceTypes } = defineAction(PaginatedInstanceTypesSchema, async (client, request) => {
-  const validatedRequest = ListInstanceTypesRequestSchema.parse(request ?? {});
-  const queryParams = new URLSearchParams();
-  queryParams.append("page", validatedRequest.page.toString());
-  queryParams.append("page_size", validatedRequest.page_size.toString());
-  return await client.get(`/api/instance-types?${queryParams.toString()}`);
+var ListFamilyInstanceTypesRequestSchema = import_zod5.z.object({
+  family: import_zod5.z.string()
+}).strict();
+var { action: listAllInstanceTypeFamilies, safeAction: safeListAllInstanceTypeFamilies } = defineAction(
+  AllFamiliesResponseSchema,
+  async (client) => {
+    return await client.get("/instance-types");
+  }
+);
+var { action: listFamilyInstanceTypes, safeAction: safeListFamilyInstanceTypes } = defineAction(FamilyInstanceTypesResponseSchema, async (client, request) => {
+  const validated = ListFamilyInstanceTypesRequestSchema.parse(request);
+  return await client.get(`/instance-types/${validated.family}`);
 });
 
 // src/actions/workspaces/list_workspaces.ts
@@ -1249,6 +1367,7 @@ var ProvisionCvmSchema = import_zod10.z.object({
   fmspc: import_zod10.z.string().nullable().optional(),
   device_id: import_zod10.z.string().nullable().optional(),
   os_image_hash: import_zod10.z.string().nullable().optional(),
+  instance_type: import_zod10.z.string().nullable().optional(),
   teepod_id: import_zod10.z.number().nullable().optional(),
   // Will be transformed to node_id
   node_id: import_zod10.z.number().nullable().optional(),
@@ -1262,19 +1381,24 @@ var ProvisionCvmSchema = import_zod10.z.object({
 });
 var ProvisionCvmRequestSchema = import_zod10.z.object({
   node_id: import_zod10.z.number().optional(),
-  // recommended
+  // recommended - optional, system auto-selects if not specified
   teepod_id: import_zod10.z.number().optional(),
   // deprecated, for compatibility
+  region: import_zod10.z.string().optional(),
+  // optional - region filter for auto-selection
   name: import_zod10.z.string(),
-  image: import_zod10.z.string(),
-  vcpu: import_zod10.z.number(),
-  memory: import_zod10.z.number(),
-  disk_size: import_zod10.z.number(),
+  instance_type: import_zod10.z.string().default("tdx.small"),
+  // defaults to "tdx.small"
+  image: import_zod10.z.string().optional(),
+  vcpu: import_zod10.z.number().optional(),
+  memory: import_zod10.z.number().optional(),
+  disk_size: import_zod10.z.number().optional(),
   compose_file: import_zod10.z.object({
     allowed_envs: import_zod10.z.array(import_zod10.z.string()).optional(),
     pre_launch_script: import_zod10.z.string().optional(),
     docker_compose_file: import_zod10.z.string().optional(),
-    name: import_zod10.z.string().optional(),
+    name: import_zod10.z.string().optional().default(""),
+    // optional with default empty string
     kms_enabled: import_zod10.z.boolean().optional(),
     public_logs: import_zod10.z.boolean().optional(),
     public_sysinfo: import_zod10.z.boolean().optional(),
@@ -1284,8 +1408,11 @@ var ProvisionCvmRequestSchema = import_zod10.z.object({
     // deprecated, for compatibility
   }),
   listed: import_zod10.z.boolean().optional(),
-  instance_type: import_zod10.z.string().nullable().optional(),
   kms_id: import_zod10.z.string().optional(),
+  kms: import_zod10.z.enum(["PHALA", "ETHEREUM", "BASE"]).optional(),
+  // KMS type selection (defaults to PHALA)
+  kms_contract: import_zod10.z.string().optional(),
+  // KMS contract address for on-chain KMS
   env_keys: import_zod10.z.array(import_zod10.z.string()).optional()
 }).passthrough();
 function handleGatewayCompatibility(appCompose) {
@@ -1310,7 +1437,8 @@ function handleGatewayCompatibility(appCompose) {
   };
 }
 var { action: provisionCvm, safeAction: safeProvisionCvm } = defineAction(ProvisionCvmSchema, async (client, appCompose) => {
-  const body = handleGatewayCompatibility(appCompose);
+  const validated = ProvisionCvmRequestSchema.parse(appCompose);
+  const body = handleGatewayCompatibility(validated);
   let requestBody = { ...body };
   if (typeof body.node_id === "number") {
     requestBody = { ...body, teepod_id: body.node_id };
@@ -1354,7 +1482,7 @@ var CommitCvmProvisionSchema = import_zod11.z.object({
 var CommitCvmProvisionRequestSchema = import_zod11.z.object({
   encrypted_env: import_zod11.z.string().optional().nullable(),
   app_id: import_zod11.z.string(),
-  compose_hash: import_zod11.z.string().optional(),
+  compose_hash: import_zod11.z.string(),
   kms_id: import_zod11.z.string().optional(),
   contract_address: import_zod11.z.string().optional(),
   deployer_address: import_zod11.z.string().optional(),
@@ -1567,6 +1695,26 @@ var { action: getAppEnvEncryptPubKey, safeAction: safeGetAppEnvEncryptPubKey } =
   return await client.get(`/kms/${validatedRequest.kms}/pubkey/${validatedRequest.app_id}`);
 });
 
+// src/actions/kms/next_app_ids.ts
+var import_zod18 = require("zod");
+var NextAppIdsRequestSchema = import_zod18.z.object({
+  counts: import_zod18.z.number().int().min(1).max(20).optional().default(1)
+}).strict();
+var NextAppIdsSchema = import_zod18.z.object({
+  app_ids: import_zod18.z.array(
+    import_zod18.z.object({
+      app_id: import_zod18.z.string(),
+      nonce: import_zod18.z.number().int().min(0)
+    })
+  )
+}).strict();
+var { action: nextAppIds, safeAction: safeNextAppIds } = defineAction(NextAppIdsSchema, async (client, payload) => {
+  const validatedRequest = NextAppIdsRequestSchema.parse(payload ?? {});
+  const params = new URLSearchParams();
+  params.append("counts", validatedRequest.counts.toString());
+  return await client.get(`/kms/phala/next_app_id?${params.toString()}`);
+});
+
 // src/actions/cvms/start_cvm.ts
 var StartCvmRequestSchema = CvmIdSchema;
 var { action: startCvm, safeAction: safeStartCvm } = defineAction(VMSchema, async (client, request) => {
@@ -1592,10 +1740,10 @@ var { action: shutdownCvm, safeAction: safeShutdownCvm } = defineAction(VMSchema
 });
 
 // src/actions/cvms/restart_cvm.ts
-var import_zod18 = require("zod");
+var import_zod19 = require("zod");
 var RestartCvmRequestSchema = refineCvmId(
   CvmIdObjectSchema.extend({
-    force: import_zod18.z.boolean().optional()
+    force: import_zod19.z.boolean().optional()
   })
 );
 var { action: restartCvm, safeAction: safeRestartCvm } = defineAction(VMSchema, async (client, request) => {
@@ -1606,10 +1754,10 @@ var { action: restartCvm, safeAction: safeRestartCvm } = defineAction(VMSchema,
 });
 
 // src/actions/cvms/delete_cvm.ts
-var import_zod19 = require("zod");
+var import_zod20 = require("zod");
 var DeleteCvmRequestSchema = CvmIdSchema;
 var { action: deleteCvm, safeAction: safeDeleteCvm } = defineAction(
-  import_zod19.z.void(),
+  import_zod20.z.void(),
   async (client, request) => {
     const { cvmId } = DeleteCvmRequestSchema.parse(request);
     await client.delete(`/cvms/${cvmId}`);
@@ -1618,41 +1766,41 @@ var { action: deleteCvm, safeAction: safeDeleteCvm } = defineAction(
 );
 
 // src/actions/cvms/get_cvm_stats.ts
-var import_zod20 = require("zod");
-var DiskInfoSchema = import_zod20.z.object({
-  name: import_zod20.z.string(),
-  mount_point: import_zod20.z.string(),
-  total_size: import_zod20.z.number(),
-  free_size: import_zod20.z.number()
+var import_zod21 = require("zod");
+var DiskInfoSchema = import_zod21.z.object({
+  name: import_zod21.z.string(),
+  mount_point: import_zod21.z.string(),
+  total_size: import_zod21.z.number(),
+  free_size: import_zod21.z.number()
 });
-var SystemInfoSchema = import_zod20.z.object({
-  os_name: import_zod20.z.string(),
-  os_version: import_zod20.z.string(),
-  kernel_version: import_zod20.z.string(),
-  cpu_model: import_zod20.z.string(),
-  num_cpus: import_zod20.z.number(),
-  total_memory: import_zod20.z.number(),
-  available_memory: import_zod20.z.number(),
-  used_memory: import_zod20.z.number(),
-  free_memory: import_zod20.z.number(),
-  total_swap: import_zod20.z.number(),
-  used_swap: import_zod20.z.number(),
-  free_swap: import_zod20.z.number(),
-  uptime: import_zod20.z.number(),
-  loadavg_one: import_zod20.z.number(),
-  loadavg_five: import_zod20.z.number(),
-  loadavg_fifteen: import_zod20.z.number(),
-  disks: import_zod20.z.array(DiskInfoSchema)
+var SystemInfoSchema = import_zod21.z.object({
+  os_name: import_zod21.z.string(),
+  os_version: import_zod21.z.string(),
+  kernel_version: import_zod21.z.string(),
+  cpu_model: import_zod21.z.string(),
+  num_cpus: import_zod21.z.number(),
+  total_memory: import_zod21.z.number(),
+  available_memory: import_zod21.z.number(),
+  used_memory: import_zod21.z.number(),
+  free_memory: import_zod21.z.number(),
+  total_swap: import_zod21.z.number(),
+  used_swap: import_zod21.z.number(),
+  free_swap: import_zod21.z.number(),
+  uptime: import_zod21.z.number(),
+  loadavg_one: import_zod21.z.number(),
+  loadavg_five: import_zod21.z.number(),
+  loadavg_fifteen: import_zod21.z.number(),
+  disks: import_zod21.z.array(DiskInfoSchema)
 });
-var CvmSystemInfoSchema = import_zod20.z.object({
-  is_online: import_zod20.z.boolean(),
-  is_public: import_zod20.z.boolean().default(false),
-  error: import_zod20.z.string().nullable(),
+var CvmSystemInfoSchema = import_zod21.z.object({
+  is_online: import_zod21.z.boolean(),
+  is_public: import_zod21.z.boolean().default(false),
+  error: import_zod21.z.string().nullable(),
   sysinfo: SystemInfoSchema.nullable(),
-  status: import_zod20.z.string().nullable(),
-  in_progress: import_zod20.z.boolean().default(false),
-  boot_progress: import_zod20.z.string().nullable(),
-  boot_error: import_zod20.z.string().nullable()
+  status: import_zod21.z.string().nullable(),
+  in_progress: import_zod21.z.boolean().default(false),
+  boot_progress: import_zod21.z.string().nullable(),
+  boot_error: import_zod21.z.string().nullable()
 });
 var GetCvmStatsRequestSchema = CvmIdSchema;
 var { action: getCvmStats, safeAction: safeGetCvmStats } = defineAction(CvmSystemInfoSchema, async (client, request) => {
@@ -1661,18 +1809,18 @@ var { action: getCvmStats, safeAction: safeGetCvmStats } = defineAction(CvmSyste
 });
 
 // src/actions/cvms/get_cvm_network.ts
-var import_zod21 = require("zod");
-var CvmNetworkUrlsSchema2 = import_zod21.z.object({
-  app: import_zod21.z.string(),
-  instance: import_zod21.z.string()
+var import_zod22 = require("zod");
+var CvmNetworkUrlsSchema2 = import_zod22.z.object({
+  app: import_zod22.z.string(),
+  instance: import_zod22.z.string()
 });
-var CvmNetworkSchema = import_zod21.z.object({
-  is_online: import_zod21.z.boolean(),
-  is_public: import_zod21.z.boolean().default(true),
-  error: import_zod21.z.string().nullable(),
-  internal_ip: import_zod21.z.string().nullable(),
-  latest_handshake: import_zod21.z.string().nullable(),
-  public_urls: import_zod21.z.array(CvmNetworkUrlsSchema2).nullable()
+var CvmNetworkSchema = import_zod22.z.object({
+  is_online: import_zod22.z.boolean(),
+  is_public: import_zod22.z.boolean().default(true),
+  error: import_zod22.z.string().nullable(),
+  internal_ip: import_zod22.z.string().nullable(),
+  latest_handshake: import_zod22.z.string().nullable(),
+  public_urls: import_zod22.z.array(CvmNetworkUrlsSchema2).nullable()
 });
 var GetCvmNetworkRequestSchema = CvmIdSchema;
 var { action: getCvmNetwork, safeAction: safeGetCvmNetwork } = defineAction(CvmNetworkSchema, async (client, request) => {
@@ -1681,36 +1829,36 @@ var { action: getCvmNetwork, safeAction: safeGetCvmNetwork } = defineAction(CvmN
 });
 
 // src/actions/cvms/get_cvm_docker_compose.ts
-var import_zod22 = require("zod");
+var import_zod23 = require("zod");
 var GetCvmDockerComposeRequestSchema = CvmIdSchema;
-var { action: getCvmDockerCompose, safeAction: safeGetCvmDockerCompose } = defineAction(import_zod22.z.string(), async (client, request) => {
+var { action: getCvmDockerCompose, safeAction: safeGetCvmDockerCompose } = defineAction(import_zod23.z.string(), async (client, request) => {
   const { cvmId } = GetCvmDockerComposeRequestSchema.parse(request);
   return await client.get(`/cvms/${cvmId}/docker-compose.yml`);
 });
 
 // src/actions/cvms/get_cvm_containers_stats.ts
-var import_zod23 = require("zod");
-var ContainerInfoSchema = import_zod23.z.object({
-  id: import_zod23.z.string(),
-  names: import_zod23.z.array(import_zod23.z.string()),
-  image: import_zod23.z.string(),
-  image_id: import_zod23.z.string(),
-  command: import_zod23.z.string().nullable().optional(),
-  created: import_zod23.z.number(),
-  state: import_zod23.z.string(),
-  status: import_zod23.z.string(),
-  log_endpoint: import_zod23.z.string().nullable()
+var import_zod24 = require("zod");
+var ContainerInfoSchema = import_zod24.z.object({
+  id: import_zod24.z.string(),
+  names: import_zod24.z.array(import_zod24.z.string()),
+  image: import_zod24.z.string(),
+  image_id: import_zod24.z.string(),
+  command: import_zod24.z.string().nullable().optional(),
+  created: import_zod24.z.number(),
+  state: import_zod24.z.string(),
+  status: import_zod24.z.string(),
+  log_endpoint: import_zod24.z.string().nullable()
 });
-var CvmContainersStatsSchema = import_zod23.z.object({
-  is_online: import_zod23.z.boolean(),
-  is_public: import_zod23.z.boolean().default(true),
-  error: import_zod23.z.string().nullable(),
-  docker_compose_file: import_zod23.z.string().nullable(),
-  manifest_version: import_zod23.z.number().nullable(),
-  version: import_zod23.z.string().nullable(),
-  runner: import_zod23.z.string().nullable(),
-  features: import_zod23.z.array(import_zod23.z.string()).nullable(),
-  containers: import_zod23.z.array(ContainerInfoSchema).nullable()
+var CvmContainersStatsSchema = import_zod24.z.object({
+  is_online: import_zod24.z.boolean(),
+  is_public: import_zod24.z.boolean().default(true),
+  error: import_zod24.z.string().nullable(),
+  docker_compose_file: import_zod24.z.string().nullable(),
+  manifest_version: import_zod24.z.number().nullable(),
+  version: import_zod24.z.string().nullable(),
+  runner: import_zod24.z.string().nullable(),
+  features: import_zod24.z.array(import_zod24.z.string()).nullable(),
+  containers: import_zod24.z.array(ContainerInfoSchema).nullable()
 });
 var GetCvmContainersStatsRequestSchema = CvmIdSchema;
 var { action: getCvmContainersStats, safeAction: safeGetCvmContainersStats } = defineAction(CvmContainersStatsSchema, async (client, request) => {
@@ -1719,62 +1867,62 @@ var { action: getCvmContainersStats, safeAction: safeGetCvmContainersStats } = d
 });
 
 // src/actions/cvms/get_cvm_attestation.ts
-var import_zod24 = require("zod");
-var CertificateSubjectSchema = import_zod24.z.object({
-  common_name: import_zod24.z.string().nullable(),
-  organization: import_zod24.z.string().nullable(),
-  country: import_zod24.z.string().nullable(),
-  state: import_zod24.z.string().nullable(),
-  locality: import_zod24.z.string().nullable()
+var import_zod25 = require("zod");
+var CertificateSubjectSchema = import_zod25.z.object({
+  common_name: import_zod25.z.string().nullable(),
+  organization: import_zod25.z.string().nullable(),
+  country: import_zod25.z.string().nullable(),
+  state: import_zod25.z.string().nullable(),
+  locality: import_zod25.z.string().nullable()
 });
-var CertificateIssuerSchema = import_zod24.z.object({
-  common_name: import_zod24.z.string().nullable(),
-  organization: import_zod24.z.string().nullable(),
-  country: import_zod24.z.string().nullable()
+var CertificateIssuerSchema = import_zod25.z.object({
+  common_name: import_zod25.z.string().nullable(),
+  organization: import_zod25.z.string().nullable(),
+  country: import_zod25.z.string().nullable()
 });
-var CertificateSchema = import_zod24.z.object({
+var CertificateSchema = import_zod25.z.object({
   subject: CertificateSubjectSchema,
   issuer: CertificateIssuerSchema,
-  serial_number: import_zod24.z.string(),
-  not_before: import_zod24.z.string(),
+  serial_number: import_zod25.z.string(),
+  not_before: import_zod25.z.string(),
   // datetime serialized as ISO string
-  not_after: import_zod24.z.string(),
+  not_after: import_zod25.z.string(),
   // datetime serialized as ISO string
-  version: import_zod24.z.string(),
-  fingerprint: import_zod24.z.string(),
-  signature_algorithm: import_zod24.z.string(),
-  sans: import_zod24.z.array(import_zod24.z.string()).nullable(),
-  is_ca: import_zod24.z.boolean(),
-  position_in_chain: import_zod24.z.number().nullable(),
-  quote: import_zod24.z.string().nullable(),
-  app_id: import_zod24.z.string().nullable().optional(),
-  cert_usage: import_zod24.z.string().nullable().optional()
+  version: import_zod25.z.string(),
+  fingerprint: import_zod25.z.string(),
+  signature_algorithm: import_zod25.z.string(),
+  sans: import_zod25.z.array(import_zod25.z.string()).nullable(),
+  is_ca: import_zod25.z.boolean(),
+  position_in_chain: import_zod25.z.number().nullable(),
+  quote: import_zod25.z.string().nullable(),
+  app_id: import_zod25.z.string().nullable().optional(),
+  cert_usage: import_zod25.z.string().nullable().optional()
 });
-var EventLogSchema = import_zod24.z.object({
-  imr: import_zod24.z.number(),
-  event_type: import_zod24.z.number(),
-  digest: import_zod24.z.string(),
-  event: import_zod24.z.string(),
-  event_payload: import_zod24.z.string()
+var EventLogSchema = import_zod25.z.object({
+  imr: import_zod25.z.number(),
+  event_type: import_zod25.z.number(),
+  digest: import_zod25.z.string(),
+  event: import_zod25.z.string(),
+  event_payload: import_zod25.z.string()
 });
-var TcbInfoSchema = import_zod24.z.object({
-  mrtd: import_zod24.z.string(),
-  rootfs_hash: import_zod24.z.string().nullable().optional(),
-  rtmr0: import_zod24.z.string(),
-  rtmr1: import_zod24.z.string(),
-  rtmr2: import_zod24.z.string(),
-  rtmr3: import_zod24.z.string(),
-  event_log: import_zod24.z.array(EventLogSchema),
-  app_compose: import_zod24.z.string()
+var TcbInfoSchema = import_zod25.z.object({
+  mrtd: import_zod25.z.string(),
+  rootfs_hash: import_zod25.z.string().nullable().optional(),
+  rtmr0: import_zod25.z.string(),
+  rtmr1: import_zod25.z.string(),
+  rtmr2: import_zod25.z.string(),
+  rtmr3: import_zod25.z.string(),
+  event_log: import_zod25.z.array(EventLogSchema),
+  app_compose: import_zod25.z.string()
 });
-var CvmAttestationSchema = import_zod24.z.object({
-  name: import_zod24.z.string().nullable(),
-  is_online: import_zod24.z.boolean(),
-  is_public: import_zod24.z.boolean().default(true),
-  error: import_zod24.z.string().nullable(),
-  app_certificates: import_zod24.z.array(CertificateSchema).nullable(),
+var CvmAttestationSchema = import_zod25.z.object({
+  name: import_zod25.z.string().nullable(),
+  is_online: import_zod25.z.boolean(),
+  is_public: import_zod25.z.boolean().default(true),
+  error: import_zod25.z.string().nullable(),
+  app_certificates: import_zod25.z.array(CertificateSchema).nullable(),
   tcb_info: TcbInfoSchema.nullable(),
-  compose_file: import_zod24.z.string().nullable()
+  compose_file: import_zod25.z.string().nullable()
 });
 var GetCvmAttestationRequestSchema = CvmIdSchema;
 var { action: getCvmAttestation, safeAction: safeGetCvmAttestation } = defineAction(CvmAttestationSchema, async (client, request) => {
@@ -1783,17 +1931,17 @@ var { action: getCvmAttestation, safeAction: safeGetCvmAttestation } = defineAct
 });
 
 // src/actions/cvms/update_cvm_resources.ts
-var import_zod25 = require("zod");
+var import_zod26 = require("zod");
 var UpdateCvmResourcesRequestSchema = refineCvmId(
   CvmIdObjectSchema.extend({
-    vcpu: import_zod25.z.number().optional(),
-    memory: import_zod25.z.number().optional(),
-    disk_size: import_zod25.z.number().optional(),
-    instance_type: import_zod25.z.string().optional(),
-    allow_restart: import_zod25.z.boolean().optional()
+    vcpu: import_zod26.z.number().optional(),
+    memory: import_zod26.z.number().optional(),
+    disk_size: import_zod26.z.number().optional(),
+    instance_type: import_zod26.z.string().optional(),
+    allow_restart: import_zod26.z.boolean().optional()
   })
 );
-var { action: updateCvmResources, safeAction: safeUpdateCvmResources } = defineAction(import_zod25.z.void(), async (client, request) => {
+var { action: updateCvmResources, safeAction: safeUpdateCvmResources } = defineAction(import_zod26.z.void(), async (client, request) => {
   const parsed = UpdateCvmResourcesRequestSchema.parse(request);
   const { cvmId } = CvmIdSchema.parse(parsed);
   const { ...body } = parsed;
@@ -1802,11 +1950,11 @@ var { action: updateCvmResources, safeAction: safeUpdateCvmResources } = defineA
 });
 
 // src/actions/cvms/update_cvm_visibility.ts
-var import_zod26 = require("zod");
+var import_zod27 = require("zod");
 var UpdateCvmVisibilityRequestSchema = refineCvmId(
   CvmIdObjectSchema.extend({
-    public_sysinfo: import_zod26.z.boolean(),
-    public_logs: import_zod26.z.boolean()
+    public_sysinfo: import_zod27.z.boolean(),
+    public_logs: import_zod27.z.boolean()
   })
 );
 var { action: updateCvmVisibility, safeAction: safeUpdateCvmVisibility } = defineAction(CvmLegacyDetailSchema, async (client, request) => {
@@ -1816,6 +1964,59 @@ var { action: updateCvmVisibility, safeAction: safeUpdateCvmVisibility } = defin
   return await client.patch(`/cvms/${cvmId}/visibility`, { public_sysinfo, public_logs });
 });
 
+// src/actions/cvms/get_available_os_images.ts
+var import_zod28 = require("zod");
+var OSImageVariantSchema = import_zod28.z.object({
+  name: import_zod28.z.string(),
+  os_image_hash: import_zod28.z.string().nullable(),
+  is_current: import_zod28.z.boolean()
+});
+var AvailableOSImageSchema2 = import_zod28.z.object({
+  version: import_zod28.z.union([
+    import_zod28.z.tuple([import_zod28.z.number(), import_zod28.z.number(), import_zod28.z.number(), import_zod28.z.number()]),
+    import_zod28.z.tuple([import_zod28.z.number(), import_zod28.z.number(), import_zod28.z.number()])
+  ]),
+  prod: OSImageVariantSchema.nullable(),
+  dev: OSImageVariantSchema.nullable()
+});
+var GetAvailableOSImagesResponseSchema = import_zod28.z.array(AvailableOSImageSchema2);
+var GetAvailableOSImagesRequestSchema = CvmIdSchema;
+var { action: getAvailableOsImages, safeAction: safeGetAvailableOsImages } = defineAction(GetAvailableOSImagesResponseSchema, async (client, request) => {
+  const { cvmId } = GetAvailableOSImagesRequestSchema.parse(request);
+  return await client.get(`/cvms/${cvmId}/available-os-images`);
+});
+
+// src/actions/cvms/update_os_image.ts
+var import_zod29 = require("zod");
+var UpdateOsImageRequestSchema = refineCvmId(
+  CvmIdObjectSchema.extend({
+    os_image_name: import_zod29.z.string().min(1, "OS image name is required")
+  })
+);
+var { action: updateOsImage, safeAction: safeUpdateOsImage } = defineAction(import_zod29.z.void(), async (client, request) => {
+  const parsed = UpdateOsImageRequestSchema.parse(request);
+  const { cvmId } = CvmIdSchema.parse(parsed);
+  const { os_image_name } = parsed;
+  await client.patch(`/cvms/${cvmId}/os-image`, { os_image_name });
+  return void 0;
+});
+
+// src/actions/cvms/get_cvm_state.ts
+var import_zod30 = require("zod");
+var CvmStateSchema = import_zod30.z.object({
+  status: import_zod30.z.string(),
+  derived_status: import_zod30.z.string().optional(),
+  vm_uuid: import_zod30.z.string().optional(),
+  instance_id: import_zod30.z.string().optional(),
+  uptime: import_zod30.z.string().optional()
+  // Add other state fields as needed
+});
+var GetCvmStateRequestSchema = CvmIdSchema;
+var { action: getCvmState, safeAction: safeGetCvmState } = defineAction(CvmStateSchema, async (client, request) => {
+  const { cvmId } = GetCvmStateRequestSchema.parse(request);
+  return await client.get(`/cvms/${cvmId}/state`);
+});
+
 // src/create-client.ts
 function createClient2(config = {}) {
   const client = createClient(config);
@@ -1824,8 +2025,10 @@ function createClient2(config = {}) {
     safeGetCurrentUser,
     getAvailableNodes,
     safeGetAvailableNodes,
-    listInstanceTypes,
-    safeListInstanceTypes,
+    listAllInstanceTypeFamilies,
+    safeListAllInstanceTypeFamilies,
+    listFamilyInstanceTypes,
+    safeListFamilyInstanceTypes,
     listWorkspaces,
     safeListWorkspaces,
     getWorkspace,
@@ -1868,18 +2071,26 @@ function createClient2(config = {}) {
     safeUpdateCvmResources,
     updateCvmVisibility,
     safeUpdateCvmVisibility,
+    getAvailableOsImages,
+    safeGetAvailableOsImages,
+    updateOsImage,
+    safeUpdateOsImage,
     getKmsInfo,
     safeGetKmsInfo,
     getKmsList,
     safeGetKmsList,
     getAppEnvEncryptPubKey,
-    safeGetAppEnvEncryptPubKey
+    safeGetAppEnvEncryptPubKey,
+    nextAppIds,
+    safeNextAppIds,
+    getCvmState,
+    safeGetCvmState
   };
   return client.extend(allActions);
 }
 
 // src/actions/blockchains/deploy_app_auth.ts
-var import_zod27 = require("zod");
+var import_zod31 = require("zod");
 var import_viem3 = require("viem");
 var import_accounts2 = require("viem/accounts");
 
@@ -2529,25 +2740,25 @@ var kmsAuthAbi = [
     anonymous: false
   }
 ];
-var DeployAppAuthRequestBaseSchema = import_zod27.z.object({
+var DeployAppAuthRequestBaseSchema = import_zod31.z.object({
   // Chain configuration (conditionally required)
-  chain: import_zod27.z.unknown().optional(),
-  rpcUrl: import_zod27.z.string().optional(),
+  chain: import_zod31.z.unknown().optional(),
+  rpcUrl: import_zod31.z.string().optional(),
   // Contract configuration (required)
-  kmsContractAddress: import_zod27.z.string(),
+  kmsContractAddress: import_zod31.z.string(),
   // Authentication mode: either privateKey OR walletClient (required, mutually exclusive)
-  privateKey: import_zod27.z.string().optional(),
-  walletClient: import_zod27.z.unknown().optional(),
+  privateKey: import_zod31.z.string().optional(),
+  walletClient: import_zod31.z.unknown().optional(),
   // Public client (optional, will create default if not provided)
-  publicClient: import_zod27.z.unknown().optional(),
+  publicClient: import_zod31.z.unknown().optional(),
   // App configuration (optional)
-  allowAnyDevice: import_zod27.z.boolean().optional().default(false),
-  deviceId: import_zod27.z.string().optional().default("0000000000000000000000000000000000000000000000000000000000000000"),
-  composeHash: import_zod27.z.string().optional().default("0000000000000000000000000000000000000000000000000000000000000000"),
-  disableUpgrades: import_zod27.z.boolean().optional().default(false),
+  allowAnyDevice: import_zod31.z.boolean().optional().default(false),
+  deviceId: import_zod31.z.string().optional().default("0000000000000000000000000000000000000000000000000000000000000000"),
+  composeHash: import_zod31.z.string().optional().default("0000000000000000000000000000000000000000000000000000000000000000"),
+  disableUpgrades: import_zod31.z.boolean().optional().default(false),
   // Validation configuration (optional)
-  skipPrerequisiteChecks: import_zod27.z.boolean().optional().default(false),
-  minBalance: import_zod27.z.string().optional()
+  skipPrerequisiteChecks: import_zod31.z.boolean().optional().default(false),
+  minBalance: import_zod31.z.string().optional()
   // ETH amount as string, e.g., "0.01"
 }).passthrough();
 var DeployAppAuthRequestSchema = DeployAppAuthRequestBaseSchema.refine(
@@ -2575,13 +2786,13 @@ var DeployAppAuthRequestSchema = DeployAppAuthRequestBaseSchema.refine(
     path: ["chain"]
   }
 );
-var DeployAppAuthSchema = import_zod27.z.object({
-  appId: import_zod27.z.string(),
-  appAuthAddress: import_zod27.z.string(),
-  deployer: import_zod27.z.string(),
-  transactionHash: import_zod27.z.string(),
-  blockNumber: import_zod27.z.bigint().optional(),
-  gasUsed: import_zod27.z.bigint().optional()
+var DeployAppAuthSchema = import_zod31.z.object({
+  appId: import_zod31.z.string(),
+  appAuthAddress: import_zod31.z.string(),
+  deployer: import_zod31.z.string(),
+  transactionHash: import_zod31.z.string(),
+  blockNumber: import_zod31.z.bigint().optional(),
+  gasUsed: import_zod31.z.bigint().optional()
 }).passthrough();
 function parseDeploymentResult(receipt, deployer, kmsContractAddress) {
   try {
@@ -2827,7 +3038,7 @@ async function safeDeployAppAuth(request, parameters) {
 }
 
 // src/actions/blockchains/add_compose_hash.ts
-var import_zod28 = require("zod");
+var import_zod32 = require("zod");
 var import_viem4 = require("viem");
 var import_accounts3 = require("viem/accounts");
 var appAuthAbi = [
@@ -2845,29 +3056,29 @@ var appAuthAbi = [
     anonymous: false
   }
 ];
-var AddComposeHashRequestSchema = import_zod28.z.object({
+var AddComposeHashRequestSchema = import_zod32.z.object({
   // Chain configuration (conditionally required)
-  chain: import_zod28.z.unknown().optional(),
-  rpcUrl: import_zod28.z.string().optional(),
-  appId: import_zod28.z.string(),
-  composeHash: import_zod28.z.string(),
+  chain: import_zod32.z.unknown().optional(),
+  rpcUrl: import_zod32.z.string().optional(),
+  appId: import_zod32.z.string(),
+  composeHash: import_zod32.z.string(),
   // Authentication mode: either privateKey OR walletClient (required, mutually exclusive)
-  privateKey: import_zod28.z.string().optional(),
-  walletClient: import_zod28.z.unknown().optional(),
+  privateKey: import_zod32.z.string().optional(),
+  walletClient: import_zod32.z.unknown().optional(),
   // Public client (optional, will create default if not provided)
-  publicClient: import_zod28.z.unknown().optional(),
+  publicClient: import_zod32.z.unknown().optional(),
   // Validation configuration (optional)
-  skipPrerequisiteChecks: import_zod28.z.boolean().optional().default(false),
-  minBalance: import_zod28.z.string().optional(),
+  skipPrerequisiteChecks: import_zod32.z.boolean().optional().default(false),
+  minBalance: import_zod32.z.string().optional(),
   // ETH amount as string, e.g., "0.01"
   // Transaction control options
-  timeout: import_zod28.z.number().optional().default(12e4),
-  retryOptions: import_zod28.z.unknown().optional(),
-  signal: import_zod28.z.unknown().optional(),
+  timeout: import_zod32.z.number().optional().default(12e4),
+  retryOptions: import_zod32.z.unknown().optional(),
+  signal: import_zod32.z.unknown().optional(),
   // Progress callbacks
-  onTransactionStateChange: import_zod28.z.function().optional(),
-  onTransactionSubmitted: import_zod28.z.function().optional(),
-  onTransactionConfirmed: import_zod28.z.function().optional()
+  onTransactionStateChange: import_zod32.z.function().optional(),
+  onTransactionSubmitted: import_zod32.z.function().optional(),
+  onTransactionConfirmed: import_zod32.z.function().optional()
 }).passthrough().refine(
   (data) => {
     const hasPrivateKey = !!data.privateKey;
@@ -2891,12 +3102,12 @@ var AddComposeHashRequestSchema = import_zod28.z.object({
     path: ["chain"]
   }
 );
-var AddComposeHashSchema = import_zod28.z.object({
-  composeHash: import_zod28.z.string(),
-  appId: import_zod28.z.string(),
-  transactionHash: import_zod28.z.string(),
-  blockNumber: import_zod28.z.bigint().optional(),
-  gasUsed: import_zod28.z.bigint().optional()
+var AddComposeHashSchema = import_zod32.z.object({
+  composeHash: import_zod32.z.string(),
+  appId: import_zod32.z.string(),
+  transactionHash: import_zod32.z.string(),
+  blockNumber: import_zod32.z.bigint().optional(),
+  gasUsed: import_zod32.z.bigint().optional()
 }).passthrough();
 function parseComposeHashResult(receipt, composeHash, appAuthAddress, appId) {
   console.log(receipt.logs);
@@ -3087,6 +3298,200 @@ async function safeAddComposeHash(request, parameters) {
   }
 }
 
+// src/actions/cvms/watch_cvm_state.ts
+var import_zod33 = require("zod");
+var WatchCvmStateParamsSchema = import_zod33.z.object({
+  target: import_zod33.z.string().describe("Target status to wait for (e.g., 'running', 'stopped')"),
+  interval: import_zod33.z.number().min(5).max(30).default(5).describe("Polling interval in seconds"),
+  timeout: import_zod33.z.number().min(10).max(600).default(300).describe("Timeout per attempt in seconds"),
+  maxRetries: import_zod33.z.number().min(0).default(Number.POSITIVE_INFINITY).describe("Maximum number of retry attempts (Infinity for unlimited)"),
+  retryDelay: import_zod33.z.number().min(0).default(5e3).describe("Delay between retries in milliseconds")
+});
+var WatchCvmStateRequestSchema = WatchCvmStateParamsSchema;
+var WatchAbortedError = class extends Error {
+  constructor() {
+    super("Watch operation was aborted");
+    this.name = "WatchAbortedError";
+  }
+};
+var MaxRetriesExceededError = class extends Error {
+  constructor(attempts) {
+    super(`Maximum retry attempts (${attempts}) exceeded`);
+    this.attempts = attempts;
+    this.name = "MaxRetriesExceededError";
+  }
+};
+function parseSSEEvent(eventType, data) {
+  try {
+    const parsed = JSON.parse(data);
+    return { type: eventType, data: parsed };
+  } catch {
+    return { type: "error", data: { error: "Failed to parse SSE event" } };
+  }
+}
+async function watchCvmState(client, request, options = {}) {
+  const { cvmId } = CvmIdSchema.parse(request);
+  const { target, interval, timeout, maxRetries, retryDelay } = WatchCvmStateParamsSchema.parse(request);
+  const { signal, onEvent } = options;
+  let attempt = 0;
+  while (attempt < maxRetries) {
+    if (signal?.aborted) {
+      throw new WatchAbortedError();
+    }
+    attempt++;
+    try {
+      const result = await watchSingleAttempt(
+        client,
+        cvmId,
+        target,
+        interval,
+        timeout,
+        signal,
+        onEvent
+      );
+      if (result) {
+        return result;
+      }
+      if (attempt >= maxRetries) {
+        throw new MaxRetriesExceededError(attempt);
+      }
+      await sleep(retryDelay, signal);
+    } catch (error) {
+      if (signal?.aborted) {
+        throw new WatchAbortedError();
+      }
+      if (error instanceof WatchAbortedError || error instanceof MaxRetriesExceededError) {
+        throw error;
+      }
+      if (attempt >= maxRetries) {
+        throw error;
+      }
+      if (onEvent) {
+        onEvent({
+          type: "error",
+          data: { error: error instanceof Error ? error.message : String(error) }
+        });
+      }
+      await sleep(retryDelay, signal);
+    }
+  }
+  throw new MaxRetriesExceededError(attempt);
+}
+async function watchSingleAttempt(client, cvmId, target, interval, timeout, signal, onEvent) {
+  const params = new URLSearchParams({
+    target,
+    interval: String(interval),
+    timeout: String(timeout)
+  });
+  const baseURL = client.config.baseURL || "";
+  const fullUrl = `${baseURL}/cvms/${cvmId}/state?${params.toString()}`;
+  const headers = {
+    Accept: "text/event-stream",
+    "Cache-Control": "no-cache"
+  };
+  if (!client.config.useCookieAuth && client.config.apiKey) {
+    headers["X-API-Key"] = client.config.apiKey;
+  }
+  if (client.config.headers) {
+    Object.entries(client.config.headers).forEach(([key, value]) => {
+      if (typeof value === "string") {
+        headers[key] = value;
+      }
+    });
+  }
+  const response = await client.raw.native(fullUrl, {
+    method: "GET",
+    headers,
+    signal,
+    ...client.config.useCookieAuth ? { credentials: "include" } : {}
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+  }
+  if (!response.body) {
+    throw new Error("Response body is null");
+  }
+  return parseSSEStream(response.body, signal, onEvent);
+}
+async function parseSSEStream(stream, signal, onEvent) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let finalState = null;
+  let currentEvent = "";
+  let currentData = "";
+  const processLine = (line) => {
+    if (line.startsWith("event:")) {
+      currentEvent = line.slice(6).trim();
+    } else if (line.startsWith("data:")) {
+      currentData = line.slice(5).trim();
+    } else if (line === "") {
+      if (currentEvent && currentData) {
+        const event = parseSSEEvent(currentEvent, currentData);
+        if (event.type === "state") {
+          finalState = event.data;
+        }
+        onEvent?.(event);
+        if (event.type === "complete") {
+          return "complete";
+        }
+        if (event.type === "timeout") {
+          return "timeout";
+        }
+      }
+      currentEvent = "";
+      currentData = "";
+    }
+    return null;
+  };
+  try {
+    while (true) {
+      if (signal?.aborted) {
+        throw new WatchAbortedError();
+      }
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        const result = processLine(line.trim());
+        if (result === "complete") {
+          return finalState;
+        }
+        if (result === "timeout") {
+          return null;
+        }
+      }
+    }
+    return finalState;
+  } catch (error) {
+    if (error instanceof WatchAbortedError) {
+      throw error;
+    }
+    throw new Error(`SSE stream error: ${error instanceof Error ? error.message : String(error)}`);
+  } finally {
+    reader.releaseLock();
+  }
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new WatchAbortedError());
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    if (signal) {
+      signal.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(new WatchAbortedError());
+      });
+    }
+  });
+}
+
 // src/parse_dotenv.ts
 var LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/gm;
 function parseEnv(input) {
@@ -3125,6 +3530,7 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AddComposeHashSchema,
+  AllFamiliesResponseSchema,
   ApiErrorSchema,
   AuthError,
   AvailableNodesSchema,
@@ -3144,12 +3550,17 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   CvmNetworkSchema,
   CvmNetworkUrlsSchema,
   CvmNodeSchema,
+  CvmStateSchema,
   CvmSystemInfoSchema,
   DeleteCvmRequestSchema,
   DeployAppAuthRequestSchema,
   DeployAppAuthSchema,
+  FamilyGroupSchema,
+  FamilyInstanceTypesResponseSchema,
   GetAppEnvEncryptPubKeyRequestSchema,
   GetAppEnvEncryptPubKeySchema,
+  GetAvailableOSImagesRequestSchema,
+  GetAvailableOSImagesResponseSchema,
   GetCvmAttestationRequestSchema,
   GetCvmComposeFileRequestSchema,
   GetCvmContainersStatsRequestSchema,
@@ -3158,17 +3569,21 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   GetCvmListRequestSchema,
   GetCvmListSchema,
   GetCvmNetworkRequestSchema,
+  GetCvmStateRequestSchema,
   GetCvmStatsRequestSchema,
   GetKmsInfoRequestSchema,
   GetKmsListRequestSchema,
   GetKmsListSchema,
   InstanceTypeSchema,
   KmsInfoSchema,
-  ListInstanceTypesRequestSchema,
+  ListFamilyInstanceTypesRequestSchema,
   ListWorkspacesSchema,
   ManagedUserSchema,
+  MaxRetriesExceededError,
   NetworkError,
-  PaginatedInstanceTypesSchema,
+  NextAppIdsRequestSchema,
+  NextAppIdsSchema,
+  OSImageVariantSchema,
   PaginationMetadataSchema,
   PhalaCloudError,
   ProvisionCvmComposeFileUpdateRequestSchema,
@@ -3176,6 +3591,7 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   ProvisionCvmRequestSchema,
   ProvisionCvmSchema,
   RequestError,
+  ResourceError,
   RestartCvmRequestSchema,
   SUPPORTED_CHAINS,
   ServerError,
@@ -3186,10 +3602,13 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   UnknownError,
   UpdateCvmResourcesRequestSchema,
   UpdateCvmVisibilityRequestSchema,
+  UpdateOsImageRequestSchema,
   VMSchema,
   ValidationError,
   VmInfoSchema,
   WalletError,
+  WatchAbortedError,
+  WatchCvmStateRequestSchema,
   WorkspaceResponseSchema,
   addComposeHash,
   addNetwork,
@@ -3217,9 +3636,11 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   executeTransactionWithRetry,
   extractNetworkClients,
   formatErrorMessage,
+  formatStructuredError,
   formatValidationErrors,
   getAppEnvEncryptPubKey,
   getAvailableNodes,
+  getAvailableOsImages,
   getComposeHash,
   getCurrentUser,
   getCvmAttestation,
@@ -3229,14 +3650,17 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   getCvmInfo,
   getCvmList,
   getCvmNetwork,
+  getCvmState,
   getCvmStats,
   getErrorMessage,
   getKmsInfo,
   getKmsList,
   getValidationFields,
   getWorkspace,
-  listInstanceTypes,
+  listAllInstanceTypeFamilies,
+  listFamilyInstanceTypes,
   listWorkspaces,
+  nextAppIds,
   parseApiError,
   parseEnv,
   parseEnvVars,
@@ -3252,6 +3676,7 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   safeDeployAppAuth,
   safeGetAppEnvEncryptPubKey,
   safeGetAvailableNodes,
+  safeGetAvailableOsImages,
   safeGetCurrentUser,
   safeGetCvmAttestation,
   safeGetCvmComposeFile,
@@ -3260,12 +3685,15 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   safeGetCvmInfo,
   safeGetCvmList,
   safeGetCvmNetwork,
+  safeGetCvmState,
   safeGetCvmStats,
   safeGetKmsInfo,
   safeGetKmsList,
   safeGetWorkspace,
-  safeListInstanceTypes,
+  safeListAllInstanceTypeFamilies,
+  safeListFamilyInstanceTypes,
   safeListWorkspaces,
+  safeNextAppIds,
   safeProvisionCvm,
   safeProvisionCvmComposeFileUpdate,
   safeRestartCvm,
@@ -3274,6 +3702,7 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   safeStopCvm,
   safeUpdateCvmResources,
   safeUpdateCvmVisibility,
+  safeUpdateOsImage,
   safeValidateActionParameters,
   shutdownCvm,
   sortObject,
@@ -3282,9 +3711,11 @@ var import_verify_env_encrypt_public_key = require("@phala/dstack-sdk/verify-env
   switchToNetwork,
   updateCvmResources,
   updateCvmVisibility,
+  updateOsImage,
   validateActionParameters,
   validateNetworkPrerequisites,
   verifyEnvEncryptPublicKey,
   waitForTransactionReceipt,
+  watchCvmState,
   withComposeMethods
 });