backeer-opencode 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `backeer-opencode` are documented here.
 
+## 0.2.3 - 2026-09-01
+
+- Keep conversation feedback queued while OpenCode permission or question UI is
+  active, even if OpenCode emits an intermediate `session.idle` event.
+- Wait for the interaction reply and the following real idle transition before
+  injecting an ignored Backeer status message into the conversation.
+- Add regression coverage for permission and question UI lifecycles.
+
 ## 0.2.2 - 2026-09-01
 
 - Show user-facing Backeer delivery and decision results in the OpenCode

package/README.md

@@ -165,8 +165,9 @@ Backeer ✓ Decision applied: Always allow
 
 These entries are marked `noReply` and `ignored`, so they are visible without
 starting another agent turn or entering model context. Feedback generated while
-an agent is active is queued until the session becomes idle; it never writes to
-the user's input field.
+an agent is active, a permission prompt is open, or a question is awaiting an
+answer remains queued until the interaction closes and the session becomes idle.
+It never writes to the user's input field or replaces interactive OpenCode UI.
 
 Technical diagnostics use OpenCode's structured application log API instead of
 stdout. Normal `info` logging omits HTTP details; set

package/dist/backeer-permission.js

@@ -404,7 +404,7 @@ import { randomUUID } from "node:crypto";
 import { statSync } from "node:fs";
 
 // src/updates.js
-var PLUGIN_VERSION = "0.2.2";
+var PLUGIN_VERSION = "0.2.3";
 var PACKAGE_NAME = "backeer-opencode";
 var NPM_REGISTRY_URL = "https://registry.npmjs.org";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -650,6 +650,13 @@ var FEEDBACK_SYMBOLS = {
   warning: "!",
   error: "\xD7"
 };
