opencode-heartbeat-approval 0.2.1 → 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(override) {
-  return override ?? 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}`;
+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;
   }
-  return headers;
 }
 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) {
@@ -12362,7 +12375,7 @@ async function createGate(runnerUrl, params) {
 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(() => "");
@@ -12398,8 +12411,7 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
           prompt: tool.schema.string().describe("What you need from the human \u2014 be specific and concise"),
           type: tool.schema.string().optional().describe("Type of request: 'approval' (need permission) or 'assistance' (need human help). Default: 'approval'"),
           artifacts: tool.schema.string().optional().describe("Comma-separated list of relevant file paths or artifact names"),
-          deadline_hours: tool.schema.number().optional().describe("Hours before the request expires (default: 24, max: 168)"),
-          runner_url: tool.schema.string().optional().describe("URL of this role's heartbeat runner (e.g., http://127.0.0.1:3211). Required for multi-role setups.")
+          deadline_hours: tool.schema.number().optional().describe("Hours before the request expires (default: 24, max: 168)")
         },
         async execute(args, ctx) {
           const artifacts = args.artifacts ? args.artifacts.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -12413,7 +12425,15 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
-          const resolvedUrl = getRunnerUrl(args.runner_url);
+          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(resolvedUrl, {

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(override) {
-  return override ?? 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}`;
+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;
   }
-  return headers;
 }
 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) {
@@ -12362,7 +12375,7 @@ async function createGate(runnerUrl, params) {
 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(() => "");
@@ -12398,8 +12411,7 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
           prompt: tool.schema.string().describe("What you need from the human \u2014 be specific and concise"),
           type: tool.schema.string().optional().describe("Type of request: 'approval' (need permission) or 'assistance' (need human help). Default: 'approval'"),
           artifacts: tool.schema.string().optional().describe("Comma-separated list of relevant file paths or artifact names"),
-          deadline_hours: tool.schema.number().optional().describe("Hours before the request expires (default: 24, max: 168)"),
-          runner_url: tool.schema.string().optional().describe("URL of this role's heartbeat runner (e.g., http://127.0.0.1:3211). Required for multi-role setups.")
+          deadline_hours: tool.schema.number().optional().describe("Hours before the request expires (default: 24, max: 168)")
         },
         async execute(args, ctx) {
           const artifacts = args.artifacts ? args.artifacts.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -12413,7 +12425,15 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
-          const resolvedUrl = getRunnerUrl(args.runner_url);
+          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(resolvedUrl, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-heartbeat-approval",
-  "version": "0.2.1",
+  "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,25 +20,38 @@ interface PollResponse {
   type?: string;
 }
 
-function getRunnerUrl(override?: string): string {
-  return override ?? 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;
 }
 
+/**
+ * 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[];
@@ -46,7 +61,7 @@ async function createGate(runnerUrl: string, params: {
 }): Promise<CreateResponse | ConflictResponse> {
   const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
-    headers: buildHeaders(),
+    headers: JSON_HEADERS,
     body: JSON.stringify(params),
   });
   if (resp.status === 409) {
@@ -62,7 +77,7 @@ async function createGate(runnerUrl: string, params: {
 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(() => "");
@@ -106,10 +121,6 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             .number()
             .optional()
             .describe("Hours before the request expires (default: 24, max: 168)"),
-          runner_url: tool.schema
-            .string()
-            .optional()
-            .describe("URL of this role's heartbeat runner (e.g., http://127.0.0.1:3211). Required for multi-role setups."),
         },
         async execute(args, ctx) {
           const artifacts = args.artifacts
@@ -125,7 +136,16 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = (args.type === "assistance" ? "assistance" : "approval") as "approval" | "assistance";
-          const resolvedUrl = getRunnerUrl(args.runner_url);
+
+          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 {