opencodekit 0.15.10 → 0.15.12

package/dist/template/.opencode/tool/swarm-helper.ts

@@ -0,0 +1,164 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { tool } from "@opencode-ai/plugin";
+
+export const SWARM_MAIL_FILE = ".beads/swarm-mail.jsonl";
+
+type BaseArgs = {
+	team_name: string;
+};
+
+type GetTeamStatusArgs = BaseArgs & {
+	limit?: number;
+};
+
+type SendTeamMessageArgs = BaseArgs & {
+	from_worker?: string;
+	to_worker?: string;
+	message: string;
+};
+
+export default tool({
+	description: `Swarm coordination helper.
+
+Operations:
+  - getTeamStatus: Read swarm mailbox for worker reports and progress
+  - sendTeamMessage: Write to swarm mailbox for coordination
+
+Pattern:
+  - Build agent orchestrates: parses plan → spawns team → monitors → synthesizes
+  - General agent executes: reads delegation packet → makes changes → reports back
+  - Coordination via mailbox: .beads/swarm-mail.jsonl (append-only log)
+
+Example:
+  getTeamStatus({ team_name: "plan-implementation" })
+  → Returns: worker_status for each worker (pending/working/done/error)
+
+  sendTeamMessage({
+    team_name: "plan-implementation",
+    from_worker: "worker-1",
+    to_worker: "worker-2",
+    message: "Need help with file locking",
+  })
+  → Appends JSONL line: { timestamp, from, to, message }
+
+`,
+	args: {
+		team_name: tool.schema
+			.string()
+			.describe("Team identifier (e.g., plan-implementation, auth-feature)"),
+		operation: tool.schema
+			.enum(["getTeamStatus", "sendTeamMessage"])
+			.describe("Which swarm coordination operation to perform"),
+		from_worker: tool.schema
+			.string()
+			.optional()
+			.describe("Sending worker name (sendTeamMessage)"),
+		to_worker: tool.schema
+			.string()
+			.optional()
+			.describe("Target worker name (sendTeamMessage)"),
+		message: tool.schema
+			.string()
+			.optional()
+			.describe("Message content (sendTeamMessage)"),
+		limit: tool.schema
+			.number()
+			.optional()
+			.describe("Limit mailbox entries (getTeamStatus)"),
+	},
+	execute: async (args) => {
+		const operation = args.operation as string;
+
+		if (operation === "getTeamStatus") {
+			const result = await getTeamStatus(args as any);
+			return result;
+		}
+
+		if (operation === "sendTeamMessage") {
+			const result = await sendTeamMessage(args as any);
+			return result;
+		}
+
+		return `Error: Unknown operation: ${operation}. Valid: getTeamStatus, sendTeamMessage`;
+	},
+});
+
+async function getTeamStatus(args: GetTeamStatusArgs) {
+	const { team_name, limit } = args;
+
+	if (!team_name) {
+		return "Error: team_name is required.";
+	}
+
+	const mailPath = path.join(process.cwd(), SWARM_MAIL_FILE);
+	let lines: string[];
+
+	try {
+		const content = await fs.readFile(mailPath, "utf-8");
+		lines = content.trim().split("\n").filter(Boolean);
+	} catch {
+		return `Error: Failed to read ${SWARM_MAIL_FILE}.`;
+	}
+
+	const team_messages = lines
+		.map((line) => {
+			try {
+				return JSON.parse(line) as {
+					timestamp: string;
+					team_name: string;
+					from_worker?: string;
+					to_worker?: string;
+					message?: string;
+					status?: string;
+				};
+			} catch {
+				return null;
+			}
+		})
+		.filter(Boolean);
+
+	const relevant = team_messages.filter((m) => m.team_name === team_name);
+
+	if (limit && limit > 0) {
+		return JSON.stringify(relevant.slice(-limit), null, 2);
+	}
+
+	return JSON.stringify(relevant, null, 2);
+}
+
+async function sendTeamMessage(args: SendTeamMessageArgs) {
+	const { team_name, from_worker, to_worker, message } = args;
+
+	if (!team_name || !message) {
+		return "Error: team_name and message are required.";
+	}
+
+	const mailPath = path.join(process.cwd(), SWARM_MAIL_FILE);
+	const entry = {
+		timestamp: new Date().toISOString(),
+		team_name,
+		from_worker: from_worker || "system",
+		to_worker: to_worker || "all",
+		message,
+		status: "unread",
+	};
+
+	try {
+		await fs.appendFile(mailPath, `${JSON.stringify(entry)}\n`, "utf-8");
+		return JSON.stringify(
+			{
+				success: true,
+				team_name,
+				from_worker,
+				to_worker,
+				message,
+				mail_file: SWARM_MAIL_FILE,
+			},
+			null,
+			2,
+		);
+	} catch (error: any) {
+		return `Error: Failed to write to ${SWARM_MAIL_FILE}: ${error}`;
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.15.10",
+	"version": "0.15.12",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",