71bcc3b3c5
- Added telemetry utility to capture application events and metrics. - Integrated PostHog for event tracking with distinct user identification. - Implemented telemetry initialization, event capturing, and shutdown procedures. feat: add UV environment setup for Python management - Created utilities to manage Python installation and configuration. - Implemented network optimization checks for Python installation mirrors. - Added functions to set up managed Python environments with error handling. feat: enhance host API communication with token management - Introduced host API token retrieval and management for secure requests. - Updated host API fetch functions to include token in headers. - Added support for creating event sources with authentication. test: add comprehensive tests for gateway protocol and startup helpers - Implemented unit tests for gateway protocol helpers, event dispatching, and state management. - Added tests for startup recovery strategies and process policies. - Ensured coverage for connection monitoring and restart governance logic.
76 lines
1.8 KiB
TypeScript
76 lines
1.8 KiB
TypeScript
export type RestartDecision =
|
|
| { allow: true }
|
|
| {
|
|
allow: false;
|
|
reason: 'cooldown_active';
|
|
retryAfterMs: number;
|
|
};
|
|
|
|
type RestartGovernorOptions = {
|
|
cooldownMs: number;
|
|
};
|
|
|
|
const DEFAULT_OPTIONS: RestartGovernorOptions = {
|
|
cooldownMs: 2500,
|
|
};
|
|
|
|
export class GatewayRestartGovernor {
|
|
private readonly options: RestartGovernorOptions;
|
|
private lastRestartAt = 0;
|
|
private suppressedTotal = 0;
|
|
private executedTotal = 0;
|
|
|
|
constructor(options?: Partial<RestartGovernorOptions>) {
|
|
this.options = { ...DEFAULT_OPTIONS, ...options };
|
|
}
|
|
|
|
onRunning(_now = Date.now()): void {
|
|
// Kept for interface compatibility with ClawX lifecycle wiring.
|
|
}
|
|
|
|
decide(now = Date.now()): RestartDecision {
|
|
if (this.lastRestartAt > 0) {
|
|
const sinceLast = now - this.lastRestartAt;
|
|
if (sinceLast < this.options.cooldownMs) {
|
|
this.suppressedTotal = this.safeIncrement(this.suppressedTotal);
|
|
return {
|
|
allow: false,
|
|
reason: 'cooldown_active',
|
|
retryAfterMs: this.options.cooldownMs - sinceLast,
|
|
};
|
|
}
|
|
}
|
|
|
|
return { allow: true };
|
|
}
|
|
|
|
recordExecuted(now = Date.now()): void {
|
|
this.executedTotal = this.safeIncrement(this.executedTotal);
|
|
this.lastRestartAt = now;
|
|
}
|
|
|
|
getCounters(): { executedTotal: number; suppressedTotal: number } {
|
|
return {
|
|
executedTotal: this.executedTotal,
|
|
suppressedTotal: this.suppressedTotal,
|
|
};
|
|
}
|
|
|
|
getObservability(): {
|
|
suppressed_total: number;
|
|
executed_total: number;
|
|
circuit_open_until: number;
|
|
} {
|
|
return {
|
|
suppressed_total: this.suppressedTotal,
|
|
executed_total: this.executedTotal,
|
|
circuit_open_until: 0,
|
|
};
|
|
}
|
|
|
|
private safeIncrement(current: number): number {
|
|
if (current >= Number.MAX_SAFE_INTEGER) return 0;
|
|
return current + 1;
|
|
}
|
|
}
|