utils

Aug 18, 2026

Changes in this version

+ func SafeGo(logger *slog.Logger, name string, fn func(), attrs ...slog.Attr)

Jul 23, 2026

Changes in this version

+ type SecurityAnalysisView struct

+ ChainClassifications []string

+ ChainLength int

+ ChainSubcommands []string

+ Modifies string

+ Recommendation string

+ RiskAssessment string

+ Summary string

Jul 17, 2026

Changes in this version

type ApprovalChoice

+ const ApprovalChoiceAlwaysAsk

Jun 9, 2026

Changes in this version

+ const ApprovalPromptTimeout

+ var ErrPromptTimeout = errors.New("prompt timed out waiting for input")

+ func ReadLineWithTimeout(reader *bufio.Reader, d time.Duration) (string, error)

Jun 1, 2026

Changes in this version

+ var FilesystemSecurityPromptHook func(prompt, path, folder string, tier FilesystemPromptTier) ApprovalChoice

+ var SecurityPromptHook func(prompt, command string) ApprovalChoice

+ func CapitalizeWords(s string) string

+ func ClearLine() — darwin/amd64, js/wasm, linux/amd64

+ func ClearScreen() — darwin/amd64, js/wasm, linux/amd64

+ func ClearScreen() error — windows/amd64

+ func CreateBackup(filePath string) error

+ func DefaultChoiceHint(defaultYes bool) string

+ func EstimateTokens(text string) int

+ func ExtractJSON(input string) (string, error)

+ func FormatError(err error) string

+ func FormatFileSize(size int64) string

+ func GenerateFileRevisionHash(filename, code string) string

+ func GenerateRequestHash(instructions string) string

+ func GetAllProviderLimiters() map[string]TokenBucketInfo

+ func GetCurrentTimestamp() int64

+ func GetTimestamp() string

+ func HideCursor()

+ func IsCriticalError(err error) bool

+ func IsEmptyString(s string) bool

+ func IsInteractive() bool — windows/amd64

+ func IsNetworkError(err error) bool

+ func IsValidFileExtension(filename string, allowedExtensions []string) bool

+ func IsValidationError(err error) bool

+ func LogLLMResponse(filename, response string)

+ func LogUserPrompt(prompt string)

+ func MoveCursor(row, col int) — darwin/amd64, js/wasm, linux/amd64

+ func MoveCursorTo(x, y int) — windows/amd64

+ func RemoveProviderRateLimiter(providerName string)

+ func RestoreCursorPosition() — darwin/amd64, js/wasm, linux/amd64

+ func RestoreTerminal() error — windows/amd64

+ func SaveCursorPosition() — darwin/amd64, js/wasm, linux/amd64

+ func SetProviderRate(providerName string, rate float64, burst int)

+ func SetRawMode() error — windows/amd64

+ func ShowCursor()

+ func SplitTopLevelJSONObjects(s string) []string

+ func StringSliceEqual(a, b []string) bool

+ func TruncateString(s string, maxLength int) string

+ func ValidateJSONFields(jsonStr string, requiredFields []string) error

+ func WrapError(err error, message string) error

+ type ApprovalChoice int

+ const ApprovalChoiceAllowFolderSession

+ const ApprovalChoiceApproveAlways

+ const ApprovalChoiceApproveOnce

+ const ApprovalChoiceDeny

+ const ApprovalChoiceElevate

+ type DiffOptimizer struct

+ GeneratedFilePatterns []string

+ LargeFileExtensions []string

+ LockFilePatterns []string

+ MaxDiffLines int

+ MaxFileSize int

+ WorkingDir string

+ func NewDiffOptimizer() *DiffOptimizer

+ func NewDiffOptimizerForReview() *DiffOptimizer

+ func (do *DiffOptimizer) OptimizeDiff(diff string) *OptimizedDiffResult

+ type ErrorCategory int

+ const CategoryConfiguration

+ const CategoryExecution

+ const CategoryFileSystem

+ const CategoryNetwork

+ const CategorySystem

+ const CategoryUser

+ const CategoryValidation

+ type ErrorContext struct

+ Component string

+ Metadata map[string]interface{}

+ Operation string

+ RequestID string

+ Resource string

+ UserID string

+ type ErrorSeverity int

+ const SeverityCritical

+ const SeverityHigh

+ const SeverityLow

+ const SeverityMedium

+ type FileChangeSummary struct

+ AddedLines int

+ ContextLines int

+ DeletedLines int

+ TotalLines int

+ type FilesystemPromptTier int

+ const FilesystemPromptExternal

+ const FilesystemPromptSensitive

+ type Logger struct

+ func GetLogger(skipPrompts bool) *Logger

+ func (w *Logger) AskForApprovalWithOptions(prompt, command string) ApprovalChoice

