@hueyexe/opencode-ensemble 0.2.0 → 0.3.0

package/README.md

@@ -125,7 +125,6 @@ export { default } from "/path/to/opencode-ensemble/src/index.ts"
 | `team_spawn` | Start a new teammate with a task. |
 | `team_shutdown` | Ask a teammate to stop. |
 | `team_cleanup` | Remove the team when done. |
-| `team_approve_plan` | Approve or reject a teammate's plan before they write code. |
 | `team_status` | See all members, their status, and a task summary. |
 | `team_view` | Switch the TUI to a teammate's session. |
 
@@ -135,6 +134,7 @@ export { default } from "/path/to/opencode-ensemble/src/index.ts"
 |------|-------------|
 | `team_message` | Send a direct message to a teammate or the lead. |
 | `team_broadcast` | Message everyone on the team. |
+| `team_results` | Retrieve full message content (messages to lead are truncated on delivery). |
 
 **Task board** (everyone)
 

package/dist/index.js

@@ -12407,7 +12407,9 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS team_message_to_idx ON team_message(to_name);
   CREATE INDEX IF NOT EXISTS team_message_undelivered_idx ON team_message(team_id, delivered)
     WHERE delivered = 0;
-  `
+  `,
+  `ALTER TABLE team_message ADD COLUMN read INTEGER NOT NULL DEFAULT 0;
+   CREATE INDEX IF NOT EXISTS team_message_unread_idx ON team_message(team_id, read) WHERE read = 0;`
 ];
 function applyMigrations(db) {
   const { user_version: current } = db.query("PRAGMA user_version").get();
@@ -12741,7 +12743,7 @@ async function executeTeamCreate(deps, args, sessionId) {
   const id = generateId("team");
   const now = Date.now();
   deps.db.run("INSERT INTO team (id, name, lead_session_id, status, delegate, time_created, time_updated) VALUES (?, ?, ?, 'active', 0, ?, ?)", [id, args.name, sessionId, now, now]);
-  return `Team "${args.name}" created (ID: ${id}). You are the lead. Use team_spawn to add teammates. Teammates will message you when done \u2014 do not poll team_status repeatedly.`;
+  return `Team "${args.name}" created (ID: ${id}). You are the lead. Use team_spawn to add teammates. Teammates will message you when done \u2014 do not poll team_status repeatedly. IMPORTANT: After spawning all teammates, do NOT call any tools. Tell the user what you've set up and STOP. You will be woken automatically.`;
 }
 
 // src/tools/team-spawn.ts
@@ -12809,7 +12811,7 @@ async function executeTeamSpawn(deps, args, sessionId) {
     } catch {}
     throw new Error(`Failed to send initial prompt to teammate "${args.name}": ${err instanceof Error ? err.message : String(err)}`);
   }
-  return `Teammate "${args.name}" spawned (session: ${childSessionId}, agent: ${args.agent}). Working on: ${args.prompt.slice(0, 100)}${args.prompt.length > 100 ? "..." : ""} Teammates will message you when done. Do not poll team_status to check.`;
+  return `Teammate "${args.name}" spawned (agent: ${args.agent}). IMPORTANT: Do NOT call any tools after this. Tell the user what you've set up and STOP. You will be woken automatically when teammates message you.`;
 }
 
 // src/tools/team-message.ts
@@ -12827,9 +12829,18 @@ async function executeTeamMessage(deps, args, sessionId) {
     to: args.to,
     content: args.text
   });
+  const isToLead = args.to === "lead";
+  const MAX_LEAD_MSG = 500;
+  let deliveryText;
+  if (isToLead && args.text.length > MAX_LEAD_MSG) {
+    const truncated = args.text.slice(0, MAX_LEAD_MSG);
+    deliveryText = `[Team message from ${senderName}]: ${truncated}... (use team_results to read full message)`;
+  } else {
+    deliveryText = `[Team message from ${senderName}]: ${args.text}`;
+  }
   await deps.client.session.promptAsync({
     path: { id: recipientSessionId },
-    body: { parts: [{ type: "text", text: `[Team message from ${senderName}]: ${args.text}` }] }
+    body: { parts: [{ type: "text", text: deliveryText }] }
   });
   markDelivered(deps.db, msgId);
   return `Message sent to ${args.to}.`;
