usage

Mar 31, 2026

Changes in this version

+ const EnforcementActionAllow

+ const EnforcementActionBlock

+ const EnforcementActionNone

+ const EnforcementActionPaused

+ const EnforcementSourceApplication

+ const EnforcementSourceCustomRules

+ const EnforcementSourcePaused

+ const EnforcementSourceWhitelist

+ func NewUsageContributor(svc *Service) sandbox.Contributor

+ func WithClassificationContext(classification Classification) sandboxContextOption

type ApplicationUsage

+ ClassificationSandboxContext *string

+ ClassificationSandboxLogs *string

+ ClassificationSandboxResponse *string

+ EnforcementAction EnforcementAction

+ EnforcementError *string

+ EnforcementReason *EnforcementReason

+ EnforcementSandboxContext *string

+ EnforcementSandboxLogs *string

+ EnforcementSandboxResponse *string

+ EnforcementSource *EnforcementSource

+ type EnforcementAction string

+ type EnforcementDecision struct

+ Action EnforcementAction

+ Reason EnforcementReason

+ Source EnforcementSource

+ type EnforcementReason string

+ type EnforcementSource string

type ExecutionLogType

+ const ExecutionLogTypeEnforcementAction

type GetUsageListOptions

+ EnforcementAction *EnforcementAction

type LLMDaySummaryInput

+ MostDistractingHours string

+ TotalDistractingMinutes int

type ProductivityScore

+ DistractingSeconds int

type Service

+ func (s *Service) CalculateEnforcementDecision(ctx context.Context, appUsage *ApplicationUsage) (EnforcementDecision, error)

+ func (s *Service) TestClassifyCustomRules(appName string, url *string, simulatedTimeISO *string) (*ClassificationResponse, error)

Mar 20, 2026

Changes in this version

+ const ClassificationSourceCloudLLMAnthropic

+ const ClassificationSourceCloudLLMGroq

+ const ClassificationSourceCloudLLMOpenAI

+ func NewSandboxContext(opts ...sandboxContextOption) sandboxContext

+ func WithAppNameContext(appName string) sandboxContextOption

+ func WithBrowserURLContext(url string) sandboxContextOption

+ func WithMinutesSinceLastBlockContext(minutesSinceLastBlock int) sandboxContextOption

+ func WithMinutesUsedInPeriodContext(...) sandboxContextOption

+ func WithMinutesUsedSinceLastBlockContext(minutesUsedSinceLastBlock int) sandboxContextOption

+ func WithNowContext(now time.Time) sandboxContextOption

+ func WithWindowTitleContext(title string) sandboxContextOption

+ type AppClassifier func(ctx context.Context, appName, title string, bundleID, appCategory *string) (*ClassificationResponse, error)

type Application

+ func NewIdleApplication() Application

+ func (a Application) NewUsage(windowTitle string, browserURL *string) ApplicationUsage

type ApplicationUsage

+ func (a *ApplicationUsage) String() string

type ApplicationUsageTags

+ func (a *ApplicationUsageTags) TableName() string

type SandboxExecutionLog

+ func (s *SandboxExecutionLog) TableName() string

type Service

+ func (s *Service) GetApplicationList() ([]Application, error)

+ func (s *Service) OnLLMDailySummaryReady(fn func(summary LLMDailySummary))

+ func (s *Service) OnProtectionPause(fn func(pause ProtectionPause))

+ func (s *Service) OnProtectionResumed(fn func(pause ProtectionPause))

+ func (s *Service) OnUsageUpdated(fn func(usage *ApplicationUsage))

Mar 12, 2026

Changes in this version

+ const ClassificationSourceCloudLLMGemini

type Application

+ AppCategory *string

type ApplicationUsage

+ func (a *ApplicationUsage) CommunicationChannel() string

+ func (a *ApplicationUsage) GetDetectedProject() string

+ func (a *ApplicationUsage) HasDetectedProject() bool

+ func (a *ApplicationUsage) IsCommunicationUsage() bool

type Classification

+ func (c Classification) IsProductiveOrDistracting() bool

type CommunicationBreakdown

+ Channel string

+ DurationSeconds int

type ProductivityScore

+ IdleSeconds int

type ProjectBreakdown

+ DurationSeconds int

Mar 8, 2026

Changes in this version

+ type BlockedBreakdown struct

+ Count int

+ Name string

+ type CommunicationBreakdown struct

+ Minutes int

+ Name string

type DayInsights

+ CommunicationBreakdown []CommunicationBreakdown

+ LLMDailySummary *LLMDailySummary

+ ProjectBreakdown []ProjectBreakdown

+ TopBlocked []BlockedBreakdown

+ TopDistractions []DistractionBreakdown

+ type DistractionBreakdown struct

+ Minutes int

+ Name string

+ type LLMAppTimeSummary struct

