@ar-ai/brink-cli 1.0.6 → 1.0.9

package/README.md

@@ -1,6 +1,9 @@
 # Brink
 
-**Made by rexy and brink.** Brink is a local AgentRouter proxy for Claude Code and Codex. It provides guided client setup, protocol bridges, bounded retries for transient provider failures, and a terminal dashboard.
+made by rexy and brink  
+compiled by cr33p1ngp4ck3t/creepingpacket
+
+Brink is a local AgentRouter proxy for Claude Code and Codex. It provides guided client setup, protocol bridges, bounded retries for transient provider failures, and a terminal dashboard.
 
 ## Install and run
 
@@ -23,6 +26,18 @@ npx @ar-ai/brink-cli
 
 For a project-local installation, use `npm install @ar-ai/brink-cli`, then `npx brink`. The runtime supports Windows, macOS, and Linux; selected client installers require a supported 64-bit platform.
 
+## Retry waits
+
+Brink retries temporary rate limits, server errors, and connection resets up to five times, using base waits of **5, 15, 30, 60, and 120 seconds** before each retry. A valid `Retry-After` header (seconds or an HTTP date) takes precedence when it requests a longer wait. Each cooldown also adds up to 10% random extra time, capped at five seconds, so users do not all retry together. Without longer server cooldowns, the waits total about four minutes, plus time spent on upstream attempts.
+
+The client must stay connected while Brink waits. Cancellation stops pending retries. Requests are retried only before output begins; authentication, billing, and quota errors are returned immediately. Clients that explicitly own retries bypass this schedule. The dashboard reports each retry and its wait.
+
+## Update notices
+
+When the proxy starts, Brink checks npm for a newer stable release in the background. If one is available, the activity log (or plain terminal output) shows **New version available** and the command `npm install --global @ar-ai/brink-cli@latest`. Stop Brink before updating, then restart it.
+
+The check sends only a public package-metadata request to `registry.npmjs.org`; no AgentRouter key, prompts, or client settings are included. It has a three-second timeout. Offline or failed checks stay quiet, and Brink never updates itself automatically.
+
 ## Commands
 
 | Command | Purpose |