+var QUESTION_ASKED_EVENTS = /* @__PURE__ */ new Set(["question.asked", "question.v2.asked"]);
+var QUESTION_REPLIED_EVENTS = /* @__PURE__ */ new Set([
+  "question.replied",
+  "question.v2.replied",
+  "question.answered",
+  "question.v2.answered"
+]);
 async function sendSessionMessage(client, sessionID, text) {
   if (typeof client?.session?.prompt !== "function") {
     throw new Error("OpenCode session messaging is unavailable");
@@ -672,16 +679,22 @@ function createConversationFeedback({ client, reporter }) {
   function sessionState(sessionID) {
     let state = sessions.get(sessionID);
     if (!state) {
-      state = { idle: false, flushing: false, queue: [], queued: /* @__PURE__ */ new Set() };
+      state = {
+        idle: false,
+        flushing: false,
+        blockers: /* @__PURE__ */ new Set(),
+        queue: [],
+        queued: /* @__PURE__ */ new Set()
+      };
       rememberBounded(sessions, sessionID, state);
     }
     return state;
   }
   async function flush(sessionID, state) {
-    if (disposed || state.flushing || !state.idle || state.queue.length === 0) return;
+    if (disposed || state.flushing || !state.idle || state.blockers.size > 0 || state.queue.length === 0) return;
     state.flushing = true;
     try {
-      while (!disposed && state.idle && state.queue.length > 0) {
+      while (!disposed && state.idle && state.blockers.size === 0 && state.queue.length > 0) {
         const item = state.queue[0];
         try {
           await sendSessionMessage(
@@ -711,7 +724,7 @@ function createConversationFeedback({ client, reporter }) {
       const removed = state.queue.shift();
       state.queued.delete(removed.key);
     }
-    if (state.idle) void flush(sessionID, state);
+    if (state.idle && state.blockers.size === 0) void flush(sessionID, state);
   }
   function setIdle(sessionID, idle) {
     if (typeof sessionID !== "string" || !sessionID) return;
@@ -719,6 +732,24 @@ function createConversationFeedback({ client, reporter }) {
     state.idle = idle;
     if (idle) void flush(sessionID, state);
   }
+  function interactionKey(kind, event) {
+    const value = event.properties?.requestID ?? event.properties?.id;
+    return `${kind}:${typeof value === "string" && value ? value : "pending"}`;
+  }
+  function beginInteraction(sessionID, kind, event) {
+    const state = sessionState(sessionID);
+    state.idle = false;
+    state.blockers.add(interactionKey(kind, event));
+  }
+  function endInteraction(sessionID, kind, event) {
+    const state = sessionState(sessionID);
+    const key = interactionKey(kind, event);
+    if (!state.blockers.delete(key)) {
+      const fallback = [...state.blockers].find((blocker) => blocker.startsWith(`${kind}:`));
+      if (fallback) state.blockers.delete(fallback);
+    }
+    state.idle = false;
+  }
   return {
     info: (sessionID, message) => enqueue("info", sessionID, message),
     success: (sessionID, message) => enqueue("success", sessionID, message),
@@ -734,8 +765,20 @@ function createConversationFeedback({ client, reporter }) {
         else if (status === "busy" || status === "retry") setIdle(sessionID, false);
       } else if (event.type === "session.idle") {
         setIdle(sessionID, true);
-      } else if (event.type === "permission.asked" || event.type === "question.asked" || event.type === "question.v2.asked" || event.type === "todo.updated") {
+      } else if (event.type === "permission.asked") {
+        beginInteraction(sessionID, "permission", event);
+      } else if (QUESTION_ASKED_EVENTS.has(event.type)) {
+        beginInteraction(sessionID, "question", event);
+      } else if (event.type === "permission.replied") {
+        endInteraction(sessionID, "permission", event);
+      } else if (QUESTION_REPLIED_EVENTS.has(event.type)) {
+        endInteraction(sessionID, "question", event);
+      } else if (event.type === "todo.updated") {
         setIdle(sessionID, false);
+      } else if (event.type === "session.error") {
+        const state = sessionState(sessionID);
+        state.blockers.clear();
+        state.idle = false;
       } else if (event.type === "session.deleted") {
         sessions.delete(sessionID);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backeer-opencode",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Backeer lifecycle notifications and remote permission decisions for OpenCode",
   "type": "module",
   "main": "./src/index.js",

package/src/session-messages.js

@@ -8,6 +8,14 @@ const FEEDBACK_SYMBOLS = {
   error: "×",
 }
 
+const QUESTION_ASKED_EVENTS = new Set(["question.asked", "question.v2.asked"])
+const QUESTION_REPLIED_EVENTS = new Set([
+  "question.replied",
+  "question.v2.replied",
+  "question.answered",
+  "question.v2.answered",
+])
+
 export async function sendSessionMessage(client, sessionID, text) {
   if (typeof client?.session?.prompt !== "function") {
     throw new Error("OpenCode session messaging is unavailable")
@@ -33,17 +41,29 @@ export function createConversationFeedback({ client, reporter }) {
   function sessionState(sessionID) {
     let state = sessions.get(sessionID)
     if (!state) {
-      state = { idle: false, flushing: false, queue: [], queued: new Set() }
+      state = {
+        idle: false,
+        flushing: false,
+        blockers: new Set(),
+        queue: [],
+        queued: new Set(),
+      }
       rememberBounded(sessions, sessionID, state)
     }
     return state
   }
 
   async function flush(sessionID, state) {
-    if (disposed || state.flushing || !state.idle || state.queue.length === 0) return
+    if (
+      disposed || state.flushing || !state.idle ||
+      state.blockers.size > 0 || state.queue.length === 0
+    ) return
     state.flushing = true
     try {
-      while (!disposed && state.idle && state.queue.length > 0) {
+      while (
+        !disposed && state.idle && state.blockers.size === 0 &&
+        state.queue.length > 0
+      ) {
         const item = state.queue[0]
         try {
           await sendSessionMessage(
@@ -75,7 +95,7 @@ export function createConversationFeedback({ client, reporter }) {
       const removed = state.queue.shift()
       state.queued.delete(removed.key)
     }
-    if (state.idle) void flush(sessionID, state)
+    if (state.idle && state.blockers.size === 0) void flush(sessionID, state)
   }
 
   function setIdle(sessionID, idle) {
@@ -85,6 +105,30 @@ export function createConversationFeedback({ client, reporter }) {
     if (idle) void flush(sessionID, state)
   }
 
+  function interactionKey(kind, event) {
+    const value = event.properties?.requestID ?? event.properties?.id
+    return `${kind}:${typeof value === "string" && value ? value : "pending"}`
+  }
+
+  function beginInteraction(sessionID, kind, event) {
+    const state = sessionState(sessionID)
+    state.idle = false
+    state.blockers.add(interactionKey(kind, event))
+  }
+
+  function endInteraction(sessionID, kind, event) {
+    const state = sessionState(sessionID)
+    const key = interactionKey(kind, event)
+    if (!state.blockers.delete(key)) {
+      const fallback = [...state.blockers]
+        .find((blocker) => blocker.startsWith(`${kind}:`))
+      if (fallback) state.blockers.delete(fallback)
+    }
+    // The reply event can arrive before OpenCode has removed its permission UI
+    // or resumed the agent. Wait for the next idle event before injecting text.
+    state.idle = false
+  }
+
   return {
     info: (sessionID, message) => enqueue("info", sessionID, message),
     success: (sessionID, message) => enqueue("success", sessionID, message),
@@ -102,13 +146,20 @@ export function createConversationFeedback({ client, reporter }) {
         else if (status === "busy" || status === "retry") setIdle(sessionID, false)
       } else if (event.type === "session.idle") {
         setIdle(sessionID, true)
-      } else if (
-        event.type === "permission.asked" ||
-        event.type === "question.asked" ||
-        event.type === "question.v2.asked" ||
-        event.type === "todo.updated"
-      ) {
+      } else if (event.type === "permission.asked") {
+        beginInteraction(sessionID, "permission", event)
+      } else if (QUESTION_ASKED_EVENTS.has(event.type)) {
+        beginInteraction(sessionID, "question", event)
+      } else if (event.type === "permission.replied") {
+        endInteraction(sessionID, "permission", event)
+      } else if (QUESTION_REPLIED_EVENTS.has(event.type)) {
+        endInteraction(sessionID, "question", event)
+      } else if (event.type === "todo.updated") {
         setIdle(sessionID, false)
+      } else if (event.type === "session.error") {
+        const state = sessionState(sessionID)
+        state.blockers.clear()
+        state.idle = false
       } else if (event.type === "session.deleted") {
         sessions.delete(sessionID)
       }

package/src/updates.js

@@ -1,4 +1,4 @@
-export const PLUGIN_VERSION = "0.2.2"
+export const PLUGIN_VERSION = "0.2.3"
 
 const PACKAGE_NAME = "backeer-opencode"
 const NPM_REGISTRY_URL = "https://registry.npmjs.org"