@rrr2010/opencode-roundtable 0.2.0 → 0.3.2

package/dist/index.js

@@ -28,7 +28,8 @@ var DEFAULT_CONFIG = {
     "5. **Suggested next steps**"
   ].join(`
 `),
-  maxRounds: 10
+  maxRounds: 10,
+  navigation: "link"
 };
 var config = { ...DEFAULT_CONFIG };
 function getConfig() {
@@ -40,7 +41,8 @@ function validateConfig(raw) {
     loopSimilarityThreshold: typeof raw.loopSimilarityThreshold === "number" && raw.loopSimilarityThreshold >= 0 && raw.loopSimilarityThreshold <= 1 ? raw.loopSimilarityThreshold : DEFAULT_CONFIG.loopSimilarityThreshold,
     toolOutputPreviewMax: typeof raw.toolOutputPreviewMax === "number" && raw.toolOutputPreviewMax >= 100 ? raw.toolOutputPreviewMax : DEFAULT_CONFIG.toolOutputPreviewMax,
     defaultObserverPrompt: typeof raw.defaultObserverPrompt === "string" && raw.defaultObserverPrompt.length > 0 ? raw.defaultObserverPrompt : DEFAULT_CONFIG.defaultObserverPrompt,
-    maxRounds: typeof raw.maxRounds === "number" && raw.maxRounds >= 1 ? raw.maxRounds : DEFAULT_CONFIG.maxRounds
+    maxRounds: typeof raw.maxRounds === "number" && raw.maxRounds >= 1 ? raw.maxRounds : DEFAULT_CONFIG.maxRounds,
+    navigation: raw.navigation === "selectSession" || raw.navigation === "none" || raw.navigation === "auto" ? raw.navigation : DEFAULT_CONFIG.navigation
   };
 }
 async function loadConfig(ctx) {
@@ -91,43 +93,31 @@ async function loadConfig(ctx) {
 }
 
 // src/state.ts
+import { readFile as readFile2, writeFile as writeFile2, unlink, readdir, mkdir } from "fs/promises";
+import { join as join2 } from "path";
+import os2 from "os";
+var statesDir = (() => {
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+  const base = xdgConfigHome ? join2(xdgConfigHome, "opencode") : join2(os2.homedir(), ".config", "opencode");
+  return join2(base, "roundtable-states");
+})();
 var states = new Map;
 var timeoutHandles = new Map;
 var pendingResults = new Map;
-function serializeState(state) {
-  const json = JSON.stringify(state);
-  return `[ROUNDTABLE META — INTERNAL ORCHESTRATION DATA — IGNORE FOR ANALYSIS] ${json} [/ROUNDTABLE META]`;
+function stateFilePath(sessionID) {
+  return join2(statesDir, `${sessionID}.json`);
 }
-function findSerializedState(messages) {
-  let last = null;
-  for (const msg of messages) {
-    if (msg.info.role !== "user")
-      continue;
-    for (const part of msg.parts) {
-      if (part.type === "text" && part.text.startsWith("[ROUNDTABLE META")) {
-        last = part.text;
-      }
-    }
-  }
-  return last;
+async function saveStateFile(state) {
+  try {
+    await mkdir(statesDir, { recursive: true });
+  } catch {}
+  const filePath = stateFilePath(state.sessionID);
+  await writeFile2(filePath, JSON.stringify(state, null, 2), "utf-8");
 }
-function deserializeState(raw) {
+async function loadStateFile(sessionID) {
   try {
-    const endTag = "[/ROUNDTABLE META]";
-    const startIdx = raw.indexOf("[ROUNDTABLE META");
-    if (startIdx === -1)
-      return null;
-    const closeBracket = raw.indexOf("]", startIdx);
-    if (closeBracket === -1)
-      return null;
-    const contentStart = closeBracket + 1;
-    const endIdx = raw.indexOf(endTag, contentStart);
-    if (endIdx === -1)
-      return null;
-    const json = raw.slice(contentStart, endIdx).trim();
-    if (!json)
-      return null;
-    const parsed = JSON.parse(json);
+    const content = await readFile2(stateFilePath(sessionID), "utf-8");
+    const parsed = JSON.parse(content);
     if (typeof parsed !== "object" || !parsed)
       return null;
     if (typeof parsed.sessionID !== "string")
@@ -161,6 +151,19 @@ function deserializeState(raw) {
     return null;
   }
 }
+async function deleteStateFile(sessionID) {
+  try {
+    await unlink(stateFilePath(sessionID));
+  } catch {}
+}
+async function listStateFiles() {
+  try {
+    const entries = await readdir(statesDir);
+    return entries.filter((e) => e.endsWith(".json")).map((e) => e.replace(/\.json$/, ""));
+  } catch {
+    return [];
+  }
+}
 
 // src/utils.ts
 function generateDefaultTitle(args) {
@@ -334,13 +337,44 @@ Continuation: ${extendPrompt}`;
   ].join(`
 `);
 }
+async function navigateToSession(ctx, targetID, _parentID) {
+  try {
+    if (typeof ctx.client.tui.selectSession === "function") {
+      await ctx.client.tui.selectSession({ sessionID: targetID });
+      return true;
+    }
+    await ctx.client.tui.publish({
+      body: {
+        type: "tui.session.select",
+        properties: { sessionID: targetID }
+      }
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function scanOrphanRoundtables(ctx) {
+  const sessionIDs = await listStateFiles();
+  let loaded = 0;
+  let errors = 0;
+  for (const sid of sessionIDs) {
+    try {
+      const state = await loadStateFile(sid);
+      if (state) {
+        states.set(sid, state);
+        loaded++;
+      }
+    } catch {
+      errors++;
+    }
+  }
   await ctx.client.app.log({
     body: {
       service: "roundtable",
       level: "debug",
-      message: "scanOrphanRoundtables initialized (Phase 1 — no scanning yet; " + "full implementation in Phase 4)",
-      extra: { phase: 1 }
+      message: `scanOrphanRoundtables: ${loaded} state(s) loaded, ${errors} error(s)`,
+      extra: { loaded, errors, total: sessionIDs.length }
     }
   });
 }
@@ -352,7 +386,6 @@ function buildAgentPrompt(state, agent) {
   const roundInfo = `Round ${state.currentRound + 1}/${state.totalRounds} | Current agent: ${agent}`;
   if (state.currentRound === 0 && state.currentAgentIndex === 0) {
     lines.push(`[System] You are participating in a roundtable debate. Agents (${agentList}) will discuss the topic below in ${state.totalRounds} round(s).`);
-    lines.push(`[System] The [ROUNDTABLE META] block above is internal routing data — ignore it for all analysis. Focus only on the topic given in [Topic] below.`);
     lines.push(`[Topic] ${state.prompt}`);
     lines.push("");
   }
@@ -366,11 +399,11 @@ function buildAgentPrompt(state, agent) {
 `);
 }
 function buildObserverPrompt(state, observer) {
-  const observerPrompt = getConfig().defaultObserverPrompt;
+  const observerPrompt = state.observerPrompt ?? getConfig().defaultObserverPrompt;
   if (observer === "built-in")
     return observerPrompt;
   return `You are an impartial roundtable observer.
-` + `Your role: ${observer}. Provide an executive summary of the debate.
+` + `Your role: ${observer}.
 
 ` + observerPrompt;
 }
@@ -379,7 +412,10 @@ function buildObserverPrompt(state, observer) {
 async function startNewRoundtable(ctx, args, toolCtx) {
   const agents = args.agents;
   const newSession = await ctx.client.session.create({
-    body: { title: generateDefaultTitle({ ...args, agents }) }
+    body: {
+      title: generateDefaultTitle({ ...args, agents }),
+      parentID: toolCtx.sessionID
+    }
   });
   const sessionID = newSession.data.id;
   const parentSessionID = toolCtx.sessionID;
@@ -397,14 +433,12 @@ async function startNewRoundtable(ctx, args, toolCtx) {
     errors: [],
     createdAt: Date.now(),
     currentGeneration: 0,
-    userInterjections: []
+    userInterjections: [],
+    observerPrompt: args.observerPrompt
   };
   states.set(sessionID, state);
   try {
-    await ctx.client.session.prompt({
-      path: { id: sessionID },
-      body: { noReply: true, parts: [{ type: "text", text: serializeState(state) }] }
-    });
+    await saveStateFile(state);
     await sendToAgent(ctx, state);
     await ctx.client.session.prompt({
       path: { id: parentSessionID },
@@ -412,10 +446,20 @@ async function startNewRoundtable(ctx, args, toolCtx) {
         noReply: true,
         parts: [{
           type: "text",
-          text: `The roundtable has started (agents: ${agents.join(", ")}, ${args.rounds} round(s)). To extend it later, use the tool roundtable({sessionID: "${sessionID}", rounds: N, prompt: "..."})`
+          text: `⚙ Roundtable started — #${sessionID} • ${agents.join(" → ")} • ${args.rounds} round(s)`
         }]
       }
     });
+    await ctx.client.session.prompt({
+      path: { id: sessionID },
+      body: {
+        noReply: true,
+        parts: [{ type: "text", text: `⚙ Parent: #${parentSessionID}` }]
+      }
+    });
+    if (getConfig().navigation === "auto") {
+      await navigateToSession(ctx, sessionID, parentSessionID);
+    }
     await ctx.client.tui.showToast({
       body: {
         message: `Roundtable started in #${sessionID} (${agents.join(" → ")} · ${args.rounds} round(s))`,
@@ -473,10 +517,13 @@ async function sendToAgent(ctx, state) {
   }
 }
 async function updateSessionTitle(ctx, state) {
-  const summary = state.prompt.length > 60 ? state.prompt.slice(0, 57) + "..." : state.prompt;
+  const summary = state.prompt.length > 40 ? state.prompt.slice(0, 37) + "..." : state.prompt;
+  const agentList = state.agents.join("→");
+  const roundInfo = `R${state.currentRound + 1}/${state.totalRounds}`;
+  const title = `⚡ "${summary}" · ${agentList} (${roundInfo} · ↑ #${state.parentSessionID})`;
   await ctx.client.session.update({
     path: { id: state.sessionID },
-    body: { title: `(Roundtable) - ${summary}` }
+    body: { title }
   });
 }
 async function sendObserverPrompt(ctx, state) {
@@ -522,17 +569,17 @@ async function finalizeRoundtable(ctx, state) {
       pendingResults.delete(sessionID);
     }
     await injectRoundtableDelimiter(ctx, sessionID);
-    const shortPrompt = state.prompt.length > 50 ? state.prompt.slice(0, 47) + "..." : state.prompt;
+    const shortPrompt = state.prompt.length > 40 ? state.prompt.slice(0, 37) + "..." : state.prompt;
     await ctx.client.session.update({
       path: { id: sessionID },
-      body: { title: `(Roundtable) - ${shortPrompt} · CONCLUDED` }
+      body: { title: `⚡ "${shortPrompt}" · ${state.agents.join("→")} ✓` }
     });
     try {
-      await ctx.client.session.prompt({
-        path: { id: sessionID },
-        body: { noReply: true, parts: [{ type: "text", text: serializeState(state) }] }
-      });
+      await saveStateFile(state);
     } catch {}
+    if (getConfig().navigation === "auto") {
+      await navigateToSession(ctx, state.parentSessionID, sessionID);
+    }
     await ctx.client.tui.showToast({
       body: { message: "Roundtable concluded", variant: "success" }
     });
@@ -569,7 +616,7 @@ async function processNextTurn(ctx, state) {
   const userMsgs = messages.filter((m) => m.info.role === "user");
   for (const msg of userMsgs) {
     for (const part of msg.parts) {
-      if (part.type === "text" && !part.text.includes("[ROUNDTABLE META")) {
+      if (part.type === "text") {
         if (!state.userInterjections.includes(part.text)) {
           state.userInterjections.push(part.text);
         }
@@ -597,6 +644,7 @@ async function processNextTurn(ctx, state) {
       hasError: response === null
     };
     state.history.push(entry);
+    await saveStateFile(state);
     await ctx.client.app.log({
       body: {
         service: "roundtable",
@@ -657,6 +705,7 @@ async function processNextTurn(ctx, state) {
       toolCalls: [],
       hasError: summary === null
     });
+    await saveStateFile(state);
     state.phase = "done";
     await finalizeRoundtable(ctx, state);
   }
@@ -664,6 +713,7 @@ async function processNextTurn(ctx, state) {
 async function handleAgentError(ctx, state, event) {
   if (state.phase === "observing" || state.phase === "done") {
     state.phase = "aborted";
+    await saveStateFile(state);
     await finalizeRoundtable(ctx, state);
     return;
   }
@@ -694,6 +744,7 @@ async function handleAgentError(ctx, state, event) {
         }
       });
     } catch {}
+    await saveStateFile(state);
     await sendToAgent(ctx, state);
   } else if (state.currentRound + 1 < state.totalRounds) {
     state.currentRound++;
@@ -708,6 +759,7 @@ async function handleAgentError(ctx, state, event) {
         }
       });
     } catch {}
+    await saveStateFile(state);
     await sendToAgent(ctx, state);
   } else {
     state.phase = "aborted";
@@ -716,6 +768,7 @@ async function handleAgentError(ctx, state, event) {
         body: { message: "All agents failed — roundtable aborted", variant: "error" }
       });
     } catch {}
+    await saveStateFile(state);
     await finalizeRoundtable(ctx, state);
   }
 }
@@ -725,6 +778,7 @@ async function handleSessionDeleted(ctx, state, deletedSessionID) {
     clearTimeout(handle);
     timeoutHandles.delete(state.sessionID);
   }
+  await deleteStateFile(state.sessionID);
   if (deletedSessionID === state.sessionID) {
     state.phase = "aborted";
     const partialSummary = buildConsolidatedSummary(state);
@@ -780,47 +834,15 @@ async function extendRoundtable(ctx, args, _toolCtx) {
   } catch {
     return `Error: Session #${sessionID} not found or inaccessible. Cannot extend.`;
   }
-  let messagesData;
-  try {
-    messagesData = await ctx.client.session.messages({ path: { id: sessionID } });
-  } catch {
-    return `Error: Could not read messages from session #${sessionID}`;
-  }
-  const serializedRaw = findSerializedState(messagesData.data);
-  if (!serializedRaw) {
+  const originalState = await loadStateFile(sessionID);
+  if (!originalState) {
     return [
-      `Error: No roundtable state found in session #${sessionID}.`,
-      "This session is not a roundtable or the state was lost during compaction."
+      `Error: No roundtable state found for session #${sessionID}.`,
+      "This session is not a roundtable or the state file was deleted."
     ].join(`
 `);
   }
-  const originalState = deserializeState(serializedRaw);
-  if (!originalState) {
-    return `Error: Corrupt roundtable state in session #${sessionID}. Cannot extend.`;
-  }
-  if (originalState.phase === "done") {} else if (originalState.phase === "active") {
-    const assistantCount = messagesData.data.filter((m) => m.info.role === "assistant").length;
-    const expectedAssistantCount = originalState.totalRounds * originalState.agents.length + 1;
-    if (assistantCount >= expectedAssistantCount) {
-      originalState.phase = "done";
-      try {
-        await ctx.client.app.log({
-          body: {
-            service: "roundtable",
-            level: "info",
-            message: `Recovered stuck session #${sessionID}: phase was active but ${assistantCount} assistant msgs suggest debate completed.`,
-            extra: { sessionID, assistantCount, expectedAssistantCount }
-          }
-        });
-      } catch {}
-    } else {
-      return [
-        `Error: Roundtable #${sessionID} is still active (phase: ${originalState.phase}).`,
-        "Cannot extend until the roundtable concludes."
-      ].join(`
-`);
-    }
-  } else {
+  if (originalState.phase !== "done") {
     return [
       `Error: Roundtable #${sessionID} is in state "${originalState.phase}" and cannot be extended.`
     ].join(`
@@ -862,14 +884,12 @@ async function extendRoundtable(ctx, args, _toolCtx) {
     errors: [...originalState.errors],
     createdAt: Date.now(),
     currentGeneration: 0,
-    userInterjections: [...originalState.userInterjections ?? []]
+    userInterjections: [...originalState.userInterjections ?? []],
+    observerPrompt: args.observerPrompt ?? originalState.observerPrompt
   };
   states.set(sessionID, newState);
   try {
-    await ctx.client.session.prompt({
-      path: { id: sessionID },
-      body: { noReply: true, parts: [{ type: "text", text: serializeState(newState) }] }
-    });
+    await saveStateFile(newState);
     const agentList = originalState.agents.join(" vs ");
     await ctx.client.session.update({
       path: { id: sessionID },
@@ -881,7 +901,7 @@ async function extendRoundtable(ctx, args, _toolCtx) {
         noReply: true,
         parts: [{
           type: "text",
-          text: `The roundtable has been extended (${args.rounds} more round(s)). To extend again, use the tool roundtable({sessionID: "${sessionID}", rounds: N, prompt: "..."})`
+          text: `⚙ Roundtable extended — #${sessionID} • +${args.rounds} round(s)`
         }]
       }
     });
@@ -954,16 +974,19 @@ var RoundtablePlugin = async (ctx) => {
 
 ` + "Note: this tool injects system-level prompts into each agent's context during " + `the debate (role-setting, topic, turn routing, and lifecycle signals).
 
+` + "IMPORTANT: This tool requires 2+ agents. For single-agent tasks, use a regular " + `session prompt instead — do NOT use roundtable.
+
 ` + "Choosing agents: select agents based on their expertise (e.g., pm for product decisions, " + "dev for technical trade-offs, rv for code review). You can also specify in the prompt " + `what each agent should focus on (e.g., 'pm: focus on cost; dev: focus on maintainability').
 
 ` + "Multiple rounds: for complex topics, use 2+ rounds and INCLUDE per-round focus " + "instructions IN the prompt itself (e.g., prompt: 'Round 1: list pros. Round 2: " + "list cons. Round 3: propose an implementation plan'). This way all agents see " + "the full agenda. The default is 1 round.",
         args: {
-          agents: tool.schema.array(tool.schema.string()).min(2).describe("Agent names in speaking order (minimum 2). Choose agents based on " + 'their expertise — each brings a different perspective. Example: ["pm", "dev", "rv"]'),
+          agents: tool.schema.array(tool.schema.string()).min(2).describe("Agent names in speaking order (minimum 2). For single-agent tasks, use a regular " + "session — do NOT use roundtable. Choose agents based on their expertise — " + 'each brings a different perspective. Example: ["pm", "dev", "rv"]'),
           prompt: tool.schema.string().describe("Topic or challenge for the agents to debate. For multi-round debates, " + "include per-round instructions here (e.g., 'Round 1: pros. Round 2: cons. " + "Round 3: plan.'). All agents will see this and follow the round structure."),
           rounds: tool.schema.number().min(1).max(50).describe("Number of complete rounds (each round = all agents speak once). " + "Default: 1. Max: 50. For complex topics with 2+ rounds, include per-round focus " + "instructions in the prompt parameter so all agents see the agenda."),
           observer: tool.schema.string().optional().describe("Agent name for final consolidation. The observer does not debate — it " + "summarizes after all rounds. Omit to use the built-in observer."),
           sessionID: tool.schema.string().optional().describe("Session ID (format: ses_xxxx) from a previous roundtable call to " + "continue a concluded debate. Omit this parameter and pass agents + " + "prompt to start a fresh debate."),
-          title: tool.schema.string().optional().describe("Custom title for the session (max 200 chars). If omitted, auto-generated " + 'as "(Roundtable) - {first 80 chars of prompt, truncated at word boundary}".')
+          title: tool.schema.string().optional().describe("Custom title for the session (max 200 chars). If omitted, auto-generated " + 'as "(Roundtable) - {first 80 chars of prompt, truncated at word boundary}".'),
+          observerPrompt: tool.schema.string().optional().describe("Override the default observer consolidation prompt. Use this to control " + "the format and focus of the final summary — e.g., ask the observer to " + "save a detailed report to file, focus on technical decisions only, " + "output as JSON, extract action items, etc. " + "If omitted, the default observer prompt is used (executive summary).")
         },
         async execute(args, toolCtx) {
           try {
@@ -1020,6 +1043,22 @@ var RoundtablePlugin = async (ctx) => {
             return "Error: Could not fetch agent list. The server might not be ready.";
           }
         }
+      }),
+      active_roundtables: tool({
+        description: "Lists all active roundtables with their status. " + "Each entry shows session ID, agents, current round, and phase. " + "Returns clickable session IDs that can be used to navigate.",
+        args: {},
+        async execute() {
+          const active = [];
+          for (const [sid, s] of states) {
+            const status = s.phase === "active" ? "debating" : s.phase === "observing" ? "consolidating" : s.phase === "done" ? "concluded" : s.phase;
+            active.push(`- #${sid} · ${s.agents.join("→")} (R${s.currentRound + 1}/${s.totalRounds}) · ${status}`);
+          }
+          if (active.length === 0)
+            return "No active roundtables.";
+          return `Active roundtables:
+${active.join(`
+`)}`;
+        }
       })
     }
   };
@@ -1028,5 +1067,5 @@ export {
   RoundtablePlugin
 };
 
-//# debugId=3293C14B588953DF64756E2164756E21
+//# debugId=C8BED17810CFAA4D64756E2164756E21
 //# sourceMappingURL=index.js.map