codex-webstrapper 0.1.5 → 0.2.5

package/bin/codex-webstrap.sh

@@ -17,9 +17,20 @@ OPEN_FLAG="0"
 TOKEN_FILE="${CODEX_WEBSTRAP_TOKEN_FILE:-}"
 CODEX_APP="${CODEX_WEBSTRAP_CODEX_APP:-}"
 INTERNAL_WS_PORT="${CODEX_WEBSTRAP_INTERNAL_WS_PORT:-38080}"
+PORT_SET="0"
+BIND_SET="0"
 COPY_FLAG="0"
 COMMAND="serve"
 
+# Treat non-empty env overrides as explicit selections so open-mode runtime
+# autodetection cannot replace them.
+if [[ -n "${CODEX_WEBSTRAP_PORT:-}" ]]; then
+  PORT_SET="1"
+fi
+if [[ -n "${CODEX_WEBSTRAP_BIND:-}" ]]; then
+  BIND_SET="1"
+fi
+
 DEFAULT_TOKEN_FILE="${HOME}/.codex-webstrap/token"
 if [[ -z "$TOKEN_FILE" ]]; then
   TOKEN_FILE="$DEFAULT_TOKEN_FILE"
@@ -70,14 +81,20 @@ fi
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
+    open)
+      COMMAND="open"
+      shift
+      ;;
     --port)
       require_value "$1" "${2:-}"
       PORT="$2"
+      PORT_SET="1"
       shift 2
       ;;
     --bind)
       require_value "$1" "${2:-}"
       BIND="$2"
+      BIND_SET="1"
       shift 2
       ;;
     --token-file)
@@ -126,6 +143,36 @@ if [[ "$COMMAND" == "open" ]]; then
     exit 1
   fi
 
+  if [[ "$PORT_SET" == "0" || "$BIND_SET" == "0" ]]; then
+    RUNTIME_FILE="${TOKEN_FILE}.runtime"
+    if [[ -f "$RUNTIME_FILE" ]]; then
+      RUNTIME_VALUES="$(node -e 'const fs = require("node:fs"); const filePath = process.argv[2]; try { const data = JSON.parse(fs.readFileSync(filePath, "utf8")); const bind = data.bind || ""; const port = data.port || ""; if (!bind || !port) { process.exit(1); } process.stdout.write(`${bind}\n${port}\n`); } catch { process.exit(1); }' "$TOKEN_FILE" "$RUNTIME_FILE" 2>/dev/null || true)"
+      if [[ -n "$RUNTIME_VALUES" ]]; then
+        RUNTIME_BIND="$(printf '%s' "$RUNTIME_VALUES" | sed -n '1p')"
+        RUNTIME_PORT="$(printf '%s' "$RUNTIME_VALUES" | sed -n '2p')"
+        if [[ -n "$RUNTIME_BIND" && -n "$RUNTIME_PORT" ]]; then
+          if command -v curl >/dev/null 2>&1; then
+            if curl -fsS --max-time 1 --connect-timeout 1 "http://${RUNTIME_BIND}:${RUNTIME_PORT}/__webstrapper/healthz" >/dev/null 2>&1; then
+              if [[ "$BIND_SET" == "0" ]]; then
+                BIND="$RUNTIME_BIND"
+              fi
+              if [[ "$PORT_SET" == "0" ]]; then
+                PORT="$RUNTIME_PORT"
+              fi
+            fi
+          else
+            if [[ "$BIND_SET" == "0" ]]; then
+              BIND="$RUNTIME_BIND"
+            fi
+            if [[ "$PORT_SET" == "0" ]]; then
+              PORT="$RUNTIME_PORT"
+            fi
+          fi
+        fi
+      fi
+    fi
+  fi
+
   ENCODED_TOKEN="$(node -e 'process.stdout.write(encodeURIComponent(process.argv[1] || ""))' "$TOKEN")"
   AUTH_URL="http://${BIND}:${PORT}/__webstrapper/auth?token=${ENCODED_TOKEN}"
 
@@ -134,9 +181,8 @@ if [[ "$COMMAND" == "open" ]]; then
       echo "pbcopy not found in PATH" >&2
       exit 1
     fi
-    printf '%s' "$AUTH_URL" | pbcopy
+    printf '%s' "$AUTH_URL" | pbcopy >/dev/null 2>&1
     printf 'Copied auth URL to clipboard.\n'
-    printf '%s\n' "$AUTH_URL"
   else
     open "$AUTH_URL"
     printf 'Opened auth URL in browser.\n'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-webstrapper",
