Method exec

src/node/runtime/DevcontainerRuntime.ts:588–713

* Execute a command inside the devcontainer. * Overrides LocalBaseRuntime.exec() to use `devcontainer exec`.

(command: string, options: ExecOptions)

   * Overrides LocalBaseRuntime.exec() to use `devcontainer exec`.
   */
  override exec(command: string, options: ExecOptions): Promise<ExecStream> {
    const startTime = performance.now();

    // Short-circuit if already aborted
    if (options.abortSignal?.aborted) {
      throw new RuntimeError("Operation aborted before execution", "exec");
    }

    // Build devcontainer exec args
    const workspaceFolder = this.currentWorkspacePath;
    if (!workspaceFolder) {
      throw new RuntimeError("Devcontainer not initialized. Call ensureReady() first.", "exec");
    }

    const args = ["exec", "--workspace-folder", workspaceFolder];

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

    // Merge cached container credential env + caller env + non-interactive vars.
    // Spread order: container env (lowest) < caller env < NON_INTERACTIVE (highest).
    const envVars = { ...this.containerEnv, ...options.env, ...NON_INTERACTIVE_ENV_VARS };
    for (const [key, value] of Object.entries(envVars)) {
      args.push("--remote-env", `${key}=${value}`);
    }

    // Build the full command with cd
    // Map host workspace path to container path; fall back to container workspace if unmappable
    const mappedCwd = options.cwd ? this.mapHostPathToContainer(options.cwd) : null;
    const cwd = mappedCwd ?? this.resolveContainerCwd(options.cwd, workspaceFolder);
    const fullCommand = `cd ${shescape.quote(cwd)} && ${command}`;
    args.push("--", "bash", "-c", fullCommand);

    const childProcess = spawn("devcontainer", args, {
      stdio: ["pipe", "pipe", "pipe"],
      detached: true,
      windowsHide: true,
      cwd: workspaceFolder,
    });

    const disposable = new DisposableProcess(childProcess);

    // Register cleanup to kill process tree and force-close stdio on timeout/abort.
    disposable.addCleanup(() => {
      if (childProcess.pid === undefined) return;
      killProcessTree(childProcess.pid);
      forceCloseStdio(childProcess);
    });

    // Convert Node.js streams to Web Streams (casts required for ExecStream compatibility)
    /* eslint-disable @typescript-eslint/no-unnecessary-type-assertion */
    const stdout = Readable.toWeb(childProcess.stdout!) as unknown as ReadableStream<Uint8Array>;
    const stderr = Readable.toWeb(childProcess.stderr!) as unknown as ReadableStream<Uint8Array>;
    const stdin = Writable.toWeb(childProcess.stdin!) as unknown as WritableStream<Uint8Array>;
    /* eslint-enable @typescript-eslint/no-unnecessary-type-assertion */

    let timedOut = false;