opencode-heartbeat-approval 0.2.0 → 0.3.0

package/dist/index.js

@@ -10,6 +10,10 @@ var __export = (target, all) => {
     });
 };
 
+// src/plugin.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+
 // node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -12331,23 +12335,32 @@ function tool(input) {
 }
 tool.schema = exports_external;
 // src/plugin.ts
-var DEFAULT_RUNNER_URL = "http://127.0.0.1:3210";
 var POLL_INTERVAL_MS = 1e4;
-function getRunnerUrl() {
-  return process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
-}
-function buildHeaders() {
-  const headers = { "Content-Type": "application/json" };
-  const token = process.env.HEARTBEAT_AUTH_TOKEN;
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-  return headers;
-}
-async function createGate(params) {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+var JSON_HEADERS = { "Content-Type": "application/json" };
+async function discoverRunnerUrl(directory) {
+  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;
+    }
+    console.warn(`[heartbeat-approval] Failed to read heartbeat.json in ${directory}:`, err);
+    return null;
+  }
+}
+async function createGate(runnerUrl, params) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
-    headers: buildHeaders(),
+    headers: JSON_HEADERS,
     body: JSON.stringify(params)
   });
   if (resp.status === 409) {
@@ -12359,10 +12372,10 @@ async function createGate(params) {
   }
   return await resp.json();
 }
-async function pollGate() {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+async function pollGate(runnerUrl) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "GET",
-    headers: buildHeaders()
+    headers: JSON_HEADERS
   });
   if (!resp.ok) {
     const text = await resp.text().catch(() => "");
@@ -12412,9 +12425,18 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
+          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          if (!resolvedUrl) {
+            return JSON.stringify({
+              status: "unavailable",
+              type: requestType,
+              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              approval_id: null
+            });
+          }
           let gateResult;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -12450,7 +12472,7 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             await sleep(POLL_INTERVAL_MS, ctx.abort);
             let poll;
             try {
-              poll = await pollGate();
+              poll = await pollGate(resolvedUrl);
             } catch {
               await sleep(POLL_INTERVAL_MS, ctx.abort);
               continue;

package/dist/plugin.js

@@ -10,6 +10,10 @@ var __export = (target, all) => {
     });
 };
 
+// src/plugin.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+
 // node_modules/zod/v4/classic/external.js
 var exports_external = {};
 __export(exports_external, {
@@ -12331,23 +12335,32 @@ function tool(input) {
 }
 tool.schema = exports_external;
 // src/plugin.ts
-var DEFAULT_RUNNER_URL = "http://127.0.0.1:3210";
 var POLL_INTERVAL_MS = 1e4;
-function getRunnerUrl() {
-  return process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
-}
-function buildHeaders() {
-  const headers = { "Content-Type": "application/json" };
-  const token = process.env.HEARTBEAT_AUTH_TOKEN;
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-  return headers;
-}
-async function createGate(params) {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+var JSON_HEADERS = { "Content-Type": "application/json" };
+async function discoverRunnerUrl(directory) {
+  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;
+    }
+    console.warn(`[heartbeat-approval] Failed to read heartbeat.json in ${directory}:`, err);
+    return null;
+  }
+}
+async function createGate(runnerUrl, params) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
-    headers: buildHeaders(),
+    headers: JSON_HEADERS,
     body: JSON.stringify(params)
   });
   if (resp.status === 409) {
@@ -12359,10 +12372,10 @@ async function createGate(params) {
   }
   return await resp.json();
 }
-async function pollGate() {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+async function pollGate(runnerUrl) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "GET",
-    headers: buildHeaders()
+    headers: JSON_HEADERS
   });
   if (!resp.ok) {
     const text = await resp.text().catch(() => "");
@@ -12412,9 +12425,18 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
+          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          if (!resolvedUrl) {
+            return JSON.stringify({
+              status: "unavailable",
+              type: requestType,
+              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              approval_id: null
+            });
+          }
           let gateResult;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -12450,7 +12472,7 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             await sleep(POLL_INTERVAL_MS, ctx.abort);
             let poll;
             try {
-              poll = await pollGate();
+              poll = await pollGate(resolvedUrl);
             } catch {
               await sleep(POLL_INTERVAL_MS, ctx.abort);
               continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-heartbeat-approval",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "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,8 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
 import { tool } from "@opencode-ai/plugin";
 import type { PluginInput } from "@opencode-ai/plugin";
 
-const DEFAULT_RUNNER_URL = "http://127.0.0.1:3210";
 const POLL_INTERVAL_MS = 10_000;
+const JSON_HEADERS: Record<string, string> = { "Content-Type": "application/json" };
 
 interface CreateResponse {
   approval_id: string;
@@ -18,35 +20,48 @@ interface PollResponse {
   type?: string;
 }
 
-function getRunnerUrl(): string {
-  return process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
-}
-
-function buildHeaders(): Record<string, string> {
-  const headers: Record<string, string> = { "Content-Type": "application/json" };
-  const token = process.env.HEARTBEAT_AUTH_TOKEN;
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-  return headers;
-}
-
 interface ConflictResponse {
   error: string;
   message: string;
   existing_approval_id: string;
 }
 
-async function createGate(params: {
+/**
+ * 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> {
+  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}`;
+    }
+    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);
+    return null;
+  }
+}
+
+async function createGate(runnerUrl: string, params: {
   prompt: string;
   artifacts?: string[];
   deadline_hours?: number;
   phase?: string;
   type?: string;
 }): Promise<CreateResponse | ConflictResponse> {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
-    headers: buildHeaders(),
+    headers: JSON_HEADERS,
     body: JSON.stringify(params),
   });
   if (resp.status === 409) {
@@ -59,10 +74,10 @@ async function createGate(params: {
   return (await resp.json()) as CreateResponse;
 }
 
-async function pollGate(): Promise<PollResponse> {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+async function pollGate(runnerUrl: string): Promise<PollResponse> {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "GET",
-    headers: buildHeaders(),
+    headers: JSON_HEADERS,
   });
   if (!resp.ok) {
     const text = await resp.text().catch(() => "");
@@ -122,9 +137,19 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
           }
           const requestType = (args.type === "assistance" ? "assistance" : "approval") as "approval" | "assistance";
 
+          const resolvedUrl = await discoverRunnerUrl(ctx.directory);
+          if (!resolvedUrl) {
+            return JSON.stringify({
+              status: "unavailable",
+              type: requestType,
+              error: `Cannot discover runner: no heartbeat.json with valid web.port in ${ctx.directory}`,
+              approval_id: null,
+            });
+          }
+
           let gateResult: CreateResponse | ConflictResponse;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -165,7 +190,7 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
 
             let poll: PollResponse;
             try {
-              poll = await pollGate();
+              poll = await pollGate(resolvedUrl);
             } catch {
               await sleep(POLL_INTERVAL_MS, ctx.abort);
               continue;