kwaak 0.8.2

Run a team of autonomous agents on your code, right from your terminal
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Series of commands to run before each agent starts inside the docker container

use anyhow::Result;
use secrecy::ExposeSecret;
use swiftide::traits::Command;
use swiftide::traits::ToolExecutor;

use crate::config::SupportedToolExecutors;
use crate::git::github::GithubSession;
use crate::repository::Repository;

/// Configures and sets up a git (and github if enabled) environment for the agent to run in
pub struct EnvSetup<'a> {
    repository: &'a Repository,
    github_session: Option<&'a GithubSession>,
    executor: &'a dyn ToolExecutor,
}

/// Returned after setting up the environment
#[derive(Default, Debug, Clone)]
pub struct AgentEnvironment {
    #[allow(dead_code)]
    pub branch_name: String,
    pub start_ref: String,
    pub remote_enabled: bool,
}

impl EnvSetup<'_> {
    pub fn new<'a>(
        repository: &'a Repository,
        github_session: Option<&'a GithubSession>,
        executor: &'a dyn ToolExecutor,
    ) -> EnvSetup<'a> {
        EnvSetup {
            repository,
            github_session,
            executor,
        }
    }

    #[tracing::instrument(skip_all, err)]
    pub async fn exec_setup_commands(&self, branch_name: String) -> Result<AgentEnvironment> {
        // Only run these commands if we are running inside a docker container
        if self.repository.config().tool_executor != SupportedToolExecutors::Docker {
            return Ok(AgentEnvironment {
                branch_name: self.get_current_branch().await?,
                start_ref: self.get_current_ref().await?,
                remote_enabled: false,
            });
        }

        let mut remote_enabled = true;
        if let Err(e) = self.setup_github_auth().await {
            tracing::warn!(error = ?e, "Failed to setup github auth");
            remote_enabled = false;
        }

        self.configure_git_user().await?;
        self.switch_to_work_branch(branch_name).await?;

        Ok(AgentEnvironment {
            branch_name: self.get_current_branch().await?,
            start_ref: self.get_current_ref().await?,
            remote_enabled,
        })
    }

    async fn setup_github_auth(&self) -> Result<()> {
        let Some(github_session) = self.github_session else {
            anyhow::bail!("Github session is required to setup github auth");
        };

        let Ok(origin_url) = self
            .executor
            .exec_cmd(&Command::shell("git remote get-url origin"))
            .await
            .map(|t| t.output)
        else {
            anyhow::bail!("Could not get origin url; does the repository have a remote of origin enabled? Github integration will be disabled");
        };

        let url_with_token = github_session.add_token_to_url(&origin_url)?;

        let cmd = Command::shell(format!(
            "git remote set-url origin {}",
            url_with_token.expose_secret()
        ));
        self.executor.exec_cmd(&cmd).await?;

        Ok(())
    }

    async fn configure_git_user(&self) -> Result<()> {
        for cmd in &[
            Command::shell("git config --global user.email \"kwaak@bosun.ai\""),
            Command::shell("git config --global user.name \"kwaak\""),
            Command::shell("git config --global push.autoSetupRemote true"),
        ] {
            self.executor.exec_cmd(cmd).await?;
        }

        Ok(())
    }

    async fn switch_to_work_branch(&self, branch_name: String) -> Result<()> {
        let cmd = Command::Shell(format!("git checkout -b {branch_name}"));
        self.executor.exec_cmd(&cmd).await?;
        Ok(())
    }

    async fn get_current_ref(&self) -> Result<String> {
        let cmd = Command::shell("git rev-parse HEAD");
        let output = self.executor.exec_cmd(&cmd).await?;
        tracing::debug!("agent starting from ref: {}", output.output.trim());
        Ok(output.output.trim().to_string())
    }

    async fn get_current_branch(&self) -> Result<String> {
        let cmd = Command::shell("git rev-parse --abbrev-ref HEAD");
        let output = self.executor.exec_cmd(&cmd).await?;
        tracing::debug!("agent starting from branch: {}", output.output.trim());
        Ok(output.output.trim().to_string())
    }
}