+ App string

+ Minutes int

+ Visits int

+ type LLMDailySummary struct

+ BlockedAttemptCount int

+ ContextSwitchCount int

+ CreatedAt int64

+ Date string

+ DayVibe string

+ DeepWorkMinutes int

+ Headline string

+ ID int64

+ KeyPattern string

+ LongestFocusMinutes int

+ Narrative string

+ Suggestion string

+ Wins string

+ func (LLMDailySummary) TableName() string

+ type LLMDaySummaryInput struct

+ AvgFocusScoreLast7Days int

+ BlockedAttemptCount int

+ ContextSwitchCount int

+ Date string

+ DeepWorkSessions []LLMDeepWorkSession

+ DeepWorkTotalMinutes int

+ DistractionCascades []LLMDistractionCascade

+ FocusScore int

+ FocusScoreTrend string

+ LongestFocusStretchMin int

+ MostDistractiveHours string

+ MostProductiveHours string

+ ProtectionPauseCount int

+ TopDistractions []LLMAppTimeSummary

+ TopProductiveApps []LLMAppTimeSummary

+ TotalDistractiveMinutes int

+ TotalProductiveMinutes int

+ type LLMDeepWorkSession struct

+ App string

+ End string

+ Minutes int

+ Start string

+ type LLMDistractionCascade struct

+ CascadeApps []string

+ ReturnedToWork string

+ TotalMinutes int

+ TriggerApp string

+ TriggerTime string

type Option

+ func WithLLMDailySummaryReady(fn func(summary LLMDailySummary)) Option

+ type ProjectBreakdown struct

+ Minutes int

+ Name string

type Service

+ func (s *Service) GenerateLLMDailySummaryIfNeeded(ctx context.Context) error

Mar 7, 2026

Changes in this version

+ const ClassificationNone

+ const IdleApplicationName

Mar 6, 2026

Changes in this version

type Application

+ func (a Application) TableName() string

+ type ApplicationTagsSlice []ApplicationUsageTags

+ func (a ApplicationTagsSlice) Tags() []string

type ApplicationUsage

+ ExecutablePath string

type ProtectionWhitelist

+ AppName string

type WhitelistRequest

+ AppName string

Mar 4, 2026

Changes in this version

type GetUsageListOptions

+ ApplicationID *int64

+ ApplicationName *string

+ BundleID *string

+ Classification *Classification

+ Hostname *string

type Service

+ func (s *Service) GetUsageAggregation(options GetUsageListOptions) ([]UsageAggregation, error)

+ type UnwhitelistRequest struct

+ ID int64

+ type UsageAggregation struct

+ Application Application

+ TotalDuration int

+ UsageCount int

+ type WhitelistRequest struct

+ DurationSeconds int

+ ExecutablePath string

+ Hostname string

Feb 26, 2026

Changes in this version

type ApplicationUsage

+ SandboxContext string

+ SandboxLogs string

+ SandboxResponse *string

type ClassificationResponse

+ SandboxContext string

+ SandboxLogs string

+ SandboxResponse *string

+ type ExecutionLogType string

+ const ExecutionLogTypeClassification

+ const ExecutionLogTypeTerminationMode

type SandboxExecutionLog

+ Type string

type Service

+ func (s *Service) GetSandboxExecutionLogs(logType string, search string, page, pageSize int) ([]SandboxExecutionLog, error)

Feb 23, 2026

Changes in this version

+ const ClassificationDistracting

+ const ClassificationError

+ const ClassificationNeutral

+ const ClassificationProductive

+ const ClassificationSourceCloudLLM

+ const ClassificationSourceCustomRules

+ const ClassificationSourceObviously

+ const ClassificationSourceUserSet

+ const ClassificationSystem

+ const TerminationModeAllow

+ const TerminationModeBlock

+ const TerminationModeNone

+ const TerminationModePaused

+ const TerminationModeSourceApplication

+ const TerminationModeSourceCustomRules

+ const TerminationModeSourcePaused

+ const TerminationModeSourceWhitelist

+ func FetchMainContent(ctx context.Context, rawURL string) (string, error)

+ type Application struct

+ BundleID *string

+ Domain *string

+ ExecutablePath string

+ Hostname *string

+ ID int64

+ Icon string

+ Name string

+ type ApplicationUsage struct

+ Application Application

+ ApplicationID int64

+ BrowserURL *string

+ Classification Classification

+ ClassificationConfidence float32

+ ClassificationError *string

+ ClassificationReasoning string

+ ClassificationSource ClassificationSource

+ DetectedCommunicationChannel string

+ DetectedProject string

+ DurationSeconds *int

+ EndedAt *int64

+ ID int64

+ StartedAt int64

+ Tags []ApplicationUsageTags

+ TerminationError string

+ TerminationMode TerminationMode

