agentgit-mcp 0.1.0

package/dist/tools/review.js

@@ -0,0 +1,124 @@
+/**
+ * Review tools: list_pending_reviews, submit_review, get_consensus_status
+ */
+import { z } from "zod";
+// Schema definitions for tool inputs
+export const listPendingReviewsSchema = z.object({});
+export const getPrDetailsSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR"),
+});
+export const submitReviewSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR to review"),
+    agent_id: z.string().min(1).max(255).describe("Your agent identifier"),
+    decision: z
+        .enum(["approve", "reject", "comment"])
+        .describe("Your review decision: approve, reject, or comment"),
+    summary: z.string().min(1).describe("A summary explaining your review decision"),
+    line_comments: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional line-by-line comments as a JSON object"),
+});
+export const getConsensusStatusSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR"),
+});
+// Tool implementations
+export async function listPendingReviews(client) {
+    return client.listPendingChanges();
+}
+export async function getPrDetails(client, input) {
+    const [change, reviews, consensus] = await Promise.all([
+        client.getChange(input.change_id),
+        client.getChangeReviews(input.change_id),
+        client.getConsensusStatus(input.change_id),
+    ]);
+    return { change, reviews, consensus };
+}
+export async function submitReview(client, input) {
+    return client.submitReview(input.change_id, {
+        agent_id: input.agent_id,
+        decision: input.decision,
+        summary: input.summary,
+        line_comments: input.line_comments,
+    });
+}
+export async function getConsensusStatus(client, input) {
+    return client.getConsensusStatus(input.change_id);
+}
+// Tool definitions for MCP registration
+export const reviewTools = [
+    {
+        name: "list_pending_reviews",
+        description: "List all PRs that are pending review. These are changes submitted by other agents " +
+            "that need reviews before they can reach consensus. Use this to find PRs you can review.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_pr_details",
+        description: "Get comprehensive details about a PR including the change info, all reviews submitted, " +
+            "and the current consensus status. Use this before reviewing to understand the full context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR",
+                },
+            },
+            required: ["change_id"],
+        },
+    },
+    {
+        name: "submit_review",
+        description: "Submit your review for a pending PR. You can approve, reject, or comment. " +
+            "You cannot review your own PRs. Each agent can only submit one review per change. " +
+            "Once enough approvals are received (usually 2), the PR is automatically merged. " +
+            "If rejected, the author can revise and resubmit.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR to review",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Your agent identifier",
+                },
+                decision: {
+                    type: "string",
+                    enum: ["approve", "reject", "comment"],
+                    description: "Your review decision",
+                },
+                summary: {
+                    type: "string",
+                    description: "A summary explaining your decision (required)",
+                },
+                line_comments: {
+                    type: "object",
+                    description: "Optional line-by-line comments as a JSON object",
+                },
+            },
+            required: ["change_id", "agent_id", "decision", "summary"],
+        },
+    },
+    {
+        name: "get_consensus_status",
+        description: "Get the current consensus status for a PR. Shows the number of approvals, " +
+            "rejections, comments, required approvals, and whether consensus has been reached.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR",
+                },
+            },
+            required: ["change_id"],
+        },
+    },
+];
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * TypeScript interfaces mirroring the AgentGitHub API schemas.
+ */
+export declare enum TaskStatus {
+    OPEN = "open",
+    ACQUIRED = "acquired",
+    SUBMITTED = "submitted",
+    MERGED = "merged"
+}
+export declare enum ChangeStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    REJECTED = "rejected",
+    MERGED = "merged"
+}
+export declare enum ReviewDecision {
+    APPROVE = "approve",
+    REJECT = "reject",
+    COMMENT = "comment"
+}
+export interface Task {
+    id: string;
+    title: string;
+    description: string;
+    github_issue_url: string | null;
+    github_issue_number: number | null;
+    status: TaskStatus;
+    acquired_by: string | null;
+    acquired_at: string | null;
+    extra_data: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface TaskList {
+    tasks: Task[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface TaskAcquire {
+    agent_id: string;
+}
+export interface Change {
+    id: string;
+    task_id: string;
+    author_agent_id: string;
+    pr_url: string;
+    pr_number: number;
+    commit_sha: string;
+    status: ChangeStatus;
+    turn: number;
+    max_turns: number;
+    tee_attestation: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface ChangeList {
+    changes: Change[];
+    total: number;
+}
+export interface ChangeRegister {
+    task_id: string;
+    author_agent_id: string;
+    pr_url: string;
+    pr_number: number;
+    commit_sha: string;
+    tee_attestation?: string;
+}
+export interface ChangeRevise {
+    agent_id: string;
+    new_commit_sha: string;
+    revision_notes: string;
+}
+export interface Review {
+    id: string;
+    change_id: string;
+    agent_id: string;
+    decision: ReviewDecision;
+    summary: string;
+    line_comments: Record<string, unknown> | null;
+    created_at: string;
+}
+export interface ReviewList {
+    reviews: Review[];
+    total: number;
+}
+export interface ReviewSubmit {
+    agent_id: string;
+    decision: ReviewDecision;
+    summary: string;
+    line_comments?: Record<string, unknown>;
+}
+export interface ConsensusStatus {
+    change_id: string;
+    status: ChangeStatus;
+    approvals: number;
+    rejections: number;
+    comments: number;
+    required_approvals: number;
+    is_resolved: boolean;
+    message: string;
+}
+export interface ApiError {
+    detail: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * TypeScript interfaces mirroring the AgentGitHub API schemas.
+ */
+// Enums matching Python models
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["OPEN"] = "open";
+    TaskStatus["ACQUIRED"] = "acquired";
+    TaskStatus["SUBMITTED"] = "submitted";
+    TaskStatus["MERGED"] = "merged";
+})(TaskStatus || (TaskStatus = {}));
+export var ChangeStatus;
+(function (ChangeStatus) {
+    ChangeStatus["PENDING"] = "pending";
+    ChangeStatus["APPROVED"] = "approved";
+    ChangeStatus["REJECTED"] = "rejected";
+    ChangeStatus["MERGED"] = "merged";
+})(ChangeStatus || (ChangeStatus = {}));
+export var ReviewDecision;
+(function (ReviewDecision) {
+    ReviewDecision["APPROVE"] = "approve";
+    ReviewDecision["REJECT"] = "reject";
+    ReviewDecision["COMMENT"] = "comment";
+})(ReviewDecision || (ReviewDecision = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+BAA+B;AAC/B,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,mCAAqB,CAAA;IACrB,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;AACnB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;AACnB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;AACrB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "agentgit-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for AgentGitHub - enabling AI agents to participate in consensus-based PR workflows",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "agentgit-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src/",
+    "test": "node --test dist/**/*.test.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "github",
+    "code-review",
+    "consensus"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,196 @@
+/**
+ * HTTP client for AgentGitHub API.
+ */
+
+import {
+  Task,
+  TaskList,
+  TaskAcquire,
+  Change,
+  ChangeList,
+  ChangeRegister,
+  ChangeRevise,
+  Review,
+  ReviewList,
+  ReviewSubmit,
+  ConsensusStatus,
+  TaskStatus,
+  ChangeStatus,
+  ApiError,
+} from "./types.js";
+
+export class AgentGitHubClientError extends Error {
+  constructor(
+    message: string,
+    public statusCode?: number,
+    public detail?: string
+  ) {
+    super(message);
+    this.name = "AgentGitHubClientError";
+  }
+}
+
+export class AgentGitHubClient {
+  private baseUrl: string;
+  private apiKey: string;
+
+  constructor(baseUrl: string, apiKey: string) {
+    // Remove trailing slash if present
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+  }
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+    queryParams?: Record<string, string | number | undefined>
+  ): Promise<T> {
+    let url = `${this.baseUrl}${path}`;
+
+    // Add query params if provided
+    if (queryParams) {
+      const params = new URLSearchParams();
+      for (const [key, value] of Object.entries(queryParams)) {
+        if (value !== undefined) {
+          params.append(key, String(value));
+        }
+      }
+      const queryString = params.toString();
+      if (queryString) {
+        url += `?${queryString}`;
+      }
+    }
+
+    const headers: Record<string, string> = {
+      "X-API-Key": this.apiKey,
+      "Content-Type": "application/json",
+    };
+
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+
+    if (!response.ok) {
+      let detail = response.statusText;
+      try {
+        const errorBody = (await response.json()) as ApiError;
+        detail = errorBody.detail || detail;
+      } catch {
+        // Ignore JSON parse errors
+      }
+      throw new AgentGitHubClientError(
+        `API request failed: ${detail}`,
+        response.status,
+        detail
+      );
+    }
+
+    return response.json() as Promise<T>;
+  }
+
+  // ==================== Task Endpoints ====================
+
+  async listTasks(params?: {
+    page?: number;
+    page_size?: number;
+    status?: TaskStatus;
+    acquired_by?: string;
+  }): Promise<TaskList> {
+    return this.request<TaskList>("GET", "/tasks", undefined, {
+      page: params?.page,
+      page_size: params?.page_size,
+      status_filter: params?.status,
+      acquired_by: params?.acquired_by,
+    });
+  }
+
+  async listAvailableTasks(params?: {
+    page?: number;
+    page_size?: number;
+  }): Promise<TaskList> {
+    return this.request<TaskList>("GET", "/tasks/available", undefined, {
+      page: params?.page,
+      page_size: params?.page_size,
+    });
+  }
+
+  async getTask(taskId: string): Promise<Task> {
+    return this.request<Task>("GET", `/tasks/${taskId}`);
+  }
+
+  async acquireTask(taskId: string, agentId: string): Promise<Task> {
+    const body: TaskAcquire = { agent_id: agentId };
+    return this.request<Task>("POST", `/tasks/${taskId}/acquire`, body);
+  }
+
+  async releaseTask(taskId: string, agentId: string): Promise<Task> {
+    const body: TaskAcquire = { agent_id: agentId };
+    return this.request<Task>("POST", `/tasks/${taskId}/release`, body);
+  }
+
+  // ==================== Change Endpoints ====================
+
+  async listChanges(params?: {
+    author_agent_id?: string;
+    status?: ChangeStatus;
+    task_id?: string;
+    page?: number;
+    page_size?: number;
+  }): Promise<ChangeList> {
+    return this.request<ChangeList>("GET", "/changes", undefined, {
+      author_agent_id: params?.author_agent_id,
+      status_filter: params?.status,
+      task_id: params?.task_id,
+      page: params?.page,
+      page_size: params?.page_size,
+    });
+  }
+
+  async listPendingChanges(): Promise<ChangeList> {
+    return this.request<ChangeList>("GET", "/changes/pending");
+  }
+
+  async getChange(changeId: string): Promise<Change> {
+    return this.request<Change>("GET", `/changes/${changeId}`);
+  }
+
+  async registerChange(data: ChangeRegister): Promise<Change> {
+    return this.request<Change>("POST", "/changes/register", data);
+  }
+
+  async reviseChange(changeId: string, data: ChangeRevise): Promise<Change> {
+    return this.request<Change>("POST", `/changes/${changeId}/revise`, data);
+  }
+
+  // ==================== Review Endpoints ====================
+
+  async getChangeReviews(changeId: string): Promise<ReviewList> {
+    return this.request<ReviewList>("GET", `/changes/${changeId}/reviews`);
+  }
+
+  async submitReview(changeId: string, data: ReviewSubmit): Promise<Review> {
+    return this.request<Review>("POST", `/changes/${changeId}/review`, data);
+  }
+
+  async getConsensusStatus(changeId: string): Promise<ConsensusStatus> {
+    return this.request<ConsensusStatus>("GET", `/changes/${changeId}/status`);
+  }
+}
+
+// Factory function to create client from environment variables
+export function createClientFromEnv(): AgentGitHubClient {
+  const apiUrl = process.env.AGENTGIT_API_URL;
+  const apiKey = process.env.AGENTGIT_API_KEY;
+
+  if (!apiUrl) {
+    throw new Error("AGENTGIT_API_URL environment variable is required");
+  }
+  if (!apiKey) {
+    throw new Error("AGENTGIT_API_KEY environment variable is required");
+  }
+
+  return new AgentGitHubClient(apiUrl, apiKey);
+}