Method deleteWorkspaceEventually

src/node/services/coderService.ts:1388–1511

* Delete a Coder workspace, retrying across transient build states. * * This is used for "cancel creation" because aborting the local `coder create` * process does not guarantee the control-plane build is canceled.

(
    name: string,
    options?: {
      timeoutMs?: number;
      signal?: AbortSignal;
      /**
       * If true, treat an initial "not found" as inconclusive and keep polling.
       * This avoids races where `coder create` finishes server-side after mux aborts the CLI.
       */
      waitForExistence?: boolean;
      /**
       * When `waitForExistence` is true: if we only see "not found" for this many ms
       * without ever observing the workspace exist, treat it as success and return early.
       * Defaults to `timeoutMs` (no separate short-circuit).
       */
      waitForExistenceTimeoutMs?: number;
    }
  )

   * process does not guarantee the control-plane build is canceled.
   */
  async deleteWorkspaceEventually(
    name: string,
    options?: {
      timeoutMs?: number;
      signal?: AbortSignal;
      /**
       * If true, treat an initial "not found" as inconclusive and keep polling.
       * This avoids races where `coder create` finishes server-side after mux aborts the CLI.
       */
      waitForExistence?: boolean;
      /**
       * When `waitForExistence` is true: if we only see "not found" for this many ms
       * without ever observing the workspace exist, treat it as success and return early.
       * Defaults to `timeoutMs` (no separate short-circuit).
       */
      waitForExistenceTimeoutMs?: number;
    }
  ): Promise<Result<void>> {
    const timeoutMs = options?.timeoutMs ?? 60_000;
    const startTime = Date.now();

    // Safety: never delete Coder workspaces mux didn't create.
    // Mux-created workspaces always use the mux- prefix.
    if (!name.startsWith("mux-")) {
      log.warn("Refusing to delete Coder workspace without mux- prefix", { name });
      return Ok(undefined);
    }

    const isTimedOut = () => Date.now() - startTime > timeoutMs;
    const remainingMs = () => Math.max(0, timeoutMs - (Date.now() - startTime));

    const unstableStates = new Set<CoderWorkspaceStatus>([
      "starting",
      "pending",
      "stopping",
      "canceling",
    ]);

    let sawWorkspaceExist = false;
    let lastError: string | undefined;
    let attempt = 0;

    while (!isTimedOut()) {
      if (options?.signal?.aborted) {
        return Err("Delete operation aborted");
      }

      const statusResult = await this.getWorkspaceStatus(name, {
        timeoutMs: Math.min(remainingMs(), 10_000),
        signal: options?.signal,
      });

      if (statusResult.kind === "ok") {
        sawWorkspaceExist = true;

        if (statusResult.status === "deleted" || statusResult.status === "deleting") {
          return Ok(undefined);
        }