+ func (w *Logger) AskForConfirmation(prompt string, default_response bool, required bool) bool

+ func (w *Logger) AskForFilesystemApproval(prompt, path, folder string, tier FilesystemPromptTier) ApprovalChoice

+ func (w *Logger) Close() error

+ func (w *Logger) IsInteractive() bool

+ func (w *Logger) Log(message string)

+ func (w *Logger) LogAnalysisResult(filePath, success, summary, err string)

+ func (w *Logger) LogError(err error)

+ func (w *Logger) LogProcessStep(step string)

+ func (w *Logger) LogUserInteraction(message string)

+ func (w *Logger) LogWorkspaceOperation(operation, details string)

+ func (w *Logger) Logf(format string, v ...interface{})

+ type OptimizedDiffResult struct

+ BytesSaved int

+ FileSummaries map[string]string

+ OptimizedContent string

+ OptimizedLines int

+ OriginalLines int

+ Warnings []string

+ type ProviderRateLimiter struct

+ type RateLimitBackoff struct

+ BaseDelay time.Duration

+ BufferTime time.Duration

+ MaxDelay time.Duration

+ MaxRetries int

+ func NewRateLimitBackoff() *RateLimitBackoff

+ func (rlb *RateLimitBackoff) CalculateBackoffDelay(resp *http.Response, attempt int) time.Duration

+ func (rlb *RateLimitBackoff) IsRateLimitError(err error, resp *http.Response) bool

+ func (rlb *RateLimitBackoff) LogRateLimit(provider, model string, totalTokens int, err error, resp *http.Response)

+ func (rlb *RateLimitBackoff) SetOutputFunc(fn func(string))

+ func (rlb *RateLimitBackoff) ShouldRetry(attempt int) bool

+ func (rlb *RateLimitBackoff) WaitWithProgress(duration time.Duration, provider string)

+ type ReviewFileClass struct

+ IsBinary bool

+ IsGenerated bool

+ IsLockFile bool

+ IsVendored bool

+ SkipForReview bool

+ func ClassifyReviewFile(path string) ReviewFileClass

+ type RunLogger struct

+ func GetRunLogger() *RunLogger

+ func (r *RunLogger) Close() error

+ func (r *RunLogger) LogEvent(eventType string, fields map[string]any)

+ type StructuredError struct

+ Category ErrorCategory

+ Code string

+ Context *ErrorContext

+ Message string

+ Recoverable bool

+ RootCause error

+ Severity ErrorSeverity

+ StackTrace string

+ Timestamp int64

+ func NewConfigError(key string, rootCause error) *StructuredError

+ func NewExecutionError(component, operation string, rootCause error) *StructuredError

+ func NewFileSystemError(operation, path string, rootCause error) *StructuredError

+ func NewNetworkError(operation string, rootCause error) *StructuredError

+ func NewStructuredError(code, message string, severity ErrorSeverity, category ErrorCategory, ...) *StructuredError

+ func NewSystemError(operation string, rootCause error) *StructuredError

+ func NewUserError(message string, rootCause error) *StructuredError

+ func NewValidationError(field, reason string) *StructuredError

+ func (e *StructuredError) Error() string

+ func (e *StructuredError) GetCategory() ErrorCategory

+ func (e *StructuredError) GetCode() string

+ func (e *StructuredError) GetContext() *ErrorContext

+ func (e *StructuredError) GetSeverity() ErrorSeverity

+ func (e *StructuredError) GetStackTrace() string

+ func (e *StructuredError) IsRecoverable() bool

+ func (e *StructuredError) MakeUnrecoverable() *StructuredError

+ func (e *StructuredError) Unwrap() error

+ func (e *StructuredError) WithComponent(component string) *StructuredError

+ func (e *StructuredError) WithContext(ctx *ErrorContext) *StructuredError

+ func (e *StructuredError) WithMetadata(key string, value interface{}) *StructuredError

+ func (e *StructuredError) WithOperation(operation string) *StructuredError

+ func (e *StructuredError) WithResource(resource string) *StructuredError

+ type TerminalSize struct

+ Height int

+ Width int

+ func GetTerminalSize() (*TerminalSize, error)

+ type TokenBucket struct

+ func GetProviderRateLimiter(providerName string) *TokenBucket

+ func NewTokenBucket(rate float64, burst int) *TokenBucket

+ func (tb *TokenBucket) GetAvailableTokens() float64

+ func (tb *TokenBucket) GetBurst() int

+ func (tb *TokenBucket) GetRate() float64

+ func (tb *TokenBucket) Refund()

+ func (tb *TokenBucket) TryWait() bool

+ func (tb *TokenBucket) UpdateRate(rate float64, burst int)

+ func (tb *TokenBucket) Wait(ctx context.Context) error

+ type TokenBucketInfo struct

+ AvailableTokens float64

+ Burst int

+ Rate float64