heuristic

type AnalysisResult struct {
	// ShouldRetry indicates whether the response suggests a retry is warranted.
	ShouldRetry bool

	// Confidence represents how confident the analysis is (0.0 to 1.0).
	// Higher values indicate more certainty that the response is an error.
	Confidence float64

	// Reason provides a machine-readable classification of why retry is suggested.
	Reason string

	// Structure contains the structural classification of the response.
	Structure ResponseStructure

	// Details provides additional human-readable context for debugging.
	Details string

	// MatchedPattern is the specific error pattern that matched (from Tier 3 indicator analysis).
	// Empty for non-indicator results.
	MatchedPattern string
}

type Analyzer interface {
	// Analyze performs heuristic analysis on a response to determine if it's likely an error.
	// Parameters:
	//   - responseBytes: The raw response payload
	//   - httpStatusCode: The HTTP status code from the endpoint
	//   - rpcType: The RPC type for protocol-specific analysis
	//   - jsonrpcMethod: The JSON-RPC method name for method-aware checks (e.g., "eth_blockNumber").
	//     Empty string means unknown/non-JSON-RPC — method-aware checks are skipped.
	//
	// Returns an AnalysisResult with retry recommendation and confidence level.
	Analyze(responseBytes []byte, httpStatusCode int, rpcType sharedtypes.RPCType, jsonrpcMethod string) AnalysisResult
}

type AnalyzerConfig struct {
	// MaxPrefixBytes is the maximum number of bytes to inspect for heuristics.
	// Default: 512 bytes. Larger values may catch more edge cases but cost more CPU.
	MaxPrefixBytes int

	// ConfidenceThreshold is the minimum confidence level to suggest retry.
	// Default: 0.5. Set higher for fewer false positives, lower for more aggressive retries.
	ConfidenceThreshold float64

	// EnableTier3 controls whether error indicator pattern matching is performed.
	// Default: true. Disable if you want only structural and protocol checks.
	EnableTier3 bool
}

type ErrorCategory int

type IndicatorResult struct {
	// Found indicates whether an error pattern was detected.
	Found bool
	// Category is the type of error detected.
	Category ErrorCategory
	// Pattern is the specific pattern that matched.
	Pattern string
	// Confidence is how confident we are this indicates an error.
	Confidence float64
}

type ResponseAnalyzer struct {
	// contains filtered or unexported fields
}

type ResponseStructure int