opencode-heartbeat-approval 0.2.0 → 0.2.1

package/dist/index.js

@@ -12333,8 +12333,8 @@ 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 getRunnerUrl(override) {
+  return override ?? process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
 }
 function buildHeaders() {
   const headers = { "Content-Type": "application/json" };
@@ -12344,8 +12344,8 @@ function buildHeaders() {
   }
   return headers;
 }
-async function createGate(params) {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+async function createGate(runnerUrl, params) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
     headers: buildHeaders(),
     body: JSON.stringify(params)
@@ -12359,8 +12359,8 @@ 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()
   });
@@ -12398,7 +12398,8 @@ 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)")
+          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.")
         },
         async execute(args, ctx) {
           const artifacts = args.artifacts ? args.artifacts.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -12412,9 +12413,10 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
+          const resolvedUrl = getRunnerUrl(args.runner_url);
           let gateResult;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -12450,7 +12452,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

@@ -12333,8 +12333,8 @@ 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 getRunnerUrl(override) {
+  return override ?? process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
 }
 function buildHeaders() {
   const headers = { "Content-Type": "application/json" };
@@ -12344,8 +12344,8 @@ function buildHeaders() {
   }
   return headers;
 }
-async function createGate(params) {
-  const resp = await fetch(`${getRunnerUrl()}/api/approval`, {
+async function createGate(runnerUrl, params) {
+  const resp = await fetch(`${runnerUrl}/api/approval`, {
     method: "POST",
     headers: buildHeaders(),
     body: JSON.stringify(params)
@@ -12359,8 +12359,8 @@ 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()
   });
@@ -12398,7 +12398,8 @@ 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)")
+          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.")
         },
         async execute(args, ctx) {
           const artifacts = args.artifacts ? args.artifacts.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
@@ -12412,9 +12413,10 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = args.type === "assistance" ? "assistance" : "approval";
+          const resolvedUrl = getRunnerUrl(args.runner_url);
           let gateResult;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -12450,7 +12452,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.2.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

@@ -18,8 +18,8 @@ interface PollResponse {
   type?: string;
 }
 
-function getRunnerUrl(): string {
-  return process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
+function getRunnerUrl(override?: string): string {
+  return override ?? process.env.HEARTBEAT_RUNNER_URL ?? DEFAULT_RUNNER_URL;
 }
 
 function buildHeaders(): Record<string, string> {
@@ -37,14 +37,14 @@ interface ConflictResponse {
   existing_approval_id: string;
 }
 
-async function createGate(params: {
+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(),
     body: JSON.stringify(params),
@@ -59,8 +59,8 @@ 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(),
   });
@@ -106,6 +106,10 @@ 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
@@ -121,10 +125,11 @@ Returns: { status: "approved" | "rejected" | "expired" | "unavailable" | "cancel
             });
           }
           const requestType = (args.type === "assistance" ? "assistance" : "approval") as "approval" | "assistance";
+          const resolvedUrl = getRunnerUrl(args.runner_url);
 
           let gateResult: CreateResponse | ConflictResponse;
           try {
-            gateResult = await createGate({
+            gateResult = await createGate(resolvedUrl, {
               prompt: args.prompt,
               artifacts,
               deadline_hours: args.deadline_hours,
@@ -165,7 +170,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;