opencode-heartbeat-approval 0.3.0 → 0.3.1

package/dist/index.js

@@ -13,6 +13,7 @@ var __export = (target, all) => {
 // src/plugin.ts
 import { readFile } from "fs/promises";
 import { join } from "path";
+import { homedir } from "os";
 
 // node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -12337,23 +12338,17 @@ tool.schema = exports_external;
 // src/plugin.ts
 var POLL_INTERVAL_MS = 1e4;
 var JSON_HEADERS = { "Content-Type": "application/json" };
-async function discoverRunnerUrl(directory) {
+var SESSION_MAP_PATH = join(homedir(), ".config", "opencode", "heartbeat", "session-map.json");
+async function lookupSessionMapping(sessionId) {
   try {
-    const configPath = join(directory, "heartbeat.json");
-    const text = await readFile(configPath, "utf-8");
-    const config2 = JSON.parse(text);
-    const web = config2?.web;
-    const port = web?.port;
-    if (typeof port === "number" && Number.isInteger(port) && port > 0 && port < 65536) {
-      return `http://127.0.0.1:${port}`;
-    }
-    console.warn(`[heartbeat-approval] heartbeat.json found but web.port invalid: ${JSON.stringify(port)} in ${directory}`);
-    return null;
-  } catch (err) {
-    if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
-      return null;
+    const text = await readFile(SESSION_MAP_PATH, "utf-8");
+    const mapping = JSON.parse(text);
+    const entry = mapping[sessionId];
+    if (entry && typeof entry.port === "number" && entry.port > 0 && entry.port < 65536) {
+      return `http://127.0.0.1:${entry.port}`;
     }
-    console.warn(`[heartbeat-approval] Failed to read heartbeat.json in ${directory}:`, err);
+    return null;
+  } catch {
     return null;
   }
 }
@@ -12425,12 +12420,18 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
-          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          const envPort = process.env.APPROVAL_PORT;
+          let resolvedUrl = null;
+          if (envPort && /^\d+$/.test(envPort)) {
+            resolvedUrl = `http://127.0.0.1:${envPort}`;
+          } else {
+            resolvedUrl = await lookupSessionMapping(ctx.sessionID);
+          }
           if (!resolvedUrl) {
             return JSON.stringify({
               status: "unavailable",
               type: requestType,
-              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              error: `No approval server found for session ${ctx.sessionID}. Ensure heartbeat runner is running for this role.`,
               approval_id: null
             });
           }

package/dist/plugin.js

@@ -13,6 +13,7 @@ var __export = (target, all) => {
 // src/plugin.ts
 import { readFile } from "fs/promises";
 import { join } from "path";
+import { homedir } from "os";
 
 // node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -12337,23 +12338,17 @@ tool.schema = exports_external;
 // src/plugin.ts
 var POLL_INTERVAL_MS = 1e4;
 var JSON_HEADERS = { "Content-Type": "application/json" };
-async function discoverRunnerUrl(directory) {
+var SESSION_MAP_PATH = join(homedir(), ".config", "opencode", "heartbeat", "session-map.json");
+async function lookupSessionMapping(sessionId) {
   try {
-    const configPath = join(directory, "heartbeat.json");
-    const text = await readFile(configPath, "utf-8");
-    const config2 = JSON.parse(text);
-    const web = config2?.web;
-    const port = web?.port;
-    if (typeof port === "number" && Number.isInteger(port) && port > 0 && port < 65536) {
-      return `http://127.0.0.1:${port}`;
-    }
-    console.warn(`[heartbeat-approval] heartbeat.json found but web.port invalid: ${JSON.stringify(port)} in ${directory}`);
-    return null;
-  } catch (err) {
-    if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
-      return null;
+    const text = await readFile(SESSION_MAP_PATH, "utf-8");
+    const mapping = JSON.parse(text);
+    const entry = mapping[sessionId];
+    if (entry && typeof entry.port === "number" && entry.port > 0 && entry.port < 65536) {
+      return `http://127.0.0.1:${entry.port}`;
     }
-    console.warn(`[heartbeat-approval] Failed to read heartbeat.json in ${directory}:`, err);
+    return null;
+  } catch {
     return null;
   }
 }
@@ -12425,12 +12420,18 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
-          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          const envPort = process.env.APPROVAL_PORT;
+          let resolvedUrl = null;
+          if (envPort && /^\d+$/.test(envPort)) {
+            resolvedUrl = `http://127.0.0.1:${envPort}`;
+          } else {
+            resolvedUrl = await lookupSessionMapping(ctx.sessionID);
+          }
           if (!resolvedUrl) {
             return JSON.stringify({
               status: "unavailable",
               type: requestType,
-              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              error: `No approval server found for session ${ctx.sessionID}. Ensure heartbeat runner is running for this role.`,
               approval_id: null
             });
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-heartbeat-approval",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "OpenCode plugin providing request_human_input MCP tool for Heartbeat pipeline (approval + assistance)",
   "type": "module",
   "main": "dist/index.js",

package/src/plugin.ts

@@ -1,5 +1,6 @@
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
+import { homedir } from "node:os";
 import { tool } from "@opencode-ai/plugin";
 import type { PluginInput } from "@opencode-ai/plugin";
 
@@ -26,28 +27,18 @@ interface ConflictResponse {
   existing_approval_id: string;
 }
 
-/**
- * Auto-discover runner URL from the session's directory.
- * Reads heartbeat.json in ctx.directory to find web.port.
- * Returns null if not found (ENOENT is expected — not a heartbeat dir).
- */
-async function discoverRunnerUrl(directory: string): Promise<string | null> {
+const SESSION_MAP_PATH = join(homedir(), ".config", "opencode", "heartbeat", "session-map.json");
+
+async function lookupSessionMapping(sessionId: string): Promise<string | null> {
   try {
-    const configPath = join(directory, "heartbeat.json");
-    const text = await readFile(configPath, "utf-8");
-    const config = JSON.parse(text) as Record<string, unknown>;
-    const web = config?.web as Record<string, unknown> | undefined;
-    const port = web?.port;
-    if (typeof port === "number" && Number.isInteger(port) && port > 0 && port < 65536) {
-      return `http://127.0.0.1:${port}`;
+    const text = await readFile(SESSION_MAP_PATH, "utf-8");
+    const mapping = JSON.parse(text) as Record<string, { port: number; role: string; created_at: string }>;
+    const entry = mapping[sessionId];
+    if (entry && typeof entry.port === "number" && entry.port > 0 && entry.port < 65536) {
+      return `http://127.0.0.1:${entry.port}`;
     }
-    console.warn(`[heartbeat-approval] heartbeat.json found but web.port invalid: ${JSON.stringify(port)} in ${directory}`);
     return null;
-  } catch (err: unknown) {
-    if (err && typeof err === "object" && "code" in err && (err as { code: string }).code === "ENOENT") {
-      return null;
-    }
-    console.warn(`[heartbeat-approval] Failed to read heartbeat.json in ${directory}:`, err);
+  } catch {
     return null;
   }
 }
@@ -137,12 +128,18 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
           }
           const requestType = (args.type === "assistance" ? "assistance" : "approval") as "approval" | "assistance";
 
-          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          const envPort = process.env.APPROVAL_PORT;
+          let resolvedUrl: string | null = null;
+          if (envPort && /^\d+$/.test(envPort)) {
+            resolvedUrl = `http://127.0.0.1:${envPort}`;
+          } else {
+            resolvedUrl = await lookupSessionMapping(ctx.sessionID);
+          }
           if (!resolvedUrl) {
             return JSON.stringify({
               status: "unavailable",
               type: requestType,
-              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              error: `No approval server found for session ${ctx.sessionID}. Ensure heartbeat runner is running for this role.`,
               approval_id: null,
             });
           }