runsignal 0.1.6 → 0.1.7

package/bin/runsignal.js

@@ -18,6 +18,20 @@ const DEFAULT_APP_URL = process.env.RUNSIGNAL_APP_URL || 'https://runsignal.dev'
 const CONFIG_DIR = path.join(os.homedir(), '.runsignal');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 
+function extractErrorDetail(code, marker) {
+  const index = code.indexOf(marker);
+  if (index === -1) {
+    return '';
+  }
+
+  const detail = code.slice(index + marker.length).trim();
+  if (!detail) {
+    return '';
+  }
+
+  return detail.slice(0, 180);
+}
+
 function toUserMessage(errorCode) {
   const code = String(errorCode || '');
   if (code.includes('not_logged_in')) return 'You are not logged in. Run: runsignal login';
@@ -32,8 +46,13 @@ function toUserMessage(errorCode) {
   if (code.includes('login_timeout')) return 'Login timed out. Retry runsignal login and validate quickly.';
   if (code.includes('login_poll_failed'))
     return 'Login polling failed. Check APP URL and server availability.';
-  if (code.includes('send_event_failed'))
+  if (code.includes('send_event_failed')) {
+    const detail = extractErrorDetail(code, 'send_event_failed:');
+    if (detail) {
+      return `Event send failed (${detail}). Check machine key, network and server logs.`;
+    }
     return 'Event send failed. Check machine key, network and server logs.';
+  }
   if (code.includes('status_failed')) return 'Status check failed. Verify event id and machine ownership.';
   if (code.includes('event_type_invalid'))
     return 'Invalid event type. Use approval_required, task_completed, error, quota_warning, question.';
@@ -101,6 +120,39 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function tryOpenBrowser(url) {
+  if (!url) return false;
+
+  try {
+    if (process.platform === 'win32') {
+      const child = spawn('cmd', ['/c', 'start', '', url], {
+        detached: true,
+        stdio: 'ignore'
+      });
+      child.unref();
+      return true;
+    }
+
+    if (process.platform === 'darwin') {
+      const child = spawn('open', [url], {
+        detached: true,
+        stdio: 'ignore'
+      });
+      child.unref();
+      return true;
+    }
+
+    const child = spawn('xdg-open', [url], {
+      detached: true,
+      stdio: 'ignore'
+    });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 const HOOK_START = '# >>> RunSignal hooks start >>>';
 const HOOK_END = '# <<< RunSignal hooks end <<<';
 
@@ -479,7 +531,13 @@ async function runLogin(options) {
     throw new Error('login_payload_invalid');
   }
 
-  console.log(`Open ${verificationUrl} and enter code: ${userCode}`);
+  const verificationUrlWithCode = `${verificationUrl}?code=${encodeURIComponent(String(userCode))}`;
+  const opened = tryOpenBrowser(verificationUrlWithCode);
+  if (opened) {
+    console.log('Browser opened.');
+  } else {
+    console.log(`Open ${verificationUrlWithCode} and enter code: ${userCode}`);
+  }
 
   let accessToken = null;
   const deadline = Date.now() + 10 * 60 * 1000;
@@ -604,7 +662,7 @@ async function runWrap(commandParts) {
   }
 
   const repo = getRepoFromGit();
-  const branch = getBranchFromGit();
+  const branch = getBranchFromGit() || undefined;
   const machineName = config.machine_name || getMachineName();
   const agentLabel = inferAgentLabel(commandParts);
 
@@ -641,48 +699,52 @@ async function runWrap(commandParts) {
         env: process.env
       });
 
+  const startedAt = Date.now();
+  const sessionTarget = interactivePassthrough ? singleExecutable : commandString;
+  try {
+    await sendEvent({
+      apiFetch,
+      baseUrl,
+      machineApiKey,
+      event: {
+        message: `Session started: ${sessionTarget}`,
+        event_type: 'session_started',
+        repo,
+        branch,
+        severity: 'info',
+        context,
+        agent: agentLabel
+      }
+    });
+  } catch {
+    // non-blocking
+  }
+
   let heartbeatInterval = null;
   if (interactivePassthrough) {
-    const startedAt = Date.now();
-    try {
-      await sendEvent({
-        apiFetch,
-        baseUrl,
-        machineApiKey,
-        event: {
-          message: `Session started: ${singleExecutable}`,
-          event_type: 'session_started',
-          repo,
-          branch,
-          severity: 'info',
-          context,
-          agent: agentLabel
-        }
-      });
-    } catch {
-      // non-blocking
+    const heartbeatMin = Number.parseInt(String(process.env.RUNSIGNAL_HEARTBEAT_MIN ?? '0'), 10);
+    if (Number.isFinite(heartbeatMin) && heartbeatMin > 0) {
+      heartbeatInterval = setInterval(() => {
+        const elapsedMin = Math.max(1, Math.floor((Date.now() - startedAt) / 60_000));
+        sendEvent({
+          apiFetch,
+          baseUrl,
+          machineApiKey,
+          event: {
+            message: `Session running (${elapsedMin} min): ${singleExecutable}`,
+            event_type: 'session_running',
+            repo,
+            branch,
+            severity: 'info',
+            context,
+            agent: agentLabel
+          }
+        }).catch(() => {
+          // non-blocking
+        });
+      }, heartbeatMin * 60_000);
+      heartbeatInterval.unref?.();
     }
-
-    heartbeatInterval = setInterval(() => {
-      const elapsedMin = Math.max(1, Math.floor((Date.now() - startedAt) / 60_000));
-      sendEvent({
-        apiFetch,
-        baseUrl,
-        machineApiKey,
-        event: {
-          message: `Session running (${elapsedMin} min): ${singleExecutable}`,
-          event_type: 'session_running',
-          repo,
-          branch,
-          severity: 'info',
-          context,
-          agent: agentLabel
-        }
-      }).catch(() => {
-        // non-blocking
-      });
-    }, 120_000);
-    heartbeatInterval.unref?.();
   }
 
   let sawApproval = false;
@@ -791,28 +853,30 @@ async function runWrap(commandParts) {
   }
   await Promise.allSettled(Array.from(pendingTasks));
 
-  const completionMessage =
-    exitCode === 0
-      ? `Wrapped command completed: ${commandParts.join(' ')}`
-      : `Wrapped command failed (code ${exitCode}): ${lastInterestingLine || commandParts.join(' ')}`;
+  if (!interactivePassthrough || exitCode !== 0) {
+    const completionMessage =
+      exitCode === 0
+        ? `Wrapped command completed: ${commandParts.join(' ')}`
+        : `Wrapped command failed (code ${exitCode}): ${lastInterestingLine || commandParts.join(' ')}`;
 
-  try {
-    await sendEvent({
-      apiFetch,
-      baseUrl,
-      machineApiKey,
-      event: {
-        message: completionMessage.slice(0, 1000),
-        event_type: exitCode === 0 ? 'task_completed' : 'error',
-        repo,
-        branch,
-        severity: exitCode === 0 ? 'info' : 'critical',
-        context,
-        agent: agentLabel
-      }
-    });
-  } catch {
-    // no-op
+    try {
+      await sendEvent({
+        apiFetch,
+        baseUrl,
+        machineApiKey,
+        event: {
+          message: completionMessage.slice(0, 1000),
+          event_type: exitCode === 0 ? 'task_completed' : 'error',
+          repo,
+          branch,
+          severity: exitCode === 0 ? 'info' : 'critical',
+          context,
+          agent: agentLabel
+        }
+      });
+    } catch {
+      // no-op
+    }
   }
 
   // Avoid hard process exit on Windows: let Node close handles cleanly.
@@ -830,7 +894,7 @@ async function runTest() {
   }
 
   const repo = getRepoFromGit();
-  const branch = getBranchFromGit();
+  const branch = getBranchFromGit() || undefined;
 
   const result = await sendEvent({
     apiFetch,
@@ -901,7 +965,8 @@ async function runSend(options) {
   }
 
   const repo = options.repo ? String(options.repo).trim() : getRepoFromGit();
-  const branch = options.branch ? String(options.branch).trim() : getBranchFromGit();
+  const branchRaw = options.branch ? String(options.branch).trim() : getBranchFromGit();
+  const branch = branchRaw || undefined;
   const agent = options.agent ? String(options.agent).trim() : 'manual-cli';
 
   const result = await sendEvent({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runsignal",
-   "version": "0.1.6",
+   "version": "0.1.7",
   "description": "RunSignal CLI for wrapping AI agent runs and handling approvals",
   "type": "module",
   "license": "MIT",