@4xeoz/re-entry 0.2.7 → 0.2.9

package/README.md

@@ -1,6 +1,6 @@
 # Re-entry Local Connector
 
-Install it once on the Mac where Codex should open; after one browser approval, a macOS
+Install it once on the Mac where Codex should open; after one dashboard pairing code, a macOS
 LaunchAgent keeps the outbound Connector running at login.
 
 > Current boundary: this is a verified macOS Connector preview with a publish-ready npm package.
@@ -67,11 +67,10 @@ npx --yes --package=@4xeoz/re-entry re-entry install \
 ```text
 choose Desktop, the current folder, or another Codex workspace
   -> check Node + find Codex + validate the selected directory
-  -> request a device authorization from Re-entry
-  -> show the verification URL and wait for the user to press Enter
-  -> open Re-entry in the default browser
-  -> sign in or create an account
-  -> approve this Mac once
+  -> open the dedicated Re-entry user account page in the default browser
+  -> sign in or create a user account
+  -> click Pair this Mac in the dashboard
+  -> enter the short pairing code in the CLI
   -> save the device credential with mode 0600
   -> install and start a per-user macOS LaunchAgent
 ```
@@ -133,8 +132,8 @@ Copy this prompt into a coding-agent task:
 ```text
 Install the Re-entry Local Connector on this Mac. First read the package README. Verify Node.js 24
 or newer and locate the Connector executable. Run `npx --yes --package=@4xeoz/re-entry re-entry install` with an absolute
-project directory. Let the human complete the Re-entry
-browser approval; never copy browser cookies, organization keys, Connector tokens, or private keys
+project directory. Let the human create or sign in to a Re-entry account, click Pair this Mac, and
+enter the code in the CLI; never copy browser cookies, organization keys, Connector tokens, or private keys
 into chat, logs, source files, or git. Finish by running `re-entry status` and report the bounded
 results without claiming Browser/WebMCP or production deployment.
 ```
@@ -142,7 +141,7 @@ results without claiming Browser/WebMCP or production deployment.
 ## Package map
 
 - `src/main.mjs` — `re-entry` CLI and long-running poll loop.
-- `src/pairing-client.mjs` — account-first browser device authorization.
+- `src/pairing-client.mjs` — account pairing-code redemption and legacy pairing compatibility.
 - `src/credentials.mjs` — atomic local credential storage.
 - `src/macos-service.mjs` — per-user LaunchAgent install, stop, uninstall, and status.
 - `src/workspace-picker.mjs` — interactive Codex workspace selection.
@@ -251,9 +250,10 @@ npm start -- \
   --codex-cd "$HOME/Code/my-host-project"
 ```
 
-On the first run, the Connector checks the Mac, asks for the one-time code from the Host
-backend, opens the approval page, waits for the user to approve it, stores the credential, and
-checks once for approved work. On later runs it reuses the saved credential and skips pairing:
+On the first run, the Connector checks the Mac, opens the dedicated Re-entry user account page,
+waits for you to create or sign in to an account and click Pair this Mac, then asks for the
+dashboard code and stores the credential. On later runs it reuses the saved credential and skips
+pairing:
 
 ```sh
 npm start -- --codex-cd "$HOME/Code/my-host-project"
@@ -271,13 +271,13 @@ events instead so another process can consume it:
 npm start -- --json --codex-cd "$HOME/Code/my-host-project"
 ```
 
-## Pair this Mac with a Host user
+## Compatibility: Host-code pairing (legacy)
 
 Pairing connects one local Connector to one already-authenticated Host user. It is separate from
 the Host organization's API key and does not give the Connector permission to create Grants or
 send Host events.
 
-The flow is:
+The older compatibility flow is:
 
 ```text
 Host backend -> Receiver: start pairing for its Host-user reference