+ TerminationReasoning string

+ TerminationSource TerminationModeSource

+ WindowTitle string

+ func (a *ApplicationUsage) Same(windowTitle, appName string, bundleID, url *string) bool

+ func (a *ApplicationUsage) TableName() string

+ type ApplicationUsageTags struct

+ ID int64

+ Tag string

+ UsageID int64

+ type Classification string

+ type ClassificationResponse struct

+ Classification Classification

+ ClassificationSource ClassificationSource

+ ConfidenceScore float32

+ DetectedCommunicationChannel string

+ DetectedProject string

+ Reasoning string

+ Tags []string

+ type ClassificationSource string

+ type ClassifyRequest struct

+ AppName string

+ Classification Classification

+ ExecutablePath string

+ Hostname string

+ URL string

+ type DayInsights struct

+ ProductivityPerHourBreakdown ProductivityPerHourBreakdown

+ ProductivityScore ProductivityScore

+ type GetUsageListOptions struct

+ Date *time.Time

+ EndedAt *time.Time

+ Page *int

+ PageSize *int

+ StartedAt *time.Time

+ TerminationMode *TerminationMode

+ type IdlePeriod struct

+ DurationSeconds *int

+ EndedAt *int64

+ ID int64

+ Reason string

+ StartedAt int64

+ func (i *IdlePeriod) TableName() string

+ type MetaData struct

+ Content string

+ Property string

+ type Option func(*Service)

+ func WithAppBlocker(...) Option

+ func WithGenaiClient(genaiClient *genai.Client) Option

+ func WithProtectionPaused(onProtectionPaused func(pause ProtectionPause)) Option

+ func WithProtectionResumed(onProtectionResumed func(pause ProtectionPause)) Option

+ func WithSettingsService(settingsService *settings.Service) Option

+ type PauseRequets struct

+ DurationSeconds int

+ Reason string

+ type ProductivityPerHourBreakdown map[time.Time]ProductivityScore

+ type ProductivityScore struct

+ DistractiveSeconds int

+ OtherSeconds int

+ ProductiveSeconds int

+ ProductivityScore int

+ type ProtectionPause struct

+ ActualDurationSeconds int

+ CreatedAt int64

+ ID int64

+ Reason string

+ RequestedDurationSeconds int

+ ResumedAt int64

+ ResumedReason string

+ func (p *ProtectionPause) TableName() string

+ type ProtectionWhitelist struct

+ ExecutablePath string

+ ExpiresAt int64

+ Hostname string

+ ID int64

+ URL string

+ func (p *ProtectionWhitelist) TableName() string

+ type SandboxExecutionLog struct

+ Context string

+ CreatedAt int64

+ Error *string

+ FinishedAt *int64

+ ID int64

+ Logs string

+ Response *string

+ type Service struct

+ UsageUpdates chan *ApplicationUsage

+ func NewService(ctx context.Context, db *gorm.DB, options ...Option) (*Service, error)

+ func (s *Service) CalculateTerminationMode(ctx context.Context, appUsage *ApplicationUsage) (TerminationDecision, error)

+ func (s *Service) ClassifyCustomRules(ctx context.Context, appName string, executablePath string, url *string) (*ClassificationResponse, error)

+ func (s *Service) ClassifyCustomRulesWithSandbox(ctx context.Context, sandboxCtx sandboxContext) (*ClassificationResponse, error)

+ func (s *Service) ClassifyWithLLM(ctx context.Context, appName, title, executablePath string, url *string) (*ClassificationResponse, error)

+ func (s *Service) GetDayInsights(date time.Time) (DayInsights, error)

+ func (s *Service) GetPauseHistory(days int) ([]ProtectionPause, error)

+ func (s *Service) GetProtectionStatus() (ProtectionPause, error)

+ func (s *Service) GetUsageList(options GetUsageListOptions) ([]ApplicationUsage, error)

+ func (s *Service) GetWhitelist() ([]ProtectionWhitelist, error)

+ func (s *Service) IdleChanged(ctx context.Context, isIdle bool) error

+ func (s *Service) PauseProtection(durationSeconds int, reason string) (ProtectionPause, error)

+ func (s *Service) RegisterHTTPHandlers(r *chi.Mux)

+ func (s *Service) RemoveWhitelist(id int64) error

+ func (s *Service) ResumeProtection(reason string) (ProtectionPause, error)

+ func (s *Service) TitleChanged(ctx context.Context, executablePath, windowTitle, appName, icon string, ...) error

+ func (s *Service) Whitelist(executablePath string, hostname string, duration time.Duration) error

+ type TerminationDecision struct

+ Mode TerminationMode

+ Reasoning string

+ Source TerminationModeSource

+ type TerminationMode string

+ type TerminationModeSource string

+ type UnpauseRequest struct

+ Reason string