@hueyexe/opencode-ensemble 0.8.0 → 0.9.0

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm version](https://img.shields.io/npm/v/@hueyexe/opencode-ensemble.svg)](https://www.npmjs.com/package/@hueyexe/opencode-ensemble)
 [![npm downloads](https://img.shields.io/npm/dm/@hueyexe/opencode-ensemble.svg)](https://www.npmjs.com/package/@hueyexe/opencode-ensemble)
-[![tests](https://img.shields.io/badge/tests-423%20passing-brightgreen.svg)]()
+[![tests](https://img.shields.io/badge/tests-432%20passing-brightgreen.svg)]()
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)]()
-[![zero deps](https://img.shields.io/badge/dependencies-0-brightgreen.svg)]()
+[![OpenCode SDK](https://img.shields.io/badge/deps-OpenCode%20SDK%20only-blue.svg)]()
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 Run parallel AI agents in OpenCode. Each agent gets its own session, context window, and task. They coordinate through messaging and a shared task board.
@@ -95,13 +95,13 @@ Two steps: add the plugin, then allowlist worktree paths.
 
 ### 1. Add the plugin
 
-Add to your OpenCode config. Project-level or global.
+Add to your OpenCode config with a pinned version. Project-level or global.
 
 **Project-level** (`opencode.json` in your project root):
 
 ```json
 {
-  "plugin": ["@hueyexe/opencode-ensemble"]
+  "plugin": ["@hueyexe/opencode-ensemble@0.9.0"]
 }
 ```
 
@@ -109,11 +109,21 @@ Add to your OpenCode config. Project-level or global.
 
 ```json
 {
-  "plugin": ["@hueyexe/opencode-ensemble"]
+  "plugin": ["@hueyexe/opencode-ensemble@0.9.0"]
 }
 ```
 
-OpenCode auto-installs npm plugins at startup (cached in `~/.cache/opencode/node_modules/`). No `npm install` needed.
+OpenCode auto-installs npm plugins at startup. To update, bump the version number in your config and restart OpenCode.
+
+**Why pin versions?** OpenCode has a [known bug](https://github.com/anomalyco/opencode/issues/6774) where unpinned plugins (e.g., `"@hueyexe/opencode-ensemble"`) get cached on first install and never auto-update, even after restarting. Pinning to a specific version avoids this — when you change the version string, OpenCode sees a new package spec and installs it fresh.
+
+If you're stuck on an old version, clear the cache manually:
+
+```bash
+rm -rf ~/.cache/opencode/packages/@hueyexe
+```
+
+Then restart OpenCode.
 
 ### 2. Allow worktree directory access
 
@@ -298,7 +308,7 @@ Same coordination model (shared tasks, peer messaging, lead coordination) with s
 ```bash
 bun install
 bun run typecheck
-bun test             # 423 tests
+bun test             # 432 tests
 bun run build
 ```
 

package/dist/index.js

@@ -15741,6 +15741,33 @@ async function notifyWorkingProgress(client3, db, teamId) {
   } catch {}
 }
 
+// src/result-parser.ts
+function parseTaskResult(content) {
+  const match = content.match(/<task-result>([\s\S]*?)<\/task-result>/);
+  if (!match)
+    return null;
+  const inner = match[1];
+  const status = inner.match(/<status>([\s\S]*?)<\/status>/)?.[1]?.trim();
+  const summary = inner.match(/<summary>([\s\S]*?)<\/summary>/)?.[1]?.trim();
+  const details = inner.match(/<details>([\s\S]*?)<\/details>/)?.[1]?.trim();
+  const branch = inner.match(/<branch>([\s\S]*?)<\/branch>/)?.[1]?.trim();
+  if (!status || !summary || !details)
+    return null;
+  return { status, summary, details, branch: branch || undefined };
+}
+function formatTaskResult(from, result) {
+  const lines = [
+    `[Result from ${from}]:`,
+    `  Status: ${result.status}`,
+    `  Summary: ${result.summary}`,
+    `  Details: ${result.details}`
+  ];
+  if (result.branch)
+    lines.push(`  Branch: ${result.branch}`);
+  return lines.join(`
+`);
+}
+
 // src/system-prompt.ts
 function truncate(s, maxLen) {
   return s.length > maxLen ? `${s.slice(0, maxLen)}...` : s;
@@ -15791,7 +15818,11 @@ function buildLeadSystemPrompt(db, teamId) {
     lines.push("", "--- Team Messages ---");
     const MAX_MSG = 500;
     for (const msg of pendingMessages) {
-      if (msg.content.length > MAX_MSG) {
+      const parsed = parseTaskResult(msg.content);
+      if (parsed) {
+        const truncatedResult = { ...parsed, details: truncate(parsed.details, 500) };
+        lines.push(formatTaskResult(msg.from_name, truncatedResult));
+      } else if (msg.content.length > MAX_MSG) {
         lines.push(`[From ${msg.from_name}]: ${msg.content.slice(0, MAX_MSG)}... (use team_results to read full message)`);
       } else {
         lines.push(`[From ${msg.from_name}]: ${msg.content}`);
@@ -16184,6 +16215,10 @@ async function executeTeamSpawn(deps, args, sessionId) {
     `You are "${args.name}", a teammate in team "${teamInfo.teamName}".`,
     `Your agent type is "${args.agent}".`
   ];
+  const otherMembers = deps.db.query("SELECT name FROM team_member WHERE team_id = ? AND name != ? AND status NOT IN ('shutdown', 'error')").all(teamInfo.teamId, args.name);
+  if (otherMembers.length > 0) {
+    context.push(`Other teammates: ${otherMembers.map((m) => m.name).join(", ")}`);
+  }
   if (worktreeBranch && worktreeDir && !workspaceId) {
     context.push(`You are working on branch "${worktreeBranch}" in your own worktree at: ${worktreeDir}`, `Your changes are isolated from other teammates.`, `IMPORTANT: All file operations and shell commands MUST target your worktree directory.`, `Before running shell commands, cd to: ${worktreeDir}`);
   } else if (worktreeBranch && worktreeDir) {
@@ -16216,7 +16251,7 @@ async function executeTeamSpawn(deps, args, sessionId) {
   }
   context.push("</task-result>");
   const lastStep = !isReadOnly && worktreeBranch ? "4" : !isReadOnly ? "3" : "2";
-  context.push(`${lastStep}. STOP. Do not send follow-up confirmations, status updates, or 'standing by' messages.`, "", "If you are blocked, send ONE message to the lead describing the specific blocker.", "", "Your plain text output is NOT visible to the team. You MUST use team_message to communicate.");
+  context.push(`${lastStep}. STOP. Do not send follow-up confirmations, status updates, or 'standing by' messages.`, "", "If you are blocked:", "- Send ONE message to the lead via team_message describing the specific blocker.", "- Do NOT attempt workarounds or make assumptions. Wait for the lead's response.", "", "Your plain text output is NOT visible to the team. You MUST use team_message to communicate.");
   context.push("", "Your task:", args.prompt);
   if (args.claim_task) {
     context.push("", `You have been assigned task ${args.claim_task}. Mark it complete when done.`);
@@ -16622,9 +16657,14 @@ async function executeTeamResults(deps, args, sessionId) {
   const ids = rows.map((r) => r.id);
   const placeholders = ids.map(() => "?").join(", ");
   deps.db.run(`UPDATE team_message SET read = 1 WHERE id IN (${placeholders})`, ids);
-  return rows.map((r) => `[Message from ${r.from_name}]:
-${r.content}
-`).join(`
+  return rows.map((r) => {
+    const parsed = parseTaskResult(r.content);
+    if (parsed)
+      return formatTaskResult(r.from_name, parsed);
+    return `[Message from ${r.from_name}]:
+${r.content}`;
+  }).join(`
+
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hueyexe/opencode-ensemble",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Agent teams for OpenCode — parallel agents with peer-to-peer communication, shared tasks, and coordinated execution",
   "module": "src/index.ts",
   "main": "dist/index.js",

package/src/result-parser.ts

@@ -0,0 +1,40 @@
+/** Structured result parsed from `<task-result>` XML. */
+export interface TaskResult {
+  status: string
+  summary: string
+  details: string
+  branch?: string
+}
+
+/**
+ * Parse `<task-result>` XML from message content.
+ * Returns null if not found or missing required fields.
+ */
+export function parseTaskResult(content: string): TaskResult | null {
+  const match = content.match(/<task-result>([\s\S]*?)<\/task-result>/)
+  if (!match) return null
+
+  const inner = match[1]!
+  const status = inner.match(/<status>([\s\S]*?)<\/status>/)?.[1]?.trim()
+  const summary = inner.match(/<summary>([\s\S]*?)<\/summary>/)?.[1]?.trim()
+  const details = inner.match(/<details>([\s\S]*?)<\/details>/)?.[1]?.trim()
+  const branch = inner.match(/<branch>([\s\S]*?)<\/branch>/)?.[1]?.trim()
+
+  if (!status || !summary || !details) return null
+
+  return { status, summary, details, branch: branch || undefined }
+}
+
+/**
+ * Format a TaskResult as clean readable text.
+ */
+export function formatTaskResult(from: string, result: TaskResult): string {
+  const lines = [
+    `[Result from ${from}]:`,
+    `  Status: ${result.status}`,
+    `  Summary: ${result.summary}`,
+    `  Details: ${result.details}`,
+  ]
+  if (result.branch) lines.push(`  Branch: ${result.branch}`)
+  return lines.join("\n")
+}

package/src/system-prompt.ts

@@ -1,5 +1,6 @@
 import type { Database } from "bun:sqlite"
 import { markDelivered } from "./messaging"
+import { parseTaskResult, formatTaskResult } from "./result-parser"
 
 /** Truncate a string to maxLen chars, appending "..." if truncated. */
 function truncate(s: string, maxLen: number): string {
@@ -82,7 +83,12 @@ export function buildLeadSystemPrompt(db: Database, teamId: string): string {
     lines.push("", "--- Team Messages ---")
     const MAX_MSG = 500
     for (const msg of pendingMessages) {
-      if (msg.content.length > MAX_MSG) {
+      const parsed = parseTaskResult(msg.content)
+      if (parsed) {
+        // Truncate details for system prompt — full content available via team_results
+        const truncatedResult = { ...parsed, details: truncate(parsed.details, 500) }
+        lines.push(formatTaskResult(msg.from_name, truncatedResult))
+      } else if (msg.content.length > MAX_MSG) {
         lines.push(`[From ${msg.from_name}]: ${msg.content.slice(0, MAX_MSG)}... (use team_results to read full message)`)
       } else {
         lines.push(`[From ${msg.from_name}]: ${msg.content}`)

package/src/tools/team-results.ts

@@ -1,5 +1,6 @@
 import type { ToolDeps } from "../types"
 import { requireTeamMember } from "./shared"
+import { parseTaskResult, formatTaskResult } from "../result-parser"
 
 /** Row shape for unread messages query. */
 interface UnreadMessageRow {
@@ -39,6 +40,10 @@ export async function executeTeamResults(
   const placeholders = ids.map(() => "?").join(", ")
   deps.db.run(`UPDATE team_message SET read = 1 WHERE id IN (${placeholders})`, ids)
 
-  // Format output
-  return rows.map((r) => `[Message from ${r.from_name}]:\n${r.content}\n`).join("\n")
+  // Format output — parse structured task results when present
+  return rows.map((r) => {
+    const parsed = parseTaskResult(r.content)
+    if (parsed) return formatTaskResult(r.from_name, parsed)
+    return `[Message from ${r.from_name}]:\n${r.content}`
+  }).join("\n\n")
 }

package/src/tools/team-spawn.ts

@@ -197,6 +197,14 @@ export async function executeTeamSpawn(
     `Your agent type is "${args.agent}".`,
   ]
 
+  // Show other teammates so this agent knows who to message
+  const otherMembers = deps.db.query(
+    "SELECT name FROM team_member WHERE team_id = ? AND name != ? AND status NOT IN ('shutdown', 'error')"
+  ).all(teamInfo.teamId, args.name) as Array<{ name: string }>
+  if (otherMembers.length > 0) {
+    context.push(`Other teammates: ${otherMembers.map(m => m.name).join(", ")}`)
+  }
+
   if (worktreeBranch && worktreeDir && !workspaceId) {
     // Workspace binding failed — fallback to prompt-based CWD instruction
     context.push(
@@ -276,7 +284,9 @@ export async function executeTeamSpawn(
   context.push(
     `${lastStep}. STOP. Do not send follow-up confirmations, status updates, or 'standing by' messages.`,
     "",
-    "If you are blocked, send ONE message to the lead describing the specific blocker.",
+    "If you are blocked:",
+    "- Send ONE message to the lead via team_message describing the specific blocker.",
+    "- Do NOT attempt workarounds or make assumptions. Wait for the lead's response.",
     "",
     "Your plain text output is NOT visible to the team. You MUST use team_message to communicate.",
   )