feat(poller): add enhanced rate-limit protection

Author: hesreallyhim

dist/github.d.ts

@@ -13,10 +13,18 @@ export interface FetchRateLimitResult {
     data: RateLimitResponse;
     timestamp: string;
 }
+export interface RateLimitErrorDetails {
+    status: number;
+    message: string | null;
+    rate_limit_remaining: number | null;
+    rate_limit_reset: number | null;
+    retry_after_seconds: number | null;
+}
 export interface FetchRateLimitError {
     success: false;
     error: string;
     timestamp: string;
+    rate_limit?: RateLimitErrorDetails;
 }
 export type FetchRateLimitOutcome = FetchRateLimitResult | FetchRateLimitError;
 /**

dist/poller/github.d.ts

@@ -13,10 +13,18 @@ export interface FetchRateLimitResult {
     data: RateLimitResponse;
     timestamp: string;
 }
+export interface RateLimitErrorDetails {
+    status: number;
+    message: string | null;
+    rate_limit_remaining: number | null;
+    rate_limit_reset: number | null;
+    retry_after_seconds: number | null;
+}
 export interface FetchRateLimitError {
     success: false;
     error: string;
     timestamp: string;
+    rate_limit?: RateLimitErrorDetails;
 }
 export type FetchRateLimitOutcome = FetchRateLimitResult | FetchRateLimitError;
 /**

dist/poller/index.d.ts

@@ -2,4 +2,5 @@ export { spawnPoller, type SpawnResult, type SpawnError, type SpawnOutcome } fro
 export { killPoller, killPollerWithVerification, isProcessRunning, type KillResult, type KillError, type KillOutcome, } from './kill';
 export { computeSleepPlan, applyDebounce, POLL_DEBOUNCE_MS, type SleepPlan } from './sleep-plan';
 export { performPoll, buildDiagnosticsEntry } from './perform-poll';
+export { applyRateLimitGate, buildRateLimitErrorEntry, classifyRateLimitError, createRateLimitControlState, handleRateLimitError, resetRateLimitControl, MAX_SECONDARY_RETRIES, SECONDARY_DEFAULT_WAIT_MS, type RateLimitControlState, type RateLimitDecision, type RateLimitEvent, type RateLimitGateResult, } from './rate-limit-control';
 export { main, runPollerLoop, createShutdownHandler, isDiagnosticsEnabled, type LoopDeps, } from './loop';