/** * ps_state Tool * * Manages and queries agent state, drift metrics, * circuit breaker status, and system health. */ import type { CircuitBreakerStateValue } from '../types/index.js'; export interface AgentStateResult { agentId: string; exists: boolean; state?: { activeFrame: string | null; lastAction: string | null; lastActionTime: number | null; operationCount: number; successRate: number; driftScore: number; circuitBreakerState: CircuitBreakerStateValue; delegations: { asParent: number; asChild: number; }; }; health: 'healthy' | 'warning' | 'critical' | 'halted'; recommendations: string[]; } export interface SystemStateResult { timestamp: number; agents: { total: number; healthy: number; warning: number; critical: number; halted: number; }; operations: { total: number; successful: number; blocked: number; failed: number; }; drift: { alertCount: number; activeAlerts: Array<{ alertId: string; agentId: string; timestamp: number; type: string; severity: string; message: string; resolved?: boolean; }>; meanDriftScore: number; maxDriftScore: number; }; circuitBreakers: { closed: number; open: number; halfOpen: number; }; thresholds: { preExecute: number; postAudit: number; coverageMinimum: number; driftThreshold: number; }; } export declare function ps_state_get(agentId: string): AgentStateResult; export declare function ps_state_system(): SystemStateResult; export interface ResetRequest { agentId: string; resetCircuitBreaker?: boolean; resetDriftMetrics?: boolean; resetBaseline?: boolean; reason: string; } export interface ResetResult { success: boolean; agentId: string; reset: { circuitBreaker: boolean; driftMetrics: boolean; baseline: boolean; }; newState: AgentStateResult; } export declare function ps_state_reset(request: ResetRequest): ResetResult; export interface RecalibrateRequest { agentId: string; newBaseline?: { frame: string; expectedBehavior: string[]; }; } export interface RecalibrateResult { success: boolean; agentId: string; previousDriftScore: number; newDriftScore: number; message: string; } export declare function ps_state_recalibrate(request: RecalibrateRequest): RecalibrateResult; export interface HaltRequest { agentId: string; reason: string; } export declare function ps_state_halt(request: HaltRequest): { success: boolean; message: string; }; export interface ResumeRequest { agentId: string; reason: string; resetMetrics?: boolean; } export declare function ps_state_resume(request: ResumeRequest): { success: boolean; message: string; }; export interface DriftHistoryRequest { agentId: string; since?: number; limit?: number; } export interface DriftHistoryResult { agentId: string; entries: Array<{ timestamp: number; driftScore: number; frame: string; action: string; alert?: { type: string; message: string; }; }>; trend: 'increasing' | 'decreasing' | 'stable'; summary: { minDrift: number; maxDrift: number; avgDrift: number; alertCount: number; }; } export declare function ps_state_drift_history(request: DriftHistoryRequest): DriftHistoryResult; //# sourceMappingURL=ps_state.d.ts.map