@@ -38,22 +53,3 @@ For a project-local installation, use `npm install @ar-ai/brink-cli`, then `npx
 `brink update` changes credentials. To update the software, stop Brink and run `npm install --global @ar-ai/brink-cli@latest`.
 
 Settings are saved in `~/.config/brink/config.json` (or `BRINK_CONFIG_HOME`). Setup also writes selected clients' user settings. Credentials are stored locally without encryption; Windows file access follows your profile permissions. Model access, quota, and billing remain controlled by AgentRouter.
-
-## Develop and verify
-
-Run these commands from the repository root:
-
-```sh
-npm ci
-node support/brink.js --help
-npm pack
-```
-
-The help command checks CLI startup without provider calls or client settings changes. npm needs registry access or cached runtime dependencies.
-
-Before publishing, you can distribute and install the tarball locally:
-
-```sh
-npm install --global ./ar-ai-brink-cli-1.0.4.tgz
-brink --help
-```

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@ar-ai/brink-cli",
-  "version": "1.0.6",
+  "version": "1.0.9",
   "description": "Local AgentRouter proxy and guided setup for Claude Code and Codex.",
   "author": "rexy and brink",
+  "contributors": ["cr33p1ngp4ck3t/creepingpacket"],
   "license": "UNLICENSED",
   "type": "commonjs",
   "bin": {
     "brink": "support/brink.js"
   },
   "files": [
-    "support/*.js"
+    "support/*.js",
+    "support/package.json"
   ],
   "engines": {
     "node": ">=24"

package/support/brand.js

@@ -107,4 +107,4 @@ function mascotLines(width, maxRows) {
   return [];
 }
 
-module.exports = { duck, cat, mascotLines, credit: "made by rexy and brink" };
+module.exports = { duck, cat, mascotLines, credit: "made by rexy and brink\ncompiled by cr33p1ngp4ck3t/creepingpacket" };

package/support/brink.js

@@ -136,7 +136,7 @@ async function setup() {
         "Run brink and keep that terminal open.",
         ...ready.map((client) => `In a second terminal, run ${results[client].executable || client}.`),
         "In either client, use /model to choose a model.",
-        "Rate-limit, server-error and connection-reset retry waits: 1, 2, 3, 4, 5 seconds. No model substitution.",
+        "Rate-limit, server-error and connection-reset base retry waits: 5, 15, 30, 60, 120 seconds; Retry-After and small random delays can extend them. No model substitution.",
         ...(failures.length ? ["Some clients were not changed. Run brink setup again to finish them."] : []),
       ]);
     } else { ui.step("No client was configured", "Fix the issue above, then run brink setup again."); }

package/support/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@ar-ai/brink-cli",
+  "version": "1.0.9",
+  "private": true,
+  "type": "commonjs",
+  "engines": { "node": ">=24" },
+  "dependencies": {
+    "toml-eslint-parser": "1.0.3"
+  }
+}

package/support/proxy.js

@@ -6,6 +6,7 @@ const { bridgeMessages } = require("./messages-bridge");
 const { adaptModelCatalog } = require("./model-catalog");
 const { createMonitor } = require("./monitor");
 const { startTerminalUI } = require("./terminal-ui");
+const { checkForUpdate } = require("./update-notice");
 const { createUsageObserver } = require("./usage");
 const {
   cleanHeaders,
@@ -475,6 +476,7 @@ server.listen(LISTEN_PORT, LISTEN_HOST, () => {
   );
   monitor.log(
     "info",
-    "AgentRouter upstream: https://agentrouter.org/v1; transient-failure retry waits 1/2/3/4/5 seconds before output (client-owned retries bypassed); no model or credential substitution",
+    "AgentRouter upstream: https://agentrouter.org/v1; transient-failure retry base waits 5/15/30/60/120 seconds, respecting Retry-After plus jitter before output (client-owned retries bypassed); no model or credential substitution",
   );
+  void checkForUpdate((message) => monitor.log("info", message));
 });

package/support/setup-ui.js

@@ -51,7 +51,6 @@ function createSetupUI({ input = process.stdin, output = process.stdout } = {})
       { text: detail, tone: "dim" },
       { text: "", tone: "dim" },
       { text: "Start with brink", tone: "amber" },
-      { text: credit, tone: "dim" },
     ];
     const room = width();
     const rows = output.rows || 24;
@@ -72,8 +71,8 @@ function createSetupUI({ input = process.stdin, output = process.stdout } = {})
       line("BRINK", "section");
       line(title, "bold");
       line(detail, "dim");
-      line(credit, "dim");
     }
+    for (const text of credit.split("\n")) line(text, "dim");
     line("─".repeat(room), "dim");
   }
 

package/support/terminal-ui.js

@@ -371,13 +371,14 @@ function startTerminalUI(monitor, { clients = [] } = {}) {
     const rows = Math.max(1, output.rows || 24);
     const resized = columns !== previousColumns || rows !== previousRows;
     const frame = masthead(columns, rows);
+    const creditLines = credit.split("\n");
     if (columns < 48 || rows < 12) {
       const contentWidth = Math.max(1, columns - 2);
       const traffic = trafficLines(contentWidth);
       const logs = logLines(contentWidth);
       lastTrafficLines = traffic.length;
       lastLogLines = logs.lines.length;
-      const footerRows = rows >= 12 ? 3 : 1;
+      const footerRows = rows >= 12 ? 2 + creditLines.length : 1;
       const availableRows = Math.max(0, rows - frame.length - footerRows);
       bodyHeight = Math.max(0, Math.floor((availableRows - 2) / 2));
       logBodyHeight = Math.max(0, availableRows - bodyHeight - 2);
@@ -398,9 +399,9 @@ function startTerminalUI(monitor, { clients = [] } = {}) {
       while (frame.length < rows - footerRows) frame.push(paint("", columns));
       frame.length = Math.min(frame.length, Math.max(0, rows - footerRows));
       frame.push(paint(searching ? ` Search: ${searchDraft}_` : " q Quit / Search p Pause c Clear f Level", columns, "text"));
-      if (footerRows === 3) {
+      if (footerRows > 1) {
         frame.push(paint(" Arrows Logs | j/k Overview | v Preview", columns, "muted"));
-        frame.push(paint(` ${credit}`, columns, "muted"));
+        for (const text of creditLines) frame.push(paint(` ${text}`, columns, "muted"));
       }
     } else {
       const leftWidth = Math.floor((columns - 1) / 2);
@@ -417,7 +418,7 @@ function startTerminalUI(monitor, { clients = [] } = {}) {
           paint("│", 1, "border") +
           paint(rightHeader, rightWidth, "section", true),
       );
-      bodyHeight = Math.max(1, rows - frame.length - 4);
+      bodyHeight = Math.max(1, rows - frame.length - 3 - creditLines.length);
       logBodyHeight = bodyHeight;
       const traffic = trafficLines(leftContent);
       const logs = logLines(rightContent);
@@ -467,7 +468,7 @@ function startTerminalUI(monitor, { clients = [] } = {}) {
             ? " q Quit p Pause c Clear f Level / Search | Up/Down Logs | j/k Traffic v Preview"
             : " q Quit p Pause c Clear f Level / Search v Preview";
       frame.push(paint(help, columns, "text"));
-      frame.push(paint(` ${credit}`, columns, "muted"));
+      for (const text of creditLines) frame.push(paint(` ${text}`, columns, "muted"));
     }
     let buffer = resized ? `${ESC}2J` : "";
     for (let i = 0; i < frame.length; i++) {

package/support/transport.js

@@ -141,8 +141,12 @@ function retryableFailure(status, value, text = "") {
   return null;
 }
 
-function retryDelay(retry) {
-  return retry * 1000;
+function retryDelay(retry, retryAfter) {
+  const value = typeof retryAfter === "string" ? retryAfter.trim() : "";
+  const serverDelay = /^\d+$/.test(value) ? Number(value) * 1000 :
+    /^[A-Za-z]{3}, \d{2} [A-Za-z]{3} \d{4} \d{2}:\d{2}:\d{2} GMT$/.test(value) ? Date.parse(value) - Date.now() : 0;
+  const delay = Math.max([5_000, 15_000, 30_000, 60_000, 120_000][retry - 1], Number.isFinite(serverDelay) ? serverDelay : 0);
+  return delay + Math.floor(Math.random() * Math.min(delay * 0.1, 5000));
 }
 
 function cancelledError() {
@@ -151,21 +155,25 @@ function cancelledError() {
   });
 }
 
-// The fixed 1–5 second retry waits remain cancellable on client disconnect.
-function waitForRetry(delay, signal) {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) return reject(cancelledError());
-    const abort = () => {
-      clearTimeout(timer);
-      signal.removeEventListener("abort", abort);
-      reject(cancelledError());
-    };
-    const timer = setTimeout(() => {
-      signal?.removeEventListener("abort", abort);
-      resolve();
-    }, delay);
-    signal?.addEventListener("abort", abort, { once: true });
-  });
+// Long server cooldowns use bounded timers and remain cancellable.
+async function waitForRetry(delay, signal) {
+  while (delay > 0) {
+    const interval = Math.min(delay, 2_147_483_647);
+    await new Promise((resolve, reject) => {
+      if (signal?.aborted) return reject(cancelledError());
+      const abort = () => {
+        clearTimeout(timer);
+        signal.removeEventListener("abort", abort);
+        reject(cancelledError());
+      };
+      const timer = setTimeout(() => {
+        signal?.removeEventListener("abort", abort);
+        resolve();
+      }, interval);
+      signal?.addEventListener("abort", abort, { once: true });
+    });
+    delay -= interval;
+  }
 }
 
 function harmlessPrelude(value, event) {
@@ -396,7 +404,7 @@ async function requestWithRetries(target, options, body, {
       if (signal?.aborted) throw cancelledError();
       if (retryReason && !clientOwnsRetries && attempt < MAX_RETRIES) {
         const retry = attempt + 1;
-        const delay = retryDelay(retry);
+        const delay = retryDelay(retry, response?.headers["retry-after"]);
         response?.destroy();
         request?.destroy();
         tracker?.note("warn", `${upstreamFailure(null, { code: retryReason })}; retry ${retry}/${MAX_RETRIES} in ${delay}ms`);

package/support/update-notice.js

@@ -0,0 +1,40 @@
+"use strict";
+
+const { name, version } = require("./package.json");
+
+function versionParts(value) {
+  if (typeof value !== "string" || !/^\d+\.\d+\.\d+$/.test(value)) return null;
+  const parts = value.split(".").map(Number);
+  return parts.every(Number.isSafeInteger) ? parts : null;
+}
+
+async function checkForUpdate(notify) {
+  try {
+    const response = await fetch('https://registry.npmjs.org/' + encodeURIComponent(name) + '/latest', {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(3000),
+      redirect: "error",
+    });
+    if (!response.ok) { await response.body?.cancel(); return; }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let bytes = 0;
+    for (;;) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      bytes += value.byteLength;
+      if (bytes > 16 * 1024) { await reader.cancel(); return; }
+      chunks.push(Buffer.from(value));
+    }
+    const latest = JSON.parse(Buffer.concat(chunks, bytes).toString("utf8"))?.version;
+    const candidate = versionParts(latest);
+    const current = versionParts(version);
+    if (!candidate || !current) return;
+    const differing = candidate.findIndex((part, index) => part !== current[index]);
+    if (differing >= 0 && candidate[differing] > current[differing]) {
+      notify('New version available: ' + version + ' -> ' + latest + '. Update: npm install --global ' + name + '@latest');
+    }
+  } catch {} // Registry outages must not interrupt the proxy.
+}
+
+module.exports = { checkForUpdate };