@polderlabs/bizar 4.3.0 → 4.4.1

package/bizar-dash/src/server/opencode-sdk.mjs

@@ -0,0 +1,72 @@
+/**
+ * src/server/opencode-sdk.mjs
+ *
+ * Dashboard-side wrapper that reads serve-info.mjs, constructs the
+ * opencode SDK instance with auth, and exports a singleton `getOpencodeSdk()`.
+ *
+ * Also exports `pingOpencodeSdk(info)` which uses the SDK's `health.check()`
+ * (replaces the old `pingOpencodeServe` from serve-info.mjs; the old name
+ * is kept as a backwards-compatible alias).
+ *
+ * v0.1.0 — initial implementation
+ */
+
+import { readServeInfo, pingOpencodeServe as _pingOpencodeServe } from "./serve-info.mjs";
+
+let _sdk = null;
+let _sdkInfo = null;
+
+/**
+ * Lazily create and cache an opencode SDK instance from the active
+ * serve-info. Returns `null` when no serve-info is available.
+ *
+ * @returns {Promise<import('@polderlabs/bizar-sdk').OpencodeSdk | null>}
+ */
+export async function getOpencodeSdk() {
+  const info = readServeInfo();
+  if (!info) return null;
+
+  // Re-use existing instance if serve-info hasn't changed.
+  if (_sdk && _sdkInfo && _sdkInfo.password === info.password && _sdkInfo.port === info.port) {
+    return _sdk;
+  }
+
+  const { createOpencodeSdk } = await import("@polderlabs/bizar-sdk/opencode");
+  const sdk = await createOpencodeSdk({
+    baseUrl: info.baseUrl,
+    password: info.password,
+    throwOnError: false,
+  });
+
+  _sdk = sdk;
+  _sdkInfo = { password: info.password, port: info.port };
+  return sdk;
+}
+
+/**
+ * Ping the opencode serve child using the SDK's health endpoint.
+ * Falls back to TCP-connect ping if the SDK health check fails.
+ *
+ * @param {import('./serve-info.mjs').ServeInfo} info
+ * @returns {Promise<boolean>}
+ */
+export async function pingOpencodeSdk(info) {
+  const sdk = await getOpencodeSdk();
+  if (!sdk) return false;
+  try {
+    const result = await sdk.health.check();
+    if (result && typeof result === "object" && "ok" in result) {
+      return result.ok === true;
+    }
+    // BizarError shape — fall back to TCP ping
+    return pingOpencodeServe(info);
+  } catch {
+    return pingOpencodeServe(info);
+  }
+}
+
+/**
+ * Backwards-compatible alias for `pingOpencodeSdk`.
+ * @deprecated Use `pingOpencodeSdk` instead.
+ */
+export const pingOpencodeServe = pingOpencodeSdk;

package/bizar-dash/src/server/routes/background.mjs

@@ -161,5 +161,97 @@ export function createBackgroundRouter({ broadcast }) {
     res.json(summary);
   }));
 
+  // v3.22.0 — Open-terminal endpoint. The frontend calls this when the
+  // operator clicks "Open in terminal" on a TmuxAttachCard. The server
+  // spawns the platform's terminal emulator with the tmux attach command.
+  // Whitelisted emulators: 'system' (auto-detect), 'tmux-iterm' (macOS
+  // iTerm2), 'tmux-wt' (Windows Terminal).
+  //
+  // The endpoint ALWAYS returns 200 with `{ ok, command }` or
+  // `{ ok: false, error }` — never a raw 5xx, so the frontend can fall
+  // back to clipboard copy.
+  router.post('/background/:id/open-terminal', wrap(async (req, res) => {
+    const { backgroundStore } = await import('../background-store.mjs');
+    const info = backgroundStore.tmuxAttachInfo(req.params.id);
+
+    if (!info || !info.session) {
+      res.json({ ok: false, error: 'no_tmux_session' });
+      return;
+    }
+
+    // Validate actual tmux session name matches the bgr_<hex> pattern.
+    if (!/^bgr_[A-Za-z0-9_-]{1,24}$/.test(info.session)) {
+      res.json({ ok: false, error: 'invalid_session_name' });
+      return;
+    }
+
+    // Whitelist emulator selection.
+    const emulator = (req.body?.emulator || 'system').toString();
+    const ALLOWED_EMULATORS = ['system', 'tmux-iterm', 'tmux-wt'];
+    if (!ALLOWED_EMULATORS.includes(emulator)) {
+      res.json({ ok: false, error: 'unknown_emulator', allowed: ALLOWED_EMULATORS });
+      return;
+    }
+
+    const { execFileSync, spawn } = await import('node:child_process');
+    const platform = process.platform;
+    const command = `tmux attach -t ${info.session}`;
+
+    if (emulator === 'system') {
+      // Auto-detect platform terminal.
+      if (platform === 'darwin') {
+        spawn('osascript', [
+          '-e', `tell application "Terminal" to do script "${command}"`,
+          '-e', 'activate application "Terminal"',
+        ], { detached: true, stdio: 'ignore' }).unref();
+      } else if (platform === 'linux') {
+        const candidates = [
+          ['gnome-terminal', '--', ...command.split(' ')],
+          ['konsole', '-e', command],
+          ['xterm', '-e', command],
+          ['x-terminal-emulator', '-e', command],
+        ];
+        let launched = false;
+        for (const [cmd, ...args] of candidates) {
+          try {
+            execFileSync('which', [cmd], { stdio: 'pipe' });
+            spawn(cmd, args, { detached: true, stdio: 'ignore' }).unref();
+            launched = true;
+            break;
+          } catch { /* try next */ }
+        }
+        if (!launched) {
+          res.json({ ok: false, error: 'no_terminal_emulator_found' });
+          return;
+        }
+      } else if (platform === 'win32') {
+        try {
+          execFileSync('where', ['wt.exe'], { stdio: 'pipe' });
+          spawn('wt.exe', ['-e', ...command.split(' ')], { detached: true, stdio: 'ignore' }).unref();
+        } catch {
+          spawn('cmd', ['/c', 'start', '', 'cmd', '/k', ...command.split(' ')], { detached: true, stdio: 'ignore' }).unref();
+        }
+      } else {
+        res.json({ ok: false, error: `unsupported_platform: ${platform}` });
+        return;
+      }
+    } else if (emulator === 'tmux-iterm') {
+      if (platform !== 'darwin') {
+        res.json({ ok: false, error: 'tmux-iterm requires macOS' });
+        return;
+      }
+      // iTerm2 has a "tmux integration" mode; open -a iTerm sends the command.
+      spawn('open', ['-a', 'iTerm2', command], { detached: true, stdio: 'ignore' }).unref();
+    } else if (emulator === 'tmux-wt') {
+      if (platform !== 'win32') {
+        res.json({ ok: false, error: 'tmux-wt requires Windows' });
+        return;
+      }
+      spawn('wt.exe', ['-e', ...command.split(' ')], { detached: true, stdio: 'ignore' }).unref();
+    }
+
+    res.json({ ok: true, command });
+  }));
+
   return router;
 }