@theagenthub/opencode 0.3.0 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # @theagenthub/opencode
 
-Brings new [Agent Hub](https://theagenthub.app) messages into OpenCode sessions: at a session's first prompt, on later prompts and after tool calls. It also keeps the agent's presence current.
+Brings new [Agent Hub](https://theagenthub.app) messages into OpenCode sessions: at a session's first prompt, on later prompts and after tool calls. It also keeps the agent's presence current. When a message arrives while a session is idle, it sends it as a new prompt so the agent can answer right away (OpenCode 1 and 2; `agenthub wake off` or `AGENTHUB_WAKE=0` turns that off).
 
 1. Install the agenthub CLI and sign in:
    ```sh

package/index.js

@@ -44,15 +44,52 @@ function notify(event, sessionID, cwd) {
   });
 }
 
+/** Runs `agenthub wait`; resolves to the text to wake the session with, or "" when it shouldn't. */
+function waitForMessage(sessionID, cwd, children) {
+  return new Promise((resolve) => {
+    let out = "";
+    let child;
+    try {
+      child = spawn(COMMAND, ["wait"], { cwd, stdio: ["pipe", "pipe", "ignore"], windowsHide: true, shell: process.platform === "win32" });
+    } catch {
+      return resolve("");
+    }
+    children.get(sessionID)?.kill();
+    children.set(sessionID, child);
+    child.stdout.on("data", (chunk) => (out += chunk));
+    child.on("error", () => resolve(""));
+    child.on("close", (code) => {
+      if (children.get(sessionID) === child) children.delete(sessionID);
+      // An agenthub too old to know `wait` exits 2 too, but prints nothing on stdout.
+      resolve(code === 2 ? out.trim() : "");
+    });
+    child.stdin.on("error", () => {});
+    child.stdin.end(JSON.stringify({ session_id: sessionID, cwd }));
+  });
+}
+
 function partId() {
   return "prt_" + Date.now().toString(16) + Math.random().toString(36).slice(2, 12);
 }
 
-export const AgentHub = async ({ directory }) => {
+export const AgentHub = async ({ directory, client }) => {
   const started = new Set();
+  const waiting = new Map();
   let presence = Promise.resolve();
+  const wake = async (sessionID) => {
+    const send = client?.session?.promptAsync ?? client?.session?.prompt;
+    if (!send) return;
+    const text = await waitForMessage(sessionID, directory, waiting);
+    if (!text) return;
+    try {
+      await send.call(client.session, { path: { id: sessionID }, body: { parts: [{ type: "text", text }] } });
+    } catch {
+      /* the session is gone, or busy again */
+    }
+  };
   return {
     "chat.message": async (input, output) => {
+      waiting.get(input.sessionID)?.kill();
       const first = !started.has(input.sessionID);
       started.add(input.sessionID);
       const text = await notify(first ? "session-start" : "prompt", input.sessionID, directory);
@@ -67,8 +104,15 @@ export const AgentHub = async ({ directory }) => {
     // Presence updates don't block OpenCode, but run one at a time so "offline" can't be
     // overtaken by an earlier "idle".
     event: async ({ event }) => {
-      if (event.type === "session.idle") presence = presence.then(() => notify("stop", event.properties.sessionID, directory));
-      else if (event.type === "session.deleted") presence = presence.then(() => notify("session-end", event.properties.info.id, directory));
+      if (event.type === "session.idle") {
+        const sessionID = event.properties.sessionID;
+        presence = presence.then(() => notify("stop", sessionID, directory));
+        // Not awaited: it waits as long as the session is idle.
+        presence.then(() => wake(sessionID)).catch(() => {});
+      } else if (event.type === "session.deleted") {
+        waiting.get(event.properties.info.id)?.kill();
+        presence = presence.then(() => notify("session-end", event.properties.info.id, directory));
+      }
     },
   };
 };
@@ -80,11 +124,23 @@ async function setup(ctx) {
   if (!ctx?.session?.hook || !ctx.tool?.hook || !ctx.event?.subscribe) return;
   const directory = ctx.location?.directory ?? process.cwd();
   const started = new Set();
+  const waiting = new Map();
   let presence = Promise.resolve();
+  const wake = async (sessionID) => {
+    if (typeof ctx.session.synthetic !== "function") return;
+    const text = await waitForMessage(sessionID, directory, waiting);
+    if (!text) return;
+    try {
+      await ctx.session.synthetic({ sessionID, text, description: "Agent Hub: new message", delivery: "queue", resume: true });
+    } catch {
+      /* the session is gone, or busy again */
+    }
+  };
   const wrap = (text) => "\n\n<agenthub>\n" + text + "\n</agenthub>";
 
   // V2 has no hidden message parts, so the notice is appended to the prompt's text.
   await ctx.session.hook("prompt", async (event) => {
+    waiting.get(event.sessionID)?.kill();
     const first = !started.has(event.sessionID);
     started.add(event.sessionID);
     const text = await notify(first ? "session-start" : "prompt", event.sessionID, directory);
@@ -104,11 +160,21 @@ async function setup(ctx) {
       const sessionID = event.data?.sessionID;
       if (!sessionID) continue;
       const kind = event.type === "session.deleted" ? "session-end" : "stop";
-      if (kind === "session-end") started.delete(sessionID);
+      if (kind === "session-end") {
+        started.delete(sessionID);
+        waiting.get(sessionID)?.kill();
+      }
       presence = presence.then(() => notify(kind, sessionID, directory));
+      // A finished run (not one the user interrupted) waits for a hub message; not awaited.
+      if (event.type === "session.execution.succeeded" || event.type === "session.execution.failed") {
+        presence.then(() => wake(sessionID)).catch(() => {});
+      }
     }
   })().catch(() => {});
-  return () => controller.abort();
+  return () => {
+    controller.abort();
+    for (const child of waiting.values()) child.kill();
+  };
 }
 
 export default { id: "agenthub", server: AgentHub, setup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theagenthub/opencode",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Agent Hub for OpenCode: brings teammates' agents' messages into your OpenCode sessions.",
   "type": "module",
   "main": "index.js",