@@ -13027,36 +13038,36 @@ async function executeTeamClaim(deps, args, sessionId) {
   return `Claimed task: ${task.content}`;
 }
 
-// src/tools/team-approve-plan.ts
-async function executeTeamApprovePlan(deps, args, sessionId) {
-  const teamInfo = findTeamBySession(deps.db, deps.registry, sessionId);
-  if (!teamInfo)
-    throw new Error("This session is not in a team.");
-  if (teamInfo.role !== "lead")
-    throw new Error("Only the team lead can approve plans.");
-  const member = deps.db.query("SELECT session_id, status FROM team_member WHERE team_id = ? AND name = ?").get(teamInfo.teamId, args.member);
-  if (!member)
-    throw new Error(`Teammate "${args.member}" not found in team "${teamInfo.teamName}"`);
-  const text = args.approved ? `Your plan has been APPROVED.${args.feedback ? ` Feedback: ${args.feedback}` : " Proceed with implementation."}` : `Your plan has been REJECTED. Please revise and resubmit.${args.feedback ? ` Feedback: ${args.feedback}` : ""}`;
-  const msgId = sendMessage(deps.db, {
-    teamId: teamInfo.teamId,
-    from: "lead",
-    to: args.member,
-    content: text
-  });
-  await deps.client.session.promptAsync({
-    path: { id: member.session_id },
-    body: { parts: [{ type: "text", text: `[Plan ${args.approved ? "approved" : "rejected"} by lead]: ${text}` }] }
-  });
-  markDelivered(deps.db, msgId);
-  return `Plan ${args.approved ? "approved" : "rejected"} for ${args.member}.${args.feedback ? ` Feedback: ${args.feedback}` : ""}`;
+// src/tools/team-results.ts
+async function executeTeamResults(deps, args, sessionId) {
+  const team = findTeamBySession(deps.db, deps.registry, sessionId);
+  if (!team)
+    throw new Error("not in a team");
+  const rows = args.from ? deps.db.query("SELECT id, from_name, content, time_created FROM team_message WHERE team_id = ? AND read = 0 AND from_name = ? ORDER BY time_created ASC").all(team.teamId, args.from) : deps.db.query("SELECT id, from_name, content, time_created FROM team_message WHERE team_id = ? AND read = 0 ORDER BY time_created ASC").all(team.teamId);
+  if (rows.length === 0)
+    return "No unread messages.";
+  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(`
+`);
 }
 
 // src/tools/team-status.ts
+var lastCallTime = new Map;
+var RATE_LIMIT_MS = 30000;
 async function executeTeamStatus(deps, sessionId) {
   const teamInfo = findTeamBySession(deps.db, deps.registry, sessionId);
   if (!teamInfo)
     throw new Error("This session is not in a team.");
+  const now = Date.now();
+  const last = lastCallTime.get(teamInfo.teamId);
+  if (last !== undefined && now - last < RATE_LIMIT_MS) {
+    return "Status unchanged. STOP \u2014 do not call any more tools. Tell the user you are waiting for teammates to finish. You will be woken automatically when they message you.";
+  }
+  lastCallTime.set(teamInfo.teamId, now);
   const members = deps.db.query("SELECT name, session_id, agent, status, execution_status FROM team_member WHERE team_id = ? ORDER BY time_created ASC").all(teamInfo.teamId);
   const tasks = deps.db.query("SELECT status FROM team_task WHERE team_id = ?").all(teamInfo.teamId);
   const lines = [];
@@ -13099,7 +13110,9 @@ async function executeTeamStatus(deps, sessionId) {
       });
     } catch {}
   }
-  return lines.join(`
+  return `[Relay this status to the user in your next message:]
+
+` + lines.join(`
 `);
 }
 
@@ -13111,8 +13124,12 @@ async function executeTeamView(deps, args, sessionId) {
   const member = deps.db.query("SELECT session_id, status, agent FROM team_member WHERE team_id = ? AND name = ?").get(teamInfo.teamId, args.member);
   if (!member)
     throw new Error(`Teammate "${args.member}" not found in team "${teamInfo.teamName}"`);
-  await deps.client.tui.selectSession({ sessionID: member.session_id });
-  return `Switched view to ${args.member}'s session (${member.session_id}). Use the session picker to return to the lead session.`;
+  try {
+    if (typeof deps.client.tui.selectSession === "function") {
+      await deps.client.tui.selectSession({ sessionID: member.session_id });
+    }
+  } catch {}
+  return `View ${args.member}'s session: ${member.session_id}. Use the session picker (ctrl+p) to navigate to their session.`;
 }
 
 // src/rate-limit.ts
