kodegen_tools_github 0.10.4

KODEGEN.ᴀɪ: Memory-efficient, Blazing-Fast, MCP tools for code generation agents.
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

use anyhow;
use kodegen_mcp_schema::{McpError, Tool, ToolExecutionContext, ToolResponse};
use kodegen_mcp_schema::github::{ForkRepositoryArgs, ForkRepositoryPrompts, GITHUB_FORK_REPOSITORY};

use crate::GitHubClient;

/// Tool for forking a repository
pub struct ForkRepositoryTool;

impl Tool for ForkRepositoryTool {
    type Args = ForkRepositoryArgs;
    type Prompts = ForkRepositoryPrompts;

    fn name() -> &'static str {
        GITHUB_FORK_REPOSITORY
    }

    fn description() -> &'static str {
        "Fork a repository to your account or an organization"
    }

    fn read_only() -> bool {
        false
    }

    fn destructive() -> bool {
        false
    }

    fn idempotent() -> bool {
        false
    }

    fn open_world() -> bool {
        true
    }

    async fn execute(&self, args: Self::Args, _ctx: ToolExecutionContext) -> Result<ToolResponse<<Self::Args as kodegen_mcp_schema::ToolArgs>::Output>, McpError> {
        let token = std::env::var("GITHUB_TOKEN").map_err(|_| {
            McpError::Other(anyhow::anyhow!("GITHUB_TOKEN environment variable not set"))
        })?;

        let client = GitHubClient::builder()
            .personal_token(token)
            .build()
            .map_err(|e| McpError::Other(anyhow::anyhow!("Failed to create GitHub client: {e}")))?;

        let task_result = client
            .fork_repository(args.owner.clone(), args.repo.clone(), args.organization.clone())
            .await;

        let api_result =
            task_result.map_err(|e| McpError::Other(anyhow::anyhow!("Task channel error: {e}")))?;

        let repository =
            api_result.map_err(|e| McpError::Other(anyhow::anyhow!("GitHub API error: {e}")))?;

        // Extract forked repository details
        let forked_owner = repository.owner.as_ref()
            .map(|o| o.login.clone())
            .unwrap_or_default();

        let forked_name = repository.name.clone();

        let forked_full_name = repository.full_name
            .as_deref()
            .unwrap_or_default()
            .to_string();

        let html_url = repository.html_url.as_ref()
            .map(|u| u.to_string())
            .unwrap_or_default();

        // Build typed output
        let output = kodegen_mcp_schema::github::GitHubForkRepoOutput {
            success: true,
            source_owner: args.owner.clone(),
            source_repo: args.repo.clone(),
            forked_owner: forked_owner.clone(),
            forked_name: forked_name.clone(),
            forked_full_name: forked_full_name.clone(),
            html_url: html_url.clone(),
            message: format!("Forked {}/{} successfully", args.owner, args.repo),
        };

        // Build human-readable display
        let display = format!(
            "🍴 Repository Forked\n\n\
             Source: {}/{}\n\
             Forked To: {}\n\
             URL: {}",
            output.source_owner, output.source_repo, output.forked_full_name, output.html_url
        );

        // Return ToolResponse wrapper
        Ok(ToolResponse::new(display, output))
    }
}