@whittlelabs/sifter 0.30.18 → 0.30.19

package/bin.js

@@ -11433,6 +11433,69 @@ var require_exchange = __commonJS({
   }
 });
 
+// ../../packages/keep/dist/refusal-budget.js
+var require_refusal_budget = __commonJS({
+  "../../packages/keep/dist/refusal-budget.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.RefusalBudget = exports2.REFUSAL_SPAN_MS = exports2.REFUSED_EXCHANGES_PER_SPAN = exports2.KeepCredentialsRefusedError = void 0;
+    var KeepCredentialsRefusedError = class extends Error {
+      code = "CREDENTIALS_REFUSED";
+      /** Host the exchange was sent to. */
+      host;
+      /** When the manager will next send an exchange for these credentials (epoch ms). */
+      retryAt;
+      /** How long from now that is (ms); zero while the budget has room. */
+      retryAfterMs;
+      constructor(message, detail) {
+        super(message);
+        this.name = "KeepCredentialsRefusedError";
+        this.host = detail.host;
+        this.retryAt = detail.retryAt;
+        this.retryAfterMs = Math.max(0, detail.retryAt - Date.now());
+      }
+    };
+    exports2.KeepCredentialsRefusedError = KeepCredentialsRefusedError;
+    var KEEP_EXCHANGE_WINDOW_MS = 15 * 6e4;
+    exports2.REFUSED_EXCHANGES_PER_SPAN = 3;
+    exports2.REFUSAL_SPAN_MS = KEEP_EXCHANGE_WINDOW_MS + 3e4;
+    var RefusalBudget = class {
+      refusedAt = [];
+      last = null;
+      /** Throws the last refusal while the budget is spent; a no-op while it has room. */
+      check() {
+        const last = this.last;
+        if (last === null)
+          return;
+        const retryAt = this.nextExchangeAt();
+        if (Date.now() >= retryAt)
+          return;
+        const when = new Date(retryAt).toISOString().replace(/\.\d{3}Z$/, "Z");
+        throw new KeepCredentialsRefusedError(`${last.message} (refused ${this.refusedAt.length} times in ${exports2.REFUSAL_SPAN_MS / 6e4} minutes; not asking Keep again before ${when})`, { host: last.host, retryAt });
+      }
+      /** Record a 401 and return the error to throw for it. */
+      refuse(detail) {
+        this.refusedAt.push(Date.now());
+        this.last = new KeepCredentialsRefusedError(detail.message, { host: detail.host, retryAt: this.nextExchangeAt() });
+        return this.last;
+      }
+      /** Keep issued a token, which clears its count; so does this. */
+      clear() {
+        this.refusedAt = [];
+        this.last = null;
+      }
+      nextExchangeAt() {
+        const now = Date.now();
+        this.refusedAt = this.refusedAt.filter((at) => now - at < exports2.REFUSAL_SPAN_MS);
+        if (this.refusedAt.length < exports2.REFUSED_EXCHANGES_PER_SPAN)
+          return now;
+        return this.refusedAt[this.refusedAt.length - exports2.REFUSED_EXCHANGES_PER_SPAN] + exports2.REFUSAL_SPAN_MS;
+      }
+    };
+    exports2.RefusalBudget = RefusalBudget;
+  }
+});
+
 // ../../packages/keep/dist/wait-for-token.js
 var require_wait_for_token = __commonJS({
   "../../packages/keep/dist/wait-for-token.js"(exports2) {
@@ -11511,6 +11574,7 @@ var require_service_token = __commonJS({
     exports2.ServiceTokenManager = void 0;
     var rate_limited_1 = require_rate_limited();
     var exchange_1 = require_exchange();
+    var refusal_budget_1 = require_refusal_budget();
     var wait_for_token_1 = require_wait_for_token();
     var ServiceTokenManager = class {
       token = null;
@@ -11518,6 +11582,8 @@ var require_service_token = __commonJS({
       pendingExchange = null;
       /** Closed by a 429 until Keep's retry-after: no exchange is sent before it. */
       rateLimit = new rate_limited_1.RateLimitGate();
+      /** Spent by refused exchanges: past it, no exchange is sent until the oldest ages out. */
+      refusals = new refusal_budget_1.RefusalBudget();
       keepApiUrl;
       clientId;
       clientSecret;
@@ -11539,8 +11605,11 @@ var require_service_token = __commonJS({
        *
        * Throws `KeepUnavailableError` when Keep did not answer or answered 5xx,
        * `KeepRateLimitedError` when Keep's exchange limiter locked this client out
-       * (and, until the time Keep named, without asking again), and a plain `Error`
-       * for any other refusal, a 401 above all. A refresh that fails for either
+       * (and, until the time Keep named, without asking again),
+       * `KeepCredentialsRefusedError` for a 401 (and, once three fall inside one of
+       * Keep's lockout windows, without asking again until the oldest ages out:
+       * see `RefusalBudget`), and a plain `Error` for any other refusal. A refresh
+       * that fails for either
        * of the first two reasons while the cached token has not yet expired
        * answers with the cached token instead: the refresh starts 30s early
        * precisely so a failed one costs nothing.
@@ -11573,6 +11642,7 @@ var require_service_token = __commonJS({
       async refresh() {
         try {
           this.rateLimit.check();
+          this.refusals.check();
           return await this.exchange();
         } catch (err) {
           const code = err?.code;
@@ -11590,8 +11660,10 @@ var require_service_token = __commonJS({
           clientSecret: this.clientSecret,
           rateLimit: this.rateLimit,
           onResponse: this.onResponse,
-          exchangeName: "Token exchange"
+          exchangeName: "Token exchange",
+          refused: (message) => this.refusals.refuse({ message: `[ServiceTokenManager] ${message}`, host: (0, exchange_1.hostOf)(this.keepApiUrl) })
         });
+        this.refusals.clear();
         this.token = data.token;
         this.expiresAt = Date.now() + data.expiresIn * 1e3;
         return this.token;
@@ -11678,7 +11750,7 @@ var require_dist2 = __commonJS({
   "../../packages/keep/dist/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.waitForKeepToken = exports2.KeepRateLimitedError = exports2.KeepUnavailableError = exports2.AgentCredentialRevokedError = exports2.AgentTokenManager = exports2.ServiceTokenManager = exports2.KeepClient = void 0;
+    exports2.waitForKeepToken = exports2.KeepCredentialsRefusedError = exports2.KeepRateLimitedError = exports2.KeepUnavailableError = exports2.AgentCredentialRevokedError = exports2.AgentTokenManager = exports2.ServiceTokenManager = exports2.KeepClient = void 0;
     var client_1 = require_client();
     Object.defineProperty(exports2, "KeepClient", { enumerable: true, get: function() {
       return client_1.KeepClient;
@@ -11702,6 +11774,10 @@ var require_dist2 = __commonJS({
     Object.defineProperty(exports2, "KeepRateLimitedError", { enumerable: true, get: function() {
       return rate_limited_1.KeepRateLimitedError;
     } });
+    var refusal_budget_1 = require_refusal_budget();
+    Object.defineProperty(exports2, "KeepCredentialsRefusedError", { enumerable: true, get: function() {
+      return refusal_budget_1.KeepCredentialsRefusedError;
+    } });
     var wait_for_token_1 = require_wait_for_token();
     Object.defineProperty(exports2, "waitForKeepToken", { enumerable: true, get: function() {
       return wait_for_token_1.waitForKeepToken;
@@ -27010,7 +27086,7 @@ var import_path = require("path");
 var import_promises = require("fs/promises");
 var import_yaml = __toESM(require_dist3());
 var import_shuttle = __toESM(require_dist5());
-var buildVersion = true ? "0.30.18" : pkg.version;
+var buildVersion = true ? "0.30.19" : pkg.version;
 var sifterBrand = {
   product: {
     id: "sifter",