@@ -13421,16 +13438,14 @@ var plugin = async (input) => {
           return result;
         }
       }),
-      team_approve_plan: tool({
-        description: "Approve or reject a teammate's implementation plan. Only the team lead can use this.",
+      team_results: tool({
+        description: "Retrieve full message content from teammates. Returns unread messages and marks them as read. Use this after receiving a truncated message notification.",
         args: {
-          member: tool.schema.string().describe("Teammate name"),
-          approved: tool.schema.boolean().describe("true to approve, false to reject"),
-          feedback: tool.schema.string().optional().describe("Feedback message (optional)")
+          from: tool.schema.string().optional().describe("Filter messages by sender name (optional, returns all if omitted)")
         },
         async execute(args, ctx) {
-          const result = await executeTeamApprovePlan(deps, args, ctx.sessionID);
-          ctx.metadata({ title: `Plan ${args.approved ? "approved" : "rejected"}: ${args.member}` });
+          const result = await executeTeamResults(deps, args, ctx.sessionID);
+          ctx.metadata({ title: `Results${args.from ? ` from ${args.from}` : ""}` });
           return result;
         }
       }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hueyexe/opencode-ensemble",
-  "version": "0.2.0",
+  "version": "0.3.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/index.ts

@@ -17,7 +17,7 @@ import { executeTeamTasksList } from "./tools/team-tasks-list"
 import { executeTeamTasksAdd } from "./tools/team-tasks-add"
 import { executeTeamTasksComplete } from "./tools/team-tasks-complete"
 import { executeTeamClaim } from "./tools/team-claim"
-import { executeTeamApprovePlan } from "./tools/team-approve-plan"
+import { executeTeamResults } from "./tools/team-results"
 import { executeTeamStatus } from "./tools/team-status"
 import { executeTeamView } from "./tools/team-view"
 import type { ToolDeps, PluginClient } from "./types"
@@ -254,16 +254,14 @@ const plugin: Plugin = async (input) => {
         },
       }),
 
-      team_approve_plan: tool({
-        description: "Approve or reject a teammate's implementation plan. Only the team lead can use this.",
+      team_results: tool({
+        description: "Retrieve full message content from teammates. Returns unread messages and marks them as read. Use this after receiving a truncated message notification.",
         args: {
-          member: tool.schema.string().describe("Teammate name"),
-          approved: tool.schema.boolean().describe("true to approve, false to reject"),
-          feedback: tool.schema.string().optional().describe("Feedback message (optional)"),
+          from: tool.schema.string().optional().describe("Filter messages by sender name (optional, returns all if omitted)"),
         },
         async execute(args, ctx) {
-          const result = await executeTeamApprovePlan(deps, args, ctx.sessionID)
-          ctx.metadata({ title: `Plan ${args.approved ? "approved" : "rejected"}: ${args.member}` })
+          const result = await executeTeamResults(deps, args, ctx.sessionID)
+          ctx.metadata({ title: `Results${args.from ? ` from ${args.from}` : ""}` })
           return result
         },
       }),

package/src/schema.ts

@@ -67,6 +67,9 @@ export const MIGRATIONS: string[] = [
   CREATE INDEX IF NOT EXISTS team_message_undelivered_idx ON team_message(team_id, delivered)
     WHERE delivered = 0;
   `,
+  // Migration 2: Add read column to team_message for team_results tracking
+  `ALTER TABLE team_message ADD COLUMN read INTEGER NOT NULL DEFAULT 0;
+   CREATE INDEX IF NOT EXISTS team_message_unread_idx ON team_message(team_id, read) WHERE read = 0;`,
 ]
 
 /**

package/src/tools/team-create.ts

@@ -28,5 +28,5 @@ export async function executeTeamCreate(
     [id, args.name, sessionId, now, now]
   )
 
-  return `Team "${args.name}" created (ID: ${id}). You are the lead. Use team_spawn to add teammates. Teammates will message you when done — do not poll team_status repeatedly.`
+  return `Team "${args.name}" created (ID: ${id}). You are the lead. Use team_spawn to add teammates. Teammates will message you when done — do not poll team_status repeatedly. IMPORTANT: After spawning all teammates, do NOT call any tools. Tell the user what you've set up and STOP. You will be woken automatically.`
 }

package/src/tools/team-message.ts

@@ -25,10 +25,20 @@ export async function executeTeamMessage(
     content: args.text,
   })
 
-  // Deliver via promptAsync
+  // Deliver via promptAsync — truncate lead-bound messages over 500 chars
+  const isToLead = args.to === "lead"
+  const MAX_LEAD_MSG = 500
+  let deliveryText: string
+  if (isToLead && args.text.length > MAX_LEAD_MSG) {
+    const truncated = args.text.slice(0, MAX_LEAD_MSG)
+    deliveryText = `[Team message from ${senderName}]: ${truncated}... (use team_results to read full message)`
+  } else {
+    deliveryText = `[Team message from ${senderName}]: ${args.text}`
+  }
+
   await deps.client.session.promptAsync({
     path: { id: recipientSessionId },
-    body: { parts: [{ type: "text", text: `[Team message from ${senderName}]: ${args.text}` }] },
+    body: { parts: [{ type: "text", text: deliveryText }] },
   })
 
   markDelivered(deps.db, msgId)

package/src/tools/team-results.ts

@@ -0,0 +1,45 @@
+import type { ToolDeps } from "../types"
+import { findTeamBySession } from "../types"
+
+/** Row shape for unread messages query. */
+interface UnreadMessageRow {
+  id: string
+  from_name: string
+  content: string
+  time_created: number
+}
+
+/**
+ * Retrieve unread messages from the team message store.
+ * Optionally filter by sender name. Marks returned messages as read.
+ */
+export async function executeTeamResults(
+  deps: ToolDeps,
+  args: { from?: string },
+  sessionId: string,
+): Promise<string> {
+  const team = findTeamBySession(deps.db, deps.registry, sessionId)
+  if (!team) throw new Error("not in a team")
+
+  const rows = args.from
+    ? (deps.db
+        .query(
+          "SELECT id, from_name, content, time_created FROM team_message WHERE team_id = ? AND read = 0 AND from_name = ? ORDER BY time_created ASC",
+        )
+        .all(team.teamId, args.from) as UnreadMessageRow[])
+    : (deps.db
+        .query(
+          "SELECT id, from_name, content, time_created FROM team_message WHERE team_id = ? AND read = 0 ORDER BY time_created ASC",
+        )
+        .all(team.teamId) as UnreadMessageRow[])
+
+  if (rows.length === 0) return "No unread messages."
+
+  // Mark all returned messages as read
+  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)
+
+  // Format output
+  return rows.map((r) => `[Message from ${r.from_name}]:\n${r.content}\n`).join("\n")
+}

package/src/tools/team-spawn.ts

@@ -88,5 +88,5 @@ export async function executeTeamSpawn(
     throw new Error(`Failed to send initial prompt to teammate "${args.name}": ${err instanceof Error ? err.message : String(err)}`)
   }
 
-  return `Teammate "${args.name}" spawned (session: ${childSessionId}, agent: ${args.agent}). Working on: ${args.prompt.slice(0, 100)}${args.prompt.length > 100 ? "..." : ""} Teammates will message you when done. Do not poll team_status to check.`
+  return `Teammate "${args.name}" spawned (agent: ${args.agent}). IMPORTANT: Do NOT call any tools after this. Tell the user what you've set up and STOP. You will be woken automatically when teammates message you.`
 }

