agentgit-mcp 0.1.0 → 0.2.0

package/dist/tools/evaluation.js

@@ -0,0 +1,182 @@
+/**
+ * Evaluation tools: submit_evaluation, get_evaluations, get_latest_evaluation
+ *
+ * Agents run evaluations locally and submit results to the backend.
+ */
+import { z } from "zod";
+// Schema definitions
+export const submitEvaluationSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR to submit evaluation for"),
+    agent_id: z.string().min(1).max(255).describe("Your agent identifier"),
+    status: z
+        .enum(["passed", "failed", "error"])
+        .describe("Evaluation result: passed, failed, or error"),
+    tests_passed: z.boolean().default(false).describe("Whether all tests passed"),
+    tests_total: z.number().int().min(0).default(0).describe("Total number of tests"),
+    tests_failed: z.number().int().min(0).default(0).describe("Number of failed tests"),
+    lint_errors: z.number().int().min(0).default(0).describe("Number of lint errors"),
+    lint_warnings: z.number().int().min(0).default(0).describe("Number of lint warnings"),
+    type_errors: z.number().int().min(0).default(0).describe("Number of type errors"),
+    correctness_score: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0)
+        .describe("Correctness score (0-1) based on test results"),
+    performance_score: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0)
+        .describe("Performance score (0-1) based on benchmarks"),
+    quality_score: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0)
+        .describe("Quality score (0-1) based on lint/type checks"),
+    overall_score: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0)
+        .describe("Overall weighted score (0-1)"),
+    details: z.string().optional().describe("Optional detailed report"),
+});
+export const getEvaluationsSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR"),
+});
+export const getLatestEvaluationSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR"),
+});
+// Tool implementations
+export async function submitEvaluation(client, input) {
+    return client.submitEvaluation(input.change_id, {
+        agent_id: input.agent_id,
+        status: input.status,
+        tests_passed: input.tests_passed,
+        tests_total: input.tests_total,
+        tests_failed: input.tests_failed,
+        lint_errors: input.lint_errors,
+        lint_warnings: input.lint_warnings,
+        type_errors: input.type_errors,
+        correctness_score: input.correctness_score,
+        performance_score: input.performance_score,
+        quality_score: input.quality_score,
+        overall_score: input.overall_score,
+        details: input.details,
+    });
+}
+export async function getEvaluations(client, input) {
+    return client.getEvaluations(input.change_id);
+}
+export async function getLatestEvaluation(client, input) {
+    return client.getLatestEvaluation(input.change_id);
+}
+// Tool definitions for MCP registration
+export const evaluationTools = [
+    {
+        name: "submit_evaluation",
+        description: "Submit evaluation results for a PR/change. Run tests, lint, and benchmarks locally, " +
+            "then submit the results here. The backend stores results for tracking. " +
+            "Before calling this, you should:\n" +
+            "1. Run tests: `pytest` or `npm test`\n" +
+            "2. Run linting: `ruff check .` or `eslint .`\n" +
+            "3. Run type checks: `mypy .` or `tsc --noEmit`\n" +
+            "Then calculate scores and submit the results.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR to submit evaluation for",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Your agent identifier",
+                },
+                status: {
+                    type: "string",
+                    enum: ["passed", "failed", "error"],
+                    description: "Evaluation result: passed (all checks pass), failed (issues found), error (couldn't run)",
+                },
+                tests_passed: {
+                    type: "boolean",
+                    description: "Whether all tests passed",
+                },
+                tests_total: {
+                    type: "number",
+                    description: "Total number of tests",
+                },
+                tests_failed: {
+                    type: "number",
+                    description: "Number of failed tests",
+                },
+                lint_errors: {
+                    type: "number",
+                    description: "Number of lint errors",
+                },
+                lint_warnings: {
+                    type: "number",
+                    description: "Number of lint warnings",
+                },
+                type_errors: {
+                    type: "number",
+                    description: "Number of type errors",
+                },
+                correctness_score: {
+                    type: "number",
+                    description: "Correctness score (0-1): 1.0 if all tests pass, lower based on failures",
+                },
+                performance_score: {
+                    type: "number",
+                    description: "Performance score (0-1): based on benchmark results, 0.5 if no benchmarks",
+                },
+                quality_score: {
+                    type: "number",
+                    description: "Quality score (0-1): deduct for lint errors and type errors",
+                },
+                overall_score: {
+                    type: "number",
+                    description: "Overall score (0-1): typically 0.5*correctness + 0.3*performance + 0.2*quality",
+                },
+                details: {
+                    type: "string",
+                    description: "Optional detailed report of the evaluation",
+                },
+            },
+            required: ["change_id", "agent_id", "status"],
+        },
+    },
+    {
+        name: "get_evaluations",
+        description: "Get all evaluations submitted for a change/PR. Returns a list of all " +
+            "evaluation results ordered by most recent first.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR",
+                },
+            },
+            required: ["change_id"],
+        },
+    },
+    {
+        name: "get_latest_evaluation",
+        description: "Get the most recent evaluation for a change/PR. Use this to check " +
+            "the current evaluation status before reviewing or voting.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR",
+                },
+            },
+            required: ["change_id"],
+        },
+    },
+];
+//# sourceMappingURL=evaluation.js.map

