Method createWorkspace

src/node/services/coderService.ts:1279–1358

* Create a new Coder workspace. Yields build log lines as they arrive. * * Pre-fetches template parameters and passes defaults via --parameter flags * to avoid interactive prompts during creation. * * @param name Workspace name * @param template Template name * @param preset Opt

(
    name: string,
    template: string,
    preset?: string,
    abortSignal?: AbortSignal,
    org?: string,
    session?: CoderApiSession
  )

   * @param session Optional API session to reuse across deployment endpoints
   */
  async *createWorkspace(
    name: string,
    template: string,
    preset?: string,
    abortSignal?: AbortSignal,
    org?: string,
    session?: CoderApiSession
  ): AsyncGenerator<string, void, unknown> {
    log.debug("Creating Coder workspace", { name, template, preset, org });

    if (abortSignal?.aborted) {
      throw new Error("Coder workspace creation aborted");
    }

    // 1. Get deployment URL
    const deploymentUrl = await this.getDeploymentUrl(abortSignal);

    if (abortSignal?.aborted) {
      throw new Error("Coder workspace creation aborted");
    }

    // 2. Get active template version ID
    const versionId = await this.getActiveTemplateVersionId(template, org, abortSignal);

    if (abortSignal?.aborted) {
      throw new Error("Coder workspace creation aborted");
    }

    // 3. Get parameter names covered by preset (if any)
    const coveredByPreset = preset
      ? await this.getPresetParamNames(template, preset, org, abortSignal)
      : new Set<string>();

    if (abortSignal?.aborted) {
      throw new Error("Coder workspace creation aborted");
    }

    // 4. Fetch all template parameters from API
    const allParams = await this.getTemplateRichParameters(
      deploymentUrl,
      versionId,
      name,
      session,
      abortSignal
    );

    // 5. Validate required params have values
    this.validateRequiredParams(allParams, coveredByPreset);

    // 6. Compute extra --parameter flags for non-ephemeral params not in preset
    const extraParams = this.computeExtraParams(allParams, coveredByPreset);

    log.debug("Computed extra params for coder create", {
      name,
      template,
      preset,
      org,
      extraParamCount: extraParams.length,