package/src/tools/team-status.ts

@@ -1,6 +1,11 @@
 import type { ToolDeps } from "../types"
 import { findTeamBySession } from "../types"
 
+/** Tracks the last time team_status was called per team ID (epoch ms). */
+export const lastCallTime = new Map<string, number>()
+
+const RATE_LIMIT_MS = 30_000
+
 /**
  * Execute the team_status tool. Shows team overview with member statuses and task summary.
  */
@@ -11,6 +16,13 @@ export async function executeTeamStatus(
   const teamInfo = findTeamBySession(deps.db, deps.registry, sessionId)
   if (!teamInfo) throw new Error("This session is not in a team.")
 
+  const now = Date.now()
+  const last = lastCallTime.get(teamInfo.teamId)
+  if (last !== undefined && (now - last) < RATE_LIMIT_MS) {
+    return "Status unchanged. STOP — do not call any more tools. Tell the user you are waiting for teammates to finish. You will be woken automatically when they message you."
+  }
+  lastCallTime.set(teamInfo.teamId, now)
+
   const members = deps.db.query(
     "SELECT name, session_id, agent, status, execution_status FROM team_member WHERE team_id = ? ORDER BY time_created ASC"
   ).all(teamInfo.teamId) as Array<{
@@ -68,5 +80,5 @@ export async function executeTeamStatus(
     }
   }
 
-  return lines.join("\n")
+  return "[Relay this status to the user in your next message:]\n\n" + lines.join("\n")
 }