-  "version": "0.1.5",
+  "version": "0.2.5",
   "type": "module",
   "description": "Web wrapper for Codex desktop assets with bridge + token auth",
   "license": "MIT",
@@ -23,6 +23,7 @@
   },
   "dependencies": {
     "@electron/asar": "^4.0.1",
+    "bun-pty": "^0.4.8",
     "ws": "^8.18.0"
   }
 }

package/src/bridge-shim.js

@@ -599,6 +599,18 @@
   }
 
   function sendMessageFromView(payload) {
+    if (payload?.type === "open-in-browser") {
+      const target = payload?.url || payload?.href || null;
+      if (target) {
+        const opened = window.open(target, "_blank", "noopener,noreferrer");
+        if (!opened) {
+          // Fallback when popup is blocked.
+          window.location.href = target;
+        }
+      }
+      return Promise.resolve();
+    }
+
     sendEnvelope({
       type: "view-message",
       payload

package/src/bun-pty-bridge.mjs

@@ -0,0 +1,161 @@
+import { spawn } from "bun-pty";
+
+function toErrorMessage(error) {
+  if (!error) {
+    return "unknown_error";
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (typeof error.message === "string" && error.message.length > 0) {
+    return error.message;
+  }
+  return String(error);
+}
+
+function send(payload) {
+  try {
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+  } catch {
+    // Ignore JSON serialization/output failures.
+  }
+}
+
+function parseConfig(raw) {
+  try {
+    const parsed = JSON.parse(raw || "{}");
+    if (!parsed || typeof parsed !== "object") {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+function toDimension(value, fallback) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return fallback;
+  }
+  return Math.max(1, Math.floor(parsed));
+}
+
+const config = parseConfig(process.env.CODEX_WEBSTRAP_BUN_PTY_CONFIG || "");
+if (!config || typeof config.file !== "string" || config.file.length === 0) {
+  send({ type: "error", message: "Invalid bun-pty config." });
+  process.exit(2);
+}
+
+let terminal;
+try {
+  terminal = spawn(
+    config.file,
+    Array.isArray(config.args) ? config.args.filter((entry) => typeof entry === "string") : [],
+    {
+      name: typeof config.term === "string" && config.term.length > 0 ? config.term : "xterm-256color",
+      cols: toDimension(config.cols, 120),
+      rows: toDimension(config.rows, 30),
+      cwd: typeof config.cwd === "string" && config.cwd.length > 0 ? config.cwd : process.cwd(),
+      env: config.env && typeof config.env === "object" ? config.env : process.env
+    }
+  );
+} catch (error) {
+  send({
+    type: "error",
+    message: `Failed to start bun-pty terminal: ${toErrorMessage(error)}`
+  });
+  process.exit(1);
+}
+
+let exiting = false;
+const requestExit = (code = 0) => {
+  if (exiting) {
+    return;
+  }
+  exiting = true;
+  process.exit(code);
+};
+
+terminal.onData((data) => {
+  send({
+    type: "data",
+    data
+  });
+});
+
+terminal.onExit((exit) => {
+  send({
+    type: "exit",
+    exitCode: typeof exit?.exitCode === "number" ? exit.exitCode : null,
+    signal: exit?.signal ?? null
+  });
+  requestExit(0);
+});
+
+let inputBuffer = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => {
+  inputBuffer += chunk;
+
+  for (;;) {
+    const newlineAt = inputBuffer.indexOf("\n");
+    if (newlineAt < 0) {
+      break;
+    }
+
+    const line = inputBuffer.slice(0, newlineAt);
+    inputBuffer = inputBuffer.slice(newlineAt + 1);
+
+    if (line.trim().length === 0) {
+      continue;
+    }
+
+    let command;
+    try {
+      command = JSON.parse(line);
+    } catch {
+      continue;
+    }
+
+    try {
+      if (command?.type === "write") {
+        terminal.write(typeof command.data === "string" ? command.data : "");
+        continue;
+      }
+
+      if (command?.type === "resize") {
+        terminal.resize(toDimension(command.cols, 120), toDimension(command.rows, 30));
+        continue;
+      }
+
+      if (command?.type === "close") {
+        terminal.kill("SIGTERM");
+        requestExit(0);
+      }
+    } catch (error) {
+      send({
+        type: "error",
+        message: toErrorMessage(error)
+      });
+    }
+  }
+});
+
+process.on("SIGTERM", () => {
+  try {
+    terminal.kill("SIGTERM");
+  } catch {
+    // Ignore.
+  }
+  requestExit(0);
+});
+
+process.on("SIGINT", () => {
+  try {
+    terminal.kill("SIGTERM");
+  } catch {
+    // Ignore.
+  }
+  requestExit(0);
+});