feat(webapp): use background flag for shadow mode template creation

Author: nicktrn

apps/webapp/app/v3/services/computeTemplateCreation.server.ts

@@ -62,7 +62,10 @@ export class ComputeTemplateCreationService {
     return "skip";
   }
 
-  async createTemplate(imageReference: string): Promise<{ success: boolean; error?: string }> {
+  async createTemplate(
+    imageReference: string,
+    options?: { background?: boolean }
+  ): Promise<{ success: boolean; error?: string }> {
     if (!this.client) {
       return { success: false, error: "Compute gateway not configured" };
     }
@@ -72,6 +75,7 @@ export class ComputeTemplateCreationService {
         image: imageReference,
         cpu: 0.5,
         memory_mb: 512,
+        background: options?.background,
       });
       return { success: true };
     } catch (error) {
@@ -83,20 +87,4 @@ export class ComputeTemplateCreationService {
       return { success: false, error: message };
     }
   }
-
-  /**
-   * Fire-and-forget template creation. No HTTP connection held open,
-   * no response awaited. Used for shadow rollout mode.
-   */
-  createTemplateBackground(imageReference: string): void {
-    if (!this.client) {
-      return;
-    }
-
-    this.client.createTemplateBackground({
-      image: imageReference,
-      cpu: 0.5,
-      memory_mb: 512,
-    });
-  }
 }

apps/webapp/app/v3/services/finalizeDeployment.server.ts

@@ -191,11 +191,13 @@ export class FinalizeDeploymentService extends BaseService {
 
     // Shadow mode: fire-and-forget template creation after deploy is finalized
     if (templateMode === "shadow" && deployment.imageReference) {
-      logger.debug("Shadow compute template creation (background)", {
-        id,
-        imageReference: deployment.imageReference,
+      templateService.createTemplate(deployment.imageReference, { background: true }).catch((error) => {
+        logger.error("Shadow compute template creation failed", {
+          id,
+          imageReference: deployment.imageReference,
+          error: error instanceof Error ? error.message : String(error),
+        });
       });
-      templateService.createTemplateBackground(deployment.imageReference);
     }
 
     return finalizedDeployment;

apps/webapp/app/v3/services/finalizeDeploymentV2.server.ts

@@ -241,11 +241,13 @@ export class FinalizeDeploymentV2Service extends BaseService {
     imageReference: string,
     deploymentFriendlyId: string
   ) {
-    logger.debug("Shadow compute template creation (background)", {
-      id: deploymentFriendlyId,
-      imageReference,
+    templateService.createTemplate(imageReference, { background: true }).catch((error) => {
+      logger.error("Shadow compute template creation failed", {
+        id: deploymentFriendlyId,
+        imageReference,
+        error: error instanceof Error ? error.message : String(error),
+      });
     });
-    templateService.createTemplateBackground(imageReference);
   }
 }
 

internal-packages/compute/src/types.ts

@@ -4,6 +4,7 @@ export const TemplateCreateRequestSchema = z.object({
   image: z.string(),
   cpu: z.number(),
   memory_mb: z.number(),
+  background: z.boolean().optional(),
   callback: z
     .object({
       url: z.string(),