Method executeBash

src/node/services/workspaceService.ts:8544–8752

(
    workspaceId: string,
    script: string,
    options?: ExecuteBashOptions,
    command?: string,
    args?: string[]
  )

  }

  async executeBash(
    workspaceId: string,
    script: string,
    options?: ExecuteBashOptions,
    command?: string,
    args?: string[]
  ): Promise<Result<BashToolResult>> {
    // Block bash execution while workspace is being removed to prevent races with directory deletion.
    // A common case: subagent calls agent_report → frontend's GitStatusStore triggers a git status
    // refresh → executeBash arrives while remove() is deleting the directory → spawn fails with ENOENT.
    // removingWorkspaces is set for the entire duration of remove(), covering the window between
    // disk deletion and metadata invalidation.
    if (this.removingWorkspaces.has(workspaceId)) {
      return Err(`Workspace ${workspaceId} is being removed`);
    }

    // NOTE: This guard must run before any init/runtime operations that could wake a stopped SSH
    // runtime (e.g., Coder workspaces started via `coder ssh --wait=yes`).
    if (this.archivingWorkspaces.has(workspaceId)) {
      return Err(`Workspace ${workspaceId} is being archived; cannot execute bash`);
    }

    const metadataResult = await this.aiService.getWorkspaceMetadata(workspaceId);
    if (!metadataResult.success) {
      return Err(`Failed to get workspace metadata: ${metadataResult.error}`);
    }

    const metadata = metadataResult.data;
    if (isWorkspaceArchived(metadata.archivedAt, metadata.unarchivedAt)) {
      return Err(`Workspace ${workspaceId} is archived; cannot execute bash`);
    }

    // Wait for workspace initialization (container creation, code sync, etc.)
    // Same behavior as AI tools - 5 min timeout, then proceeds anyway
    await this.initStateManager.waitForInit(workspaceId);

    try {
      // Get the persisted workspace entry from config. Multi-project git command mode needs the
      // workspace checkout path rather than metadata.projectPath, and other path-addressable
      // runtimes also reuse the persisted workspace root shown in the Explorer.
      const workspace = this.config.findWorkspace(workspaceId);
      if (!workspace) {
        return Err(`Workspace ${workspaceId} not found in config`);
      }

      const multiProjectRuntimes = isMultiProject(metadata)
        ? getProjects(metadata).map((project) => ({
            projectPath: project.projectPath,
            projectName: project.projectName,
            runtime: createRuntime(metadata.runtimeConfig, {
              projectPath: project.projectPath,
              workspaceName: metadata.name,
              workspacePath: isSSHRuntime(metadata.runtimeConfig)
                ? getWorkspacePathHintForProject(
                    {
                      workspaceId,
                      workspaceName: metadata.name,
                      workspacePath: workspace.workspacePath,