@agentvault/agentvault 0.23.20 → 0.23.21

package/dist/index.js

@@ -64066,6 +64066,17 @@ var init_channel = __esm({
       _pendingPollTimer = null;
       _syncMessageIds = null;
       _deliveryHeartbeat = null;
+      /**
+       * How often to re-check the KeyPackage pool against the server (#826).
+       *
+       * KeyPackages expire after 7 days and, before this, only a reconnect
+       * republished them — so an agent that simply stayed up ran to zero usable
+       * and silently stopped accepting new MLS 1:1 conversations while looking
+       * perfectly healthy. 6h gives ~28 attempts inside one lifetime, so a run of
+       * transient failures cannot age the pool out. Cost is one GET per interval.
+       */
+      static _KP_REPLENISH_INTERVAL_MS = 6 * 60 * 60 * 1e3;
+      _kpReplenishTimer = null;
       _a2aReconcileTimer = null;
       _deliveryPulling = false;
       _drDeliveryPulling = false;
@@ -65030,7 +65041,7 @@ var init_channel = __esm({
        */
       sendActivitySpan(spanData) {
         if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;
-        const pluginVersion = true ? "0.23.20" : "0.0.0-dev";
+        const pluginVersion = true ? "0.23.21" : "0.0.0-dev";
         const agentName = this.config.agentName ?? "Agent";
         const resource = {
           "service.name": "agentvault-agent",
@@ -66940,7 +66951,7 @@ var init_channel = __esm({
                 agentVersion: this.config.agentVersion ?? "0.0.0",
                 // __AV_VERSION__ is injected by esbuild from package.json at build time.
                 // Falls back to "0.0.0-dev" in non-bundled contexts (tests).
-                pluginVersion: true ? "0.23.20" : "0.0.0-dev"
+                pluginVersion: true ? "0.23.21" : "0.0.0-dev"
               });
               this._telemetryReporter.startAutoFlush(3e4);
             }
@@ -66949,6 +66960,7 @@ var init_channel = __esm({
               console.warn("[SecureChannel] A2A channel sync on connect failed:", err);
             });
             await this._ensureKpPoolPublished();
+            this._startKpReplenishTimer();
             this._pullDeliveryQueue().catch((err) => {
               console.warn("[SecureChannel] Initial delivery pull failed:", err);
             });
@@ -67263,7 +67275,7 @@ var init_channel = __esm({
                     agentVersion: this.config.agentVersion ?? "0.0.0",
                     // __AV_VERSION__ is injected by esbuild from package.json at build time.
                     // Falls back to "0.0.0-dev" in non-bundled contexts (tests).
-                    pluginVersion: true ? "0.23.20" : "0.0.0-dev"
+                    pluginVersion: true ? "0.23.21" : "0.0.0-dev"
                   });
                   this._telemetryReporter.startAutoFlush(3e4);
                 }
@@ -67606,6 +67618,7 @@ var init_channel = __esm({
             this._deliveryHeartbeat = null;
           }
           this._stopA2aReconcileTimer();
+          this._stopKpReplenishTimer();
           if (this._stopped) return;
           this._setState("disconnected");
           this._scheduleReconnect();
@@ -68999,6 +69012,103 @@ ${messageText}`;
           this._kpPoolFilling = false;
         }
       }
+      /** Start the periodic KeyPackage replenish (#826). Idempotent. */
+      _startKpReplenishTimer() {
+        this._stopKpReplenishTimer();
+        this._kpReplenishTimer = setInterval(() => {
+          void this._replenishKpPoolFromServer();
+        }, _SecureChannel._KP_REPLENISH_INTERVAL_MS);
+      }
+      _stopKpReplenishTimer() {
+        if (this._kpReplenishTimer) {
+          clearInterval(this._kpReplenishTimer);
+          this._kpReplenishTimer = null;
+        }
+      }
+      /**
+       * The server's EXPIRY-AWARE usable KeyPackage count, or null when unknown.
+       *
+       * `count_unconsumed` filters `expires_at > utcnow()`, which is the only count
+       * that reflects what a peer can actually fetch. Returns null (not 0) on any
+       * failure so callers can tell "server says empty" from "we could not ask" —
+       * guessing 0 here would publish a fresh pool on every transient 503.
+       */
+      async _fetchServerKpCount() {
+        try {
+          const res = await fetch(
+            `${this.config.apiUrl}/api/v1/mls/key-packages/count?device_id=${this._deviceId}`,
+            { headers: { Authorization: `Bearer ${this._deviceJwt}` } }
+          );
+          if (!res.ok) return null;
+          const body = await res.json();
+          const n2 = body?.count;
+          return typeof n2 === "number" && Number.isFinite(n2) ? n2 : null;
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Top the pool up against the SERVER's count (#826).
+       *
+       * ⚠️ DO NOT replace this with a periodic call to `_ensureKpPoolPublished()`.
+       * That function early-returns on `_pendingKpBundles.length >= _KP_POOL_TARGET`,
+       * and that array holds PRIVATE bundles which never expire locally — so on an
+       * agent that has been connected longer than the KeyPackage lifetime it is
+       * still full while the server has zero usable. Measured on prod 2026-08-09:
+       * cortina and eclaude were online and green with 10 unconsumed / 0 usable,
+       * unable to accept any new MLS 1:1. A timer over the local guard would have
+       * run forever and changed nothing.
+       *
+       * Publishes only the shortfall, and never throws — this runs on a timer and
+       * must not be able to take the channel down.
+       */
+      async _replenishKpPoolFromServer() {
+        try {
+          if (this._kpPoolFilling) return;
+          const usable = await this._fetchServerKpCount();
+          if (usable === null) return;
+          const shortfall = _SecureChannel._KP_POOL_TARGET - usable;
+          if (shortfall <= 0) return;
+          this._kpPoolFilling = true;
+          try {
+            const identity = new TextEncoder().encode(this._deviceId);
+            let published = 0;
+            for (let i2 = 0; i2 < shortfall; i2++) {
+              const mlsMgr = new MLSGroupManager();
+              const kp = await mlsMgr.generateKeyPackage(identity);
+              const kpHex = Buffer.from(
+                MLSGroupManager.serializeKeyPackage(kp.publicPackage)
+              ).toString("hex");
+              const res = await fetch(`${this.config.apiUrl}/api/v1/mls/key-packages`, {
+                method: "POST",
+                headers: {
+                  Authorization: `Bearer ${this._deviceJwt}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify({ key_package: kpHex })
+              });
+              if (!res.ok) {
+                console.warn(
+                  `[SecureChannel] KeyPackage replenish rejected (status ${res.status}) after ${published}/${shortfall}`
+                );
+                break;
+              }
+              this._recordPublishedKp(kp);
+              if (!this._mlsKeyPackage) this._mlsKeyPackage = kp;
+              published++;
+            }
+            if (published > 0) {
+              console.log(
+                `[SecureChannel] MLS KeyPackage pool replenished (${published} new; server had ${usable}/${_SecureChannel._KP_POOL_TARGET} usable)`
+              );
+            }
+          } finally {
+            this._kpPoolFilling = false;
+          }
+        } catch (err) {
+          console.warn("[SecureChannel] KeyPackage replenish failed:", err);
+        }
+      }
       async _handleMlsWelcome(data) {
         const groupId = data.group_id;
         const conversationId = data.conversation_id;
@@ -97592,7 +97702,7 @@ var init_index = __esm({
     init_skill_invoker();
     await init_skill_telemetry();
     await init_policy_enforcer();
-    VERSION = true ? "0.23.20" : "0.0.0-dev";
+    VERSION = true ? "0.23.21" : "0.0.0-dev";
   }
 });
 await init_index();