Function devcontainerUp

src/node/runtime/devcontainerCli.ts:209–409

(
  options: DevcontainerUpOptions
)

 * Parses the JSON output to extract container info.
 */
export async function devcontainerUp(
  options: DevcontainerUpOptions
): Promise<DevcontainerUpResult> {
  const {
    workspaceFolder,
    configPath,
    initLogger,
    abortSignal,
    additionalMounts,
    remoteEnv,
    timeoutMs = DEFAULT_UP_TIMEOUT_MS,
  } = options;

  const baseArgs = ["up", "--log-format", "json", "--workspace-folder", workspaceFolder];

  if (configPath) {
    baseArgs.push("--config", configPath);
  }

  // Add mounts for credential sharing
  if (additionalMounts) {
    for (const mount of additionalMounts) {
      // Single formatting point — the devcontainer CLI only accepts type/source/target/external.
      baseArgs.push("--mount", `type=bind,source=${mount.source},target=${mount.target}`);
    }
  }

  // Add remote env vars
  if (remoteEnv) {
    for (const [key, value] of Object.entries(remoteEnv)) {
      baseArgs.push("--remote-env", `${key}=${value}`);
    }
  }

  const runUp = (args: string[]): Promise<DevcontainerUpResult> => {
    const logArgs = redactDevcontainerArgsForLog(args);
    initLogger.logStep(`Running: devcontainer ${logArgs.join(" ")}`);

    return new Promise((resolve, reject) => {
      if (abortSignal?.aborted) {
        reject(new Error("devcontainer up aborted"));
        return;
      }

      const proc = spawn("devcontainer", args, {
        stdio: ["ignore", "pipe", "pipe"],
        timeout: timeoutMs,
        cwd: workspaceFolder,
      });

      let settled = false;
      let lastResultLine: DevcontainerUpResultLine | null = null;
      let stderrBuffer = "";
      let timeoutId: ReturnType<typeof setTimeout> | undefined;

      const settleSuccess = (result: DevcontainerUpResult) => {
        if (settled) return;
        settled = true;