Method runCommand

src/integrations/terminal/Terminal.ts:81–146

(command: string, callbacks: RooTerminalCallbacks)

	}

	public override runCommand(command: string, callbacks: RooTerminalCallbacks): RooTerminalProcessResultPromise {
		// We set busy before the command is running because the terminal may be
		// waiting on terminal integration, and we must prevent another instance
		// from selecting the terminal for use during that time.
		this.busy = true

		const process = new TerminalProcess(this)
		process.command = command
		this.process = process

		// Set up event handlers from callbacks before starting process.
		// This ensures that we don't miss any events because they are
		// configured before the process starts.
		process.on("line", (line) => callbacks.onLine(line, process))
		process.once("completed", (output) => callbacks.onCompleted(output, process))
		process.once("shell_execution_started", (pid) => callbacks.onShellExecutionStarted(pid, process))
		process.once("shell_execution_complete", (details) => callbacks.onShellExecutionComplete(details, process))
		process.once("no_shell_integration", (details) => callbacks.onNoShellIntegration?.(details, process))

		const promise = new Promise<void>((resolve, reject) => {
			// Set up event handlers
			process.once("continue", () => resolve())
			process.once("error", (error) => {
				console.error(`[Terminal ${this.id}] error:`, error)
				reject(error)
			})

			if (Terminal.isActiveShellCmdExe()) {
				// Keep this defensive fallback for callers that invoke Terminal.runCommand()
				// directly instead of routing through executeCommandInTerminal().
				// cmd.exe cannot emit OSC 633;A — skip the timeout entirely and go
				// straight to the execa fallback (VS Code issue #164646).
				ShellIntegrationManager.zshCleanupTmpDir(this.id)
				process.emit("no_shell_integration", {
					message:
						"cmd.exe does not support shell integration (VS Code issue #164646). Command will run via fallback.",
					commandSubmitted: false,
				})
			} else {
				// Wait for shell integration before executing the command
				pWaitFor(() => this.terminal.shellIntegration !== undefined, {
					timeout: Terminal.getShellIntegrationTimeout(),
				})
					.then(() => {
						// Clean up temporary directory if shell integration is available, zsh did its job:
						ShellIntegrationManager.zshCleanupTmpDir(this.id)

						// Run the command in the terminal
						process.run(command)
					})
					.catch(() => {
						console.log(`[Terminal ${this.id}] Shell integration not available. Command execution aborted.`)

						// Clean up temporary directory if shell integration is not available
						ShellIntegrationManager.zshCleanupTmpDir(this.id)

						process.emit("no_shell_integration", {
							message: `Shell integration initialization sequence '\\x1b]633;A' was not received within ${Terminal.getShellIntegrationTimeout() / 1000}s. Shell integration has been disabled for this terminal instance. Increase the timeout in the settings if necessary.`,