instar 1.3.110 → 1.3.111

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmSH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwvDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAs8OtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmSH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwvDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA49OtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/commands/server.js

@@ -5325,6 +5325,26 @@ export async function startServer(options) {
         sessionManager.on('apiErrorAtIdle', (sessionName) => {
             rateLimitSentinel.report(sessionName, 'idle-error', { errorClass: 'transient-api' });
         });
+        // Observability: every RateLimitSentinel lifecycle transition → the shared
+        // sentinel-events.jsonl audit trail, so a throttle recovery is never
+        // invisible (the 2026-05-30 ask: "instrument so we can SEE it working").
+        // Complements the recovery-reached/unreachable notify-outcome events above;
+        // together they trace detect → backoff/resume(attempt N) → recovered/escalated.
+        {
+            const rlMaxAttempts = rlsCfg.maxAttempts ?? 6;
+            const rlEvent = (kind, sessionName, detail) => {
+                const entry = { timestamp: new Date().toISOString(), kind, sentinel: 'rate-limit', sessionName, detail };
+                console.log(`[sentinel:${kind}] rate-limit/${sessionName} — ${detail}`);
+                try {
+                    fs.appendFileSync(rlReachLogPath, JSON.stringify(entry) + '\n');
+                }
+                catch { /* @silent-fallback-ok best-effort audit; never crash the monitor path */ }
+            };
+            rateLimitSentinel.on('rate-limit:detected', (s) => rlEvent('throttle-detected', s.sessionName, `trigger=${s.trigger}`));
+            rateLimitSentinel.on('rate-limit:resuming', (s) => rlEvent('throttle-resuming', s.sessionName, `attempt ${s.attempts}/${rlMaxAttempts} after ${Math.round((s.backoffMs ?? 0) / 1000)}s backoff`));
+            rateLimitSentinel.on('rate-limit:recovered', (s) => rlEvent('throttle-recovered', s.sessionName, `jsonl grew ${s.jsonlDelta ?? 0}b after ${s.attempts} attempt(s)`));
+            rateLimitSentinel.on('rate-limit:escalated', (s) => rlEvent('throttle-escalated', s.sessionName, s.reason ?? 'unknown'));
+        }
         if (rlsCfg.enabled !== false) {
             console.log(pc.green('  RateLimitSentinel enabled (server-throttle backoff + check-ins)'));
         }