@@ -290,7 +290,8 @@ Receiver -> Connector: one Connector credential
 Connector -> local disk: save the credential with mode 0600
 ```
 
-The Host backend starts pairing with its organization credential. In the current local preview:
+The current preview does not use this Host-issued code path. Use `re-entry install` above, where
+the authenticated Re-entry dashboard creates the code.
 
 ```sh
 curl -s -X POST http://127.0.0.1:43218/v0.1/pairing-sessions \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4xeoz/re-entry",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "description": "Outbound Local Connector process for the Re-entry Core local preview.",
   "publishConfig": {

package/src/main.mjs

@@ -24,8 +24,7 @@ import {
   hasConnectorReauthorizationRequired,
   markConnectorReauthorizationRequired,
 } from "./credentials.mjs";
-import { LocalConnectorPairingClient } from "./pairing-client.mjs";
-import { waitForEnterToOpenBrowser } from "./browser-prompt.mjs";
+import { LocalConnectorPairingClient, openBrowser } from "./pairing-client.mjs";
 import { chooseWorkspaceDirectory } from "./workspace-picker.mjs";
 import {
   inspectMacConnectorService,
@@ -135,7 +134,7 @@ Commands:
   test         Start one fresh local Codex session with the supplied prompt
   stop         Stop the background Connector without removing its credential
   uninstall    Stop the Connector and remove its local service data
-  connect      Authorize this Mac without installing the background service
+  connect      Open Re-entry, redeem a dashboard pairing code, and connect this Mac
   start        Poll for approved work until stopped
   doctor       Check Node.js, Codex, and the optional project directory
   claim-once   Check once for approved work
@@ -272,7 +271,7 @@ async function pair(flags, ui, options = {}) {
 
 async function connect(flags, ui, options = {}) {
   if (!options.quietHeader && ui.interactive) {
-    ui.begin("Connect this Mac", "One browser approval, then Re-entry stays connected");
+    ui.begin("Connect this Mac", "Create a Re-entry account, pair this Mac, then leave it running");
   }
   const receiver = flags.receiver ?? DEFAULT_RECEIVER_ORIGIN;
   const credentialFile = flags["credential-file"] ?? defaultCredentialFile();
@@ -308,28 +307,28 @@ async function connect(flags, ui, options = {}) {
     baseUrl: receiver,
     requestTimeoutMs: DEFAULT_PAIRING_REQUEST_TIMEOUT_MS,
   });
-  if (ui.interactive) ui.wait("Contacting Re-entry…");
-  const credentials = await client.connect(
-    { deviceName: flags["device-name"] ?? defaultDeviceName() },
-    async ({ verificationUri }) => {
-      if (ui.interactive) {
-        ui.stopWait("Secure link", "ready");
-        ui.info("Browser link", verificationUri);
-        await waitForEnterToOpenBrowser();
-        ui.wait("Waiting for approval in your browser…");
-      } else {
-        process.stdout.write(`${JSON.stringify({
-          event: "connector_authorization_waiting",
-          verification_uri: verificationUri,
-        })}\n`);
-      }
-    },
-  );
+  const portalUrl = `${receiver}/user-register?next=${encodeURIComponent("/dashboard")}`;
   if (ui.interactive) {
-    ui.stopWait("Account", "connected");
-    if (!credentials.browserOpened) {
-      ui.warning("Browser", "did not open automatically; use the URL shown above");
+    ui.stopWait("Secure link", "ready");
+    ui.info("Re-entry", portalUrl);
+    ui.info("Next", "Create or sign in, click Pair this Mac, then return here with the code.");
+    if (!(await openBrowser(portalUrl))) {
+      ui.warning("Browser", "could not open automatically; use the URL above");
     }
+  } else {
+    process.stdout.write(`${JSON.stringify({ event: "connector_account_pairing", portal_url: portalUrl })}\n`);
+  }
+  const pairingCode = flags["pairing-code"] ?? await askForPairingCode(
+    ui,
+    "  Enter the pairing code shown in your Re-entry dashboard (XXXX-XXXX): ",
+  );
+  if (ui.interactive) ui.step("Pairing code", "received");
+  const credentials = await client.connectWithPairingCode({
+    pairingCode,
+    deviceName: flags["device-name"] ?? defaultDeviceName(),
+  });
+  if (ui.interactive) {
+    ui.success("Account", "connected");
   }
   const saved = {
     version: 1,
@@ -572,7 +571,7 @@ async function install(flags, ui) {
     ui.success("Selected", readiness.workingDirectory);
     ui.section("2 OF 3", "System check");
     showReadiness(readiness, ui, { includeWorkspace: false });
-    ui.section("3 OF 3", "Connect Re-entry", "Approve this Mac in your browser.");
+    ui.section("3 OF 3", "Connect Re-entry", "Create or sign in to your account, then pair this Mac from the dashboard.");
   }
   const credentials = await connect(runtimeFlags, ui, { quietHeader: true, guidedInstall: true });
   if (ui.interactive) ui.wait("Starting Re-entry in the background…");
@@ -619,12 +618,12 @@ async function start(flags, ui) {
   const store = new LocalConnectorCredentialStore({ filename: credentialFile });
   let credentials = await store.load();
   if (!credentials) {
-    if (ui.interactive) ui.info("Re-entry", "first run — browser approval is required once");
+    if (ui.interactive) ui.info("Re-entry", "first run — create an account and enter a dashboard pairing code");
     credentials = await connect(runtimeFlags, ui, { quietHeader: true });
   } else if (await hasConnectorReauthorizationRequired(credentialFile)) {
     if (ui.interactive) {
       ui.warning("Account", "this Mac needs to be connected again");
-      ui.next("re-entry connect", "Approve this Mac in your browser, then start the Connector again.");
+      ui.next("re-entry connect", "Create a new dashboard pairing code and connect this Mac again.");
     } else {
       process.stdout.write('{"event":"connector_reauthorization_required"}\n');
     }
@@ -857,7 +856,7 @@ function validateCommandFlags(command, flags, positionals) {
   const allowedByCommand = {
     doctor: new Set(["codex-binary", "codex-cd", "json"]),
     pair: new Set(["receiver", "code", "credential-file", "json"]),
-    connect: new Set(["receiver", "device-name", "credential-file", "json"]),
+    connect: new Set(["receiver", "device-name", "credential-file", "pairing-code", "json"]),
     status: new Set(["credential-file", "codex-cd", "codex-binary", "json"]),
     listen: new Set(["json"]),
     test: new Set(["codex-cd", "codex-binary", "activation-timeout", "json"]),
@@ -869,6 +868,7 @@ function validateCommandFlags(command, flags, positionals) {
       "credential-file",
       "codex-cd",
       "codex-binary",
+      "pairing-code",
       "json",
     ]),
     "claim-once": new Set([
@@ -1004,13 +1004,13 @@ function safeErrorMessage(error) {
     : error.message;
 }
 
-async function askForPairingCode(ui) {
+async function askForPairingCode(ui, prompt = "  Enter the pairing code: ") {
   if (!ui.interactive || process.stdin.isTTY !== true) {
     throw cliFailure("connector_pairing_code_missing");
   }
   const readline = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    const answer = await readline.question("  Enter the pairing code from your Host (XXXX-XXXX-XXXX-XXXX): ");
+    const answer = await readline.question(prompt);
     return answer.trim();
   } finally {
     readline.close();

package/src/pairing-client.mjs

@@ -2,15 +2,21 @@ import { spawn } from "node:child_process";
 import { TextDecoder } from "node:util";
 
 export const PAIRING_CLIENT_ROUTES = Object.freeze({
+  accountPairingClaim: "/v0.1/account/pairing-sessions/claim",
   claim: "/v0.1/pairing-sessions/claim",
   poll: "/v0.1/pairing-sessions/poll",
   deviceStart: "/v0.1/device-authorizations",
   devicePoll: "/v0.1/device-authorizations/poll",
 });
 
+export async function openBrowser(url) {
+  return defaultOpenBrowser(url);
+}
+
 const OPTION_FIELDS = Object.freeze(["baseUrl", "requestTimeoutMs", "openBrowser", "sleep"]);
 const PAIR_INPUT_FIELDS = Object.freeze(["userCode"]);
 const CONNECT_INPUT_FIELDS = Object.freeze(["deviceName"]);
+const ACCOUNT_PAIRING_INPUT_FIELDS = Object.freeze(["pairingCode", "deviceName"]);
 const DEVICE_AUTHORIZATION_FIELDS = Object.freeze([
   "type",
   "protocol_version",
@@ -68,6 +74,7 @@ const ERROR_BODY_FIELDS = Object.freeze(["code"]);
 const IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,159}$/;
 const TOKEN_PATTERN = /^[A-Za-z0-9_-]{43}$/;
 const USER_CODE_PATTERN = /^[A-F0-9]{16}$/;
+const ACCOUNT_PAIRING_CODE_PATTERN = /^[A-F0-9]{8}$/;
 const CONTENT_TYPE_PATTERN = /^application\/json(?:\s*;\s*charset=utf-8)?$/i;
 const MIN_REQUEST_TIMEOUT_MS = 100;
 const MAX_REQUEST_TIMEOUT_MS = 60_000;
@@ -197,6 +204,26 @@ export class LocalConnectorPairingClient {
     }
   }
 
+  async connectWithPairingCode(input) {
+    requireExactRecord(
+      input,
+      ACCOUNT_PAIRING_INPUT_FIELDS,
+      ACCOUNT_PAIRING_INPUT_FIELDS,
+      "Account pairing input",
+    );
+    const pairingCode = normalizeAccountPairingCode(input.pairingCode);
+    const deviceName = requireDeviceName(input.deviceName);
+    const response = await this.#post(PAIRING_CLIENT_ROUTES.accountPairingClaim, {
+      pairing_code: pairingCode,
+      device_name: deviceName,
+    });
+    if (response.status !== 200) throw await parseHttpFailure(response);
+    return Object.freeze({
+      ...normalizeCredentials(await parseJsonResponse(response)),
+      browserOpened: false,
+    });
+  }
+
   async #post(path, body) {
     let response;
     try {
@@ -331,6 +358,17 @@ function normalizeCredentials(value) {
   };
 }
 
+function normalizeAccountPairingCode(value) {
+  if (typeof value !== "string") {
+    throw pairingFailure("account_pairing_code_invalid", "Pairing code is invalid");
+  }
+  const normalized = value.replaceAll("-", "").trim().toUpperCase();
+  if (!ACCOUNT_PAIRING_CODE_PATTERN.test(normalized)) {
+    throw pairingFailure("account_pairing_code_invalid", "Pairing code is invalid");
+  }
+  return normalized;
+}
+
 async function parseJsonResponse(response) {
   const declared = response.headers.get("content-length");
   if (declared !== null && (!/^(?:0|[1-9][0-9]*)$/.test(declared) || Number(declared) > MAX_RESPONSE_BYTES)) {