package/src/tools/team-view.ts

@@ -17,7 +17,14 @@ export async function executeTeamView(
     .get(teamInfo.teamId, args.member) as { session_id: string; status: string; agent: string } | null
   if (!member) throw new Error(`Teammate "${args.member}" not found in team "${teamInfo.teamName}"`)
 
-  await deps.client.tui.selectSession({ sessionID: member.session_id })
+  // TUI session navigation — try selectSession if available, otherwise guide the user
+  try {
+    if (typeof deps.client.tui.selectSession === "function") {
+      await deps.client.tui.selectSession({ sessionID: member.session_id })
+    }
+  } catch {
+    // selectSession may not be available in all SDK versions — fall through to manual guidance
+  }
 
-  return `Switched view to ${args.member}'s session (${member.session_id}). Use the session picker to return to the lead session.`
+  return `View ${args.member}'s session: ${member.session_id}. Use the session picker (ctrl+p) to navigate to their session.`
 }

package/src/tools/team-approve-plan.ts

@@ -1,42 +0,0 @@
-import type { ToolDeps } from "../types"
-import { findTeamBySession, resolveRecipientSession } from "../types"
-import { sendMessage, markDelivered } from "../messaging"
-
-/**
- * Execute the team_approve_plan tool. Approves or rejects a teammate's plan
- * and notifies them via message.
- */
-export async function executeTeamApprovePlan(
-  deps: ToolDeps,
-  args: { member: string; approved: boolean; feedback?: string },
-  sessionId: string,
-): Promise<string> {
-  const teamInfo = findTeamBySession(deps.db, deps.registry, sessionId)
-  if (!teamInfo) throw new Error("This session is not in a team.")
-  if (teamInfo.role !== "lead") throw new Error("Only the team lead can approve plans.")
-
-  const member = deps.db.query("SELECT session_id, status FROM team_member WHERE team_id = ? AND name = ?")
-    .get(teamInfo.teamId, args.member) as { session_id: string; status: string } | null
-  if (!member) throw new Error(`Teammate "${args.member}" not found in team "${teamInfo.teamName}"`)
-
-  const text = args.approved
-    ? `Your plan has been APPROVED.${args.feedback ? ` Feedback: ${args.feedback}` : " Proceed with implementation."}`
-    : `Your plan has been REJECTED. Please revise and resubmit.${args.feedback ? ` Feedback: ${args.feedback}` : ""}`
-
-  // Send approval/rejection message to teammate
-  const msgId = sendMessage(deps.db, {
-    teamId: teamInfo.teamId,
-    from: "lead",
-    to: args.member,
-    content: text,
-  })
-
-  await deps.client.session.promptAsync({
-    path: { id: member.session_id },
-    body: { parts: [{ type: "text", text: `[Plan ${args.approved ? "approved" : "rejected"} by lead]: ${text}` }] },
-  })
-
-  markDelivered(deps.db, msgId)
-
-  return `Plan ${args.approved ? "approved" : "rejected"} for ${args.member}.${args.feedback ? ` Feedback: ${args.feedback}` : ""}`
-}