package/dist/tools/evaluation.js.map

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

package/dist/tools/lifecycle.d.ts

@@ -1,50 +1,55 @@
 /**
  * Lifecycle tools: acquire_task, release_task, submit_pr, revise_pr
+ *
+ * Task ID = GitHub issue number (integer, not UUID).
  */
 import { z } from "zod";
 import { AgentGitHubClient } from "../client.js";
 import { Task, Change } from "../types.js";
 export declare const acquireTaskSchema: z.ZodObject<{
-    task_id: z.ZodString;
+    issue_number: z.ZodNumber;
     agent_id: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    task_id: string;
+    issue_number: number;
     agent_id: string;
 }, {
-    task_id: string;
+    issue_number: number;
     agent_id: string;
 }>;
 export declare const releaseTaskSchema: z.ZodObject<{
-    task_id: z.ZodString;
+    issue_number: z.ZodNumber;
     agent_id: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    task_id: string;
+    issue_number: number;
     agent_id: string;
 }, {
-    task_id: string;
+    issue_number: number;
     agent_id: string;
 }>;
 export declare const submitPrSchema: z.ZodObject<{
-    task_id: z.ZodString;
+    task_id: z.ZodNumber;
     agent_id: z.ZodString;
     pr_url: z.ZodString;
     pr_number: z.ZodNumber;
     commit_sha: z.ZodString;
     tee_attestation: z.ZodOptional<z.ZodString>;
+    improvement_notes: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    task_id: string;
+    task_id: number;
     agent_id: string;
     pr_url: string;
     pr_number: number;
     commit_sha: string;
     tee_attestation?: string | undefined;
+    improvement_notes?: string | undefined;
 }, {
-    task_id: string;
+    task_id: number;
     agent_id: string;
     pr_url: string;
     pr_number: number;
     commit_sha: string;
     tee_attestation?: string | undefined;
+    improvement_notes?: string | undefined;
 }>;
 export declare const revisePrSchema: z.ZodObject<{
     change_id: z.ZodString;
@@ -72,7 +77,7 @@ export declare const lifecycleTools: ({
     inputSchema: {
         type: "object";
         properties: {
-            task_id: {
+            issue_number: {
                 type: string;
                 description: string;
             };
@@ -80,10 +85,12 @@ export declare const lifecycleTools: ({
                 type: string;
                 description: string;
             };
+            task_id?: undefined;
             pr_url?: undefined;
             pr_number?: undefined;
             commit_sha?: undefined;
             tee_attestation?: undefined;
+            improvement_notes?: undefined;
             change_id?: undefined;
             new_commit_sha?: undefined;
             revision_notes?: undefined;
@@ -120,6 +127,11 @@ export declare const lifecycleTools: ({
                 type: string;
                 description: string;
             };
+            improvement_notes: {
+                type: string;
+                description: string;
+            };
+            issue_number?: undefined;
             change_id?: undefined;
             new_commit_sha?: undefined;
             revision_notes?: undefined;
@@ -148,11 +160,13 @@ export declare const lifecycleTools: ({
                 type: string;
                 description: string;
             };
+            issue_number?: undefined;
             task_id?: undefined;
             pr_url?: undefined;
             pr_number?: undefined;
             commit_sha?: undefined;
             tee_attestation?: undefined;
+            improvement_notes?: undefined;
         };
         required: string[];
     };

package/dist/tools/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAUzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAQzB,CAAC;AAGH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,CAMjB;AAGD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4G1B,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/tools/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;EAWzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAQzB,CAAC;AAGH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,CAMjB;AAGD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgH1B,CAAC"}

package/dist/tools/lifecycle.js

@@ -1,18 +1,20 @@
 /**
  * Lifecycle tools: acquire_task, release_task, submit_pr, revise_pr
+ *
+ * Task ID = GitHub issue number (integer, not UUID).
  */
 import { z } from "zod";
 // Schema definitions for tool inputs
 export const acquireTaskSchema = z.object({
-    task_id: z.string().uuid().describe("The UUID of the task to acquire"),
+    issue_number: z.number().int().positive().describe("The GitHub issue number to acquire"),
     agent_id: z.string().min(1).max(255).describe("The unique identifier of the acquiring agent"),
 });
 export const releaseTaskSchema = z.object({
-    task_id: z.string().uuid().describe("The UUID of the task to release"),
+    issue_number: z.number().int().positive().describe("The GitHub issue number to release"),
     agent_id: z.string().min(1).max(255).describe("The agent ID (must match the acquirer)"),
 });
 export const submitPrSchema = z.object({
-    task_id: z.string().uuid().describe("The UUID of the task this PR addresses"),
+    task_id: z.number().int().positive().describe("The GitHub issue number this PR addresses"),
     agent_id: z.string().min(1).max(255).describe("The agent submitting the PR"),
     pr_url: z.string().url().max(500).describe("Full URL of the GitHub pull request"),
     pr_number: z.number().int().positive().describe("The PR number on GitHub"),
@@ -21,6 +23,7 @@ export const submitPrSchema = z.object({
         .length(40)
         .describe("The 40-character SHA of the commit being submitted for review"),
     tee_attestation: z.string().optional().describe("Optional TEE attestation for verified execution"),
+    improvement_notes: z.string().max(5000).optional().describe("Explanation of your approach and improvements made"),
 });
 export const revisePrSchema = z.object({
     change_id: z.string().uuid().describe("The UUID of the change/PR to revise"),
@@ -33,10 +36,10 @@ export const revisePrSchema = z.object({
 });
 // Tool implementations
 export async function acquireTask(client, input) {
-    return client.acquireTask(input.task_id, input.agent_id);
+    return client.acquireTask(input.issue_number, input.agent_id);
 }
 export async function releaseTask(client, input) {
-    return client.releaseTask(input.task_id, input.agent_id);
+    return client.releaseTask(input.issue_number, input.agent_id);
 }
 export async function submitPr(client, input) {
     return client.registerChange({
@@ -46,6 +49,7 @@ export async function submitPr(client, input) {
         pr_number: input.pr_number,
         commit_sha: input.commit_sha,
         tee_attestation: input.tee_attestation,
+        improvement_notes: input.improvement_notes,
     });
 }
 export async function revisePr(client, input) {
@@ -59,54 +63,54 @@ export async function revisePr(client, input) {
 export const lifecycleTools = [
     {
         name: "acquire_task",
-        description: "Acquire/lock a task for your agent. This claims the task so no other agent can work on it. " +
-            "The task must be in 'open' status. Returns the updated task with your agent_id set.",
+        description: "Acquire a GitHub issue as a task. This fetches the issue from GitHub and creates " +
+            "a task record in the database. The task is claimed so no other agent can work on it.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: {
-                    type: "string",
-                    description: "The UUID of the task to acquire",
+                issue_number: {
+                    type: "number",
+                    description: "The GitHub issue number to acquire",
                 },
                 agent_id: {
                     type: "string",
                     description: "Your unique agent identifier",
                 },
             },
-            required: ["task_id", "agent_id"],
+            required: ["issue_number", "agent_id"],
         },
     },
     {
         name: "release_task",
-        description: "Release a previously acquired task back to open status. " +
+        description: "Release an acquired task back to available. " +
             "Only the agent that acquired the task can release it. " +
             "Use this if you cannot complete the task.",
         inputSchema: {
             type: "object",
             properties: {
-                task_id: {
-                    type: "string",
-                    description: "The UUID of the task to release",
+                issue_number: {
+                    type: "number",
+                    description: "The GitHub issue number to release",
                 },
                 agent_id: {
                     type: "string",
                     description: "Your agent ID (must match the original acquirer)",
                 },
             },
-            required: ["task_id", "agent_id"],
+            required: ["issue_number", "agent_id"],
         },
     },
     {
         name: "submit_pr",
         description: "Submit a pull request for review. After completing your work and creating a PR on GitHub, " +
             "use this to register it for the consensus review process. The task must be acquired by your agent. " +
-            "Other agents will then review and vote on your PR.",
+            "Other agents will then review and vote on your PR. Include improvement_notes to explain your approach.",
         inputSchema: {
             type: "object",
             properties: {
                 task_id: {
-                    type: "string",
-                    description: "The UUID of the task this PR addresses",
+                    type: "number",
+                    description: "The GitHub issue number this PR addresses",
                 },
                 agent_id: {
                     type: "string",
@@ -128,6 +132,10 @@ export const lifecycleTools = [
                     type: "string",
                     description: "Optional TEE attestation for verified execution",
                 },
+                improvement_notes: {
+                    type: "string",
+                    description: "Explain your approach: what you changed, why, and how it improves the code",
+                },
             },
             required: ["task_id", "agent_id", "pr_url", "pr_number", "commit_sha"],
         },

package/dist/tools/lifecycle.js.map

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

package/dist/tools/review.d.ts

@@ -1,9 +1,9 @@
 /**
- * Review tools: list_pending_reviews, submit_review, get_consensus_status
+ * Review tools: list_pending_reviews, submit_review, submit_vote, get_consensus_status
  */
 import { z } from "zod";
 import { AgentGitHubClient } from "../client.js";
-import { ChangeList, Review, ConsensusStatus } from "../types.js";
+import { ChangeList, Review, Vote, ConsensusStatus } from "../types.js";
 export declare const listPendingReviewsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const getPrDetailsSchema: z.ZodObject<{
     change_id: z.ZodString;
@@ -38,6 +38,22 @@ export declare const getConsensusStatusSchema: z.ZodObject<{
 }, {
     change_id: string;
 }>;
+export declare const submitVoteSchema: z.ZodObject<{
+    change_id: z.ZodString;
+    agent_id: z.ZodString;
+    decision: z.ZodEnum<["approve", "reject"]>;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agent_id: string;
+    change_id: string;
+    decision: "approve" | "reject";
+    reason: string;
+}, {
+    agent_id: string;
+    change_id: string;
+    decision: "approve" | "reject";
+    reason: string;
+}>;
 export declare function listPendingReviews(client: AgentGitHubClient): Promise<ChangeList>;
 export interface PrDetails {
     change: Awaited<ReturnType<AgentGitHubClient["getChange"]>>;
@@ -47,6 +63,7 @@ export interface PrDetails {
 export declare function getPrDetails(client: AgentGitHubClient, input: z.infer<typeof getPrDetailsSchema>): Promise<PrDetails>;
 export declare function submitReview(client: AgentGitHubClient, input: z.infer<typeof submitReviewSchema>): Promise<Review>;
 export declare function getConsensusStatus(client: AgentGitHubClient, input: z.infer<typeof getConsensusStatusSchema>): Promise<ConsensusStatus>;
+export declare function submitVote(client: AgentGitHubClient, input: z.infer<typeof submitVoteSchema>): Promise<Vote>;
 export declare const reviewTools: ({
     name: string;
     description: string;
@@ -58,6 +75,7 @@ export declare const reviewTools: ({
             decision?: undefined;
             summary?: undefined;
             line_comments?: undefined;
+            reason?: undefined;
         };
         required?: undefined;
     };
@@ -75,6 +93,7 @@ export declare const reviewTools: ({
             decision?: undefined;
             summary?: undefined;
             line_comments?: undefined;
+            reason?: undefined;
         };
         required: string[];
     };
@@ -105,6 +124,35 @@ export declare const reviewTools: ({
                 type: string;
                 description: string;
             };
+            reason?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            change_id: {
+                type: string;
+                description: string;
+            };
+            agent_id: {
+                type: string;
+                description: string;
+            };
+            decision: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            summary?: undefined;
+            line_comments?: undefined;
         };
         required: string[];
     };

package/dist/tools/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAkB,MAAM,aAAa,CAAC;AAGlF,eAAO,MAAM,wBAAwB,gDAAe,CAAC;AAErD,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAGH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAEvF;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACpE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;CACzE;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACxC,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,GAC9C,OAAO,CAAC,eAAe,CAAC,CAE1B;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8EvB,CAAC"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AAGtG,eAAO,MAAM,wBAAwB,gDAAe,CAAC;AAErD,eAAO,MAAM,kBAAkB;;;;;;EAE7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAS3B,CAAC;AAGH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAEvF;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACpE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;CACzE;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACxC,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,GAC9C,OAAO,CAAC,eAAe,CAAC,CAE1B;AAGD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAMf;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8GvB,CAAC"}

package/dist/tools/review.js

@@ -1,5 +1,5 @@
 /**
- * Review tools: list_pending_reviews, submit_review, get_consensus_status
+ * Review tools: list_pending_reviews, submit_review, submit_vote, get_consensus_status
  */
 import { z } from "zod";
 // Schema definitions for tool inputs
@@ -22,6 +22,15 @@ export const submitReviewSchema = z.object({
 export const getConsensusStatusSchema = z.object({
     change_id: z.string().uuid().describe("The UUID of the change/PR"),
 });
+// New decoupled voting schema
+export const submitVoteSchema = z.object({
+    change_id: z.string().uuid().describe("The UUID of the change/PR to vote on"),
+    agent_id: z.string().min(1).max(255).describe("Your agent identifier"),
+    decision: z
+        .enum(["approve", "reject"])
+        .describe("Your vote decision: approve or reject (use gh pr review for comments)"),
+    reason: z.string().min(1).describe("Reason for your vote. For rejections, reference specific issues found on GitHub."),
+});
 // Tool implementations
 export async function listPendingReviews(client) {
     return client.listPendingChanges();
@@ -45,6 +54,14 @@ export async function submitReview(client, input) {
 export async function getConsensusStatus(client, input) {
     return client.getConsensusStatus(input.change_id);
 }
+// New decoupled voting function
+export async function submitVote(client, input) {
+    return client.submitVote(input.change_id, {
+        agent_id: input.agent_id,
+        decision: input.decision,
+        reason: input.reason,
+    });
+}
 // Tool definitions for MCP registration
 export const reviewTools = [
     {
@@ -73,10 +90,10 @@ export const reviewTools = [
     },
     {
         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.",
+        description: "[DEPRECATED - Use submit_vote instead] " +
+            "Submit your review for a pending PR. " +
+            "The new workflow is: 1) Post feedback on GitHub with `gh pr review`, " +
+            "2) Register vote with submit_vote. This tool is kept for backward compatibility.",
         inputSchema: {
             type: "object",
             properties: {
@@ -120,5 +137,36 @@ export const reviewTools = [
             required: ["change_id"],
         },
     },
+    {
+        name: "submit_vote",
+        description: "Register your vote for backend consensus coordination. " +
+            "IMPORTANT: Before using this tool, first post detailed feedback on GitHub using " +
+            "`gh pr review <PR_NUMBER> --approve` or `gh pr review <PR_NUMBER> --request-changes --body '...'`. " +
+            "This tool only tracks votes for automated merge/close decisions. " +
+            "Use 'approve' or 'reject' - comments should go on GitHub directly.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                change_id: {
+                    type: "string",
+                    description: "The UUID of the change/PR to vote on",
+                },
+                agent_id: {
+                    type: "string",
+                    description: "Your agent identifier",
+                },
+                decision: {
+                    type: "string",
+                    enum: ["approve", "reject"],
+                    description: "Your vote decision (approve or reject)",
+                },
+                reason: {
+                    type: "string",
+                    description: "Reason for your vote. For rejections, reference issues from your GitHub review.",
+                },
+            },
+            required: ["change_id", "agent_id", "decision", "reason"],
+        },
+    },
 ];
 //# sourceMappingURL=review.js.map