@mclawnet/mcp-server 0.1.3 → 0.1.5

package/dist/tools/plan-review.d.ts

@@ -0,0 +1,62 @@
+import type { InboxRelayLike } from "./inbox.js";
+export interface PlanReviewToolContext {
+    /**
+     * Optional override for the clawnet root (the user-home root, *not*
+     * `<home>/.clawnet`). When omitted, falls back to `CLAWNET_HOME` env var
+     * then `homedir()`. Plumbed in to keep tests on temp dirs in lockstep with
+     * the InboxStore the tool writes through.
+     */
+    rootDir?: string;
+    /**
+     * Optional in-process relay. When present, plan_review_submit fires
+     * `relay.deliver(swarmId, queenInstanceId)` after writing the message to
+     * disk so the queen wakes immediately. Failures are swallowed (best-effort).
+     *
+     * Cross-process MCP servers (the common case) leave this undefined; the
+     * agent-side `InboxWatcher` picks up the file change and triggers delivery
+     * via its own relay, where the swarm coordinator's interceptor consumes the
+     * `plan_review_result` envelope and forwards a normalized `plan_approved`
+     * / `plan_rejected` to the queen.
+     */
+    relay?: InboxRelayLike;
+}
+export declare const PLAN_REVIEW_TOOL_NAMES: Set<string>;
+export declare function getPlanReviewToolDefinitions(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            workDir: {
+                type: string;
+                description: string;
+            };
+            swarmId: {
+                type: string;
+                description: string;
+            };
+            from: {
+                type: string;
+                description: string;
+            };
+            verdict: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function handlePlanReviewToolCall(name: string, args: Record<string, unknown>, context: PlanReviewToolContext): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=plan-review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-review.d.ts","sourceRoot":"","sources":["../../src/tools/plan-review.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,aAAkC,CAAC;AAEtE,wBAAgB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0B3C;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBhF"}

package/dist/tools/plan-review.js

@@ -0,0 +1,144 @@
+import { randomUUID } from "node:crypto";
+import { readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createLogger } from "@mclawnet/logger";
+import { InboxStore } from "@mclawnet/swarm";
+import { projectRoot } from "@mclawnet/task";
+const log = createLogger({ module: "mcp-server/tools/plan-review" });
+export const PLAN_REVIEW_TOOL_NAMES = new Set(["plan_review_submit"]);
+export function getPlanReviewToolDefinitions() {
+    return [
+        {
+            name: "plan_review_submit",
+            description: "Submit a plan review verdict from the reviewer. Writes a plan_review_result " +
+                "message to the queen's inbox; the swarm coordinator intercepts it to update " +
+                "planStatus and forward a normalized plan_approved/plan_rejected message to the queen. " +
+                "Restricted to reviewer instances: caller must pass `from` starting with 'reviewer'.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    workDir: { type: "string", description: "Absolute path of the project working directory" },
+                    swarmId: { type: "string", description: "Swarm id this review belongs to" },
+                    from: { type: "string", description: "Caller instance id; must start with 'reviewer'" },
+                    verdict: {
+                        type: "string",
+                        enum: ["approved", "rejected"],
+                        description: "Verdict",
+                    },
+                    body: { type: "string", description: "Optional reviewer commentary forwarded to queen" },
+                },
+                required: ["workDir", "swarmId", "from", "verdict"],
+            },
+        },
+    ];
+}
+export async function handlePlanReviewToolCall(name, args, context) {
+    try {
+        log.info({ tool: name }, "MCP plan-review tool called");
+        switch (name) {
+            case "plan_review_submit":
+                return await handlePlanReviewSubmit(args, context);
+            default:
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.error({ tool: name, err }, "MCP plan-review tool error");
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+            isError: true,
+        };
+    }
+}
+/**
+ * Resolve the queen instanceId for a swarm by scanning its inboxes directory
+ * for a `queen-*.json` file. Returns the first match (alphabetical by readdir),
+ * or null when the directory is missing or contains no queen inbox.
+ *
+ * We use the existence of the inbox file (not a snapshot lookup) because the
+ * MCP server runs out-of-process from the agent and has no live access to
+ * `SwarmInstance.roles`. The inbox file is the durable handshake.
+ */
+function resolveQueenInstanceId(workDir, swarmId, rootDir) {
+    const home = rootDir ?? process.env.CLAWNET_HOME ?? homedir();
+    const dir = join(projectRoot(workDir, home), "swarms", swarmId, "inboxes");
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith("queen-") && entry.endsWith(".json")) {
+            return entry.slice(0, -".json".length);
+        }
+    }
+    return null;
+}
+async function handlePlanReviewSubmit(args, context) {
+    const workDir = args.workDir;
+    const swarmId = args.swarmId;
+    const from = args.from;
+    const verdictRaw = args.verdict;
+    const body = args.body;
+    if (!workDir)
+        throw new Error("workDir is required");
+    if (!swarmId)
+        throw new Error("swarmId is required");
+    if (!from)
+        throw new Error("from is required");
+    if (verdictRaw !== "approved" && verdictRaw !== "rejected") {
+        throw new Error(`invalid verdict: ${verdictRaw}`);
+    }
+    const verdict = verdictRaw;
+    if (!from.startsWith("reviewer")) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: "Only reviewer instances may submit plan review" }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const queenInstanceId = resolveQueenInstanceId(workDir, swarmId, context.rootDir);
+    if (!queenInstanceId) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ error: `No queen inbox found in swarm ${swarmId}` }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const msg = {
+        id: randomUUID(),
+        from,
+        type: "plan_review_result",
+        data: JSON.stringify({ verdict, body: body ?? "" }),
+        timestamp: Date.now(),
+        delivered: false,
+    };
+    await new InboxStore(workDir, swarmId, context.rootDir).append(queenInstanceId, msg);
+    if (context.relay) {
+        try {
+            await context.relay.deliver(swarmId, queenInstanceId);
+        }
+        catch (err) {
+            log.warn({ err, swarmId, queen: queenInstanceId }, "plan-review relay deliver failed (best-effort)");
+        }
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ submitted: true, queen: queenInstanceId }) }],
+    };
+}
+//# sourceMappingURL=plan-review.js.map

package/dist/tools/plan-review.js.map

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