usage

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

type Application struct {
	// mandatory fields
	ID   int64  `json:"id" gorm:"primaryKey;autoIncrement;not null"`
	Name string `json:"name" gorm:"uniqueIndex:idx_name_hostname_id;not null"`

	// optional fields
	Icon           *string `json:"icon"` // either app icon or favicon if host is present
	Hostname       *string `json:"hostname" gorm:"uniqueIndex:idx_name_hostname_id"`
	Domain         *string `json:"domain"`
	ExecutablePath string  `json:"executable_path"`

	// darwin only
	BundleID    *string `json:"bundle_id"`
	AppCategory *string `json:"app_category"` // LSApplicationCategoryType, e.g. "public.app-category.developer-tools"
}

type ApplicationTagsSlice []ApplicationUsageTags

type ApplicationUsage struct {
	// mandatory fields
	ID              int64           `json:"id" gorm:"primaryKey;autoIncrement;not null"`
	WindowTitle     string          `json:"window_title" gorm:"not null"`
	StartedAt       int64           `json:"started_at" gorm:"not null"`
	Classification  Classification  `json:"classification" gorm:"index:idx_classification"`
	TerminationMode TerminationMode `json:"termination_mode" gorm:"not null"`

	// optional fields
	BrowserURL      *string `json:"browser_url" gorm:"type:text"`
	EndedAt         *int64  `json:"ended_at"`
	DurationSeconds *int    `json:"duration_seconds"`

	ClassificationError      *string               `gorm:"index:idx_classification_error" json:"classification_error"`
	ClassificationConfidence *float32              `json:"classification_confidence"`
	ClassificationReasoning  *string               `json:"classification_reasoning"`
	ClassificationSource     *ClassificationSource `json:"classification_source"`

	DetectedProject              *string `gorm:"index:idx_detected_project" json:"detected_project"`
	DetectedCommunicationChannel *string `gorm:"index:idx_detected_communication_channel" json:"detected_communication_channel"`

	TerminationReasoning *string                `json:"termination_reasoning"`
	TerminationSource    *TerminationModeSource `json:"termination_mode_source"`
	TerminationError     *string                `gorm:"index:idx_termination_mode_error" json:"termination_mode_error"`

	SandboxContext  *string `json:"sandbox_context" gorm:"type:text;nullable"`
	SandboxResponse *string `json:"sandbox_response" gorm:"type:text;nullable"`
	SandboxLogs     *string `json:"sandbox_logs" gorm:"type:text;nullable"`

	// relations
	Tags          []ApplicationUsageTags `gorm:"foreignKey:UsageID" json:"tags"`
	ApplicationID int64                  `json:"application_id"`
	Application   Application            `gorm:"foreignKey:ApplicationID" json:"application"`
}

type ApplicationUsageTags struct {
	ID      int64  `gorm:"primaryKey;autoIncrement" json:"id"`
	Tag     string `json:"tag"`
	UsageID int64  `json:"usage_id" gorm:"index:idx_usage_id"`
}

type Classification string

type ClassificationResponse struct {
	Classification       Classification       `json:"classification"`
	ClassificationSource ClassificationSource `json:"classification_source"`
	Reasoning            string               `json:"reasoning"`
	ConfidenceScore      float32              `json:"confidence_score"`
	// DetectedProject is inferred by the LLM from the window title or channel name.
	// For coding apps (VS Code, Xcode, etc.), it extracts the workspace/project name from the title format.
	// For communication apps (Slack), it extracts the project/team context if strongly implied by the channel name.
	DetectedProject string `json:"detected_project"`

	// DetectedCommunicationChannel is inferred by the LLM from the window title for communication apps.
	// E.g., for Slack it extracts "engineering" from "Slack | #engineering | Acme Corp".
	// This is only populated when the "communication" tag is assigned.
	DetectedCommunicationChannel string `json:"detected_communication_channel"`

	Tags []string `json:"tags"`

	SandboxContext  string  `json:"sandbox_context"`
	SandboxResponse *string `json:"sandbox_response"`
	SandboxLogs     string  `json:"sandbox_logs"`
}

type ClassificationSource string

type ClassifyRequest struct {
	AppName        string         `json:"app_name"`
	ExecutablePath string         `json:"executable_path"`
	Hostname       string         `json:"hostname"`
	URL            string         `json:"url"`
	Classification Classification `json:"classification"`
}

type CommunicationBreakdown struct {
	Name            string `json:"name"`
	Channel         string `json:"channel"`
	DurationSeconds int    `json:"duration_seconds"`
}

type DayInsights struct {
	ProductivityScore            ProductivityScore                 `json:"productivity_score"`
	ProductivityPerHourBreakdown ProductivityPerHourBreakdown      `json:"productivity_per_hour_breakdown"`
	LLMDailySummary              *LLMDailySummary                  `json:"llm_daily_summary"`
	TopDistractions              map[string]int                    `json:"top_distractions"`
	TopBlocked                   map[string]int                    `json:"top_blocked"`
	ProjectBreakdown             map[string]int                    `json:"project_breakdown"`
	CommunicationBreakdown       map[string]CommunicationBreakdown `json:"communication_breakdown"`
}

type ExecutionLogType string

type GetUsageListOptions struct {
	Date            *time.Time
	Page            *int
	PageSize        *int
	StartedAt       *time.Time
	EndedAt         *time.Time
	TerminationMode *TerminationMode
	Classification  *Classification
	ApplicationID   *int64
	ApplicationName *string
	Hostname        *string
	BundleID        *string
}

type LLMAppTimeSummary struct {
	App     string `json:"app"`
	Minutes int    `json:"minutes"`
	Visits  int    `json:"visits"`
}

type LLMDailySummary struct {
	ID         int64  `json:"id" gorm:"primaryKey;autoIncrement"`
	Date       string `json:"date" gorm:"uniqueIndex;not null"`
	Headline   string `json:"headline"`
	Narrative  string `json:"narrative"`
	KeyPattern string `json:"key_pattern"`
	Wins       string `json:"wins"` // JSON array of strings
	Suggestion string `json:"suggestion"`
	DayVibe    string `json:"day_vibe"`

	ContextSwitchCount  int `json:"context_switch_count"`
	LongestFocusMinutes int `json:"longest_focus_minutes"`
	DeepWorkMinutes     int `json:"deep_work_minutes"`
	BlockedAttemptCount int `json:"blocked_attempt_count"`

	CreatedAt int64 `json:"created_at"`
}

type LLMDaySummaryInput struct {
	Date                    string                  `json:"date"`
	TotalProductiveMinutes  int                     `json:"total_productive_minutes"`
	TotalDistractiveMinutes int                     `json:"total_distractive_minutes"`
	FocusScore              int                     `json:"focus_score"`
	ContextSwitchCount      int                     `json:"context_switch_count"`
	LongestFocusStretchMin  int                     `json:"longest_focus_stretch_min"`
	DeepWorkSessions        []LLMDeepWorkSession    `json:"deep_work_sessions"`
	DeepWorkTotalMinutes    int                     `json:"deep_work_total_minutes"`
	DistractionCascades     []LLMDistractionCascade `json:"distraction_cascades"`
	TopDistractions         []LLMAppTimeSummary     `json:"top_distractions"`
	TopProductiveApps       []LLMAppTimeSummary     `json:"top_productive_apps"`
	MostProductiveHours     string                  `json:"most_productive_hours"`
	MostDistractiveHours    string                  `json:"most_distractive_hours"`
	BlockedAttemptCount     int                     `json:"blocked_attempt_count"`
	ProtectionPauseCount    int                     `json:"protection_pause_count"`
	AvgFocusScoreLast7Days  int                     `json:"avg_focus_score_last_7_days"`
	FocusScoreTrend         string                  `json:"focus_score_trend"`
}

type LLMDeepWorkSession struct {
	Start   string `json:"start"`
	End     string `json:"end"`
	App     string `json:"app"`
	Minutes int    `json:"minutes"`
}

type LLMDistractionCascade struct {
	TriggerTime    string   `json:"trigger_time"`
	TriggerApp     string   `json:"trigger_app"`
	CascadeApps    []string `json:"cascade_apps"`
	TotalMinutes   int      `json:"total_minutes"`
	ReturnedToWork string   `json:"returned_to_work_at"`
}

type MetaData struct {
	Property string
	Content  string
}

type Option func(*Service)

type PauseRequets struct {
	DurationSeconds int    `json:"duration_seconds"`
	Reason          string `json:"reason"`
}

type ProductivityPerHourBreakdown map[int]ProductivityScore

type ProductivityScore struct {
	ProductiveSeconds  int `json:"productive_seconds"`
	DistractiveSeconds int `json:"distractive_seconds"`
	IdleSeconds        int `json:"idle_seconds"`
	OtherSeconds       int `json:"other_seconds"`
	ProductivityScore  int `json:"productivity_score"`
}

type ProjectBreakdown struct {
	Name            string `json:"name"`
	DurationSeconds int    `json:"duration_seconds"`
}

type ProtectionPause struct {
	ID                       int64  `gorm:"primaryKey;autoIncrement" json:"id"`
	RequestedDurationSeconds int    `json:"requested_duration_seconds"`
	ActualDurationSeconds    int    `json:"actual_duration_seconds"`
	ResumedAt                int64  `json:"resumed_at"`
	ResumedReason            string `json:"resumed_reason"`
	CreatedAt                int64  `json:"created_at"`
	Reason                   string `json:"reason"`
}

type ProtectionWhitelist struct {
	ID int64 `gorm:"primaryKey;autoIncrement" json:"id"`
	// ExpiresAt should be pre-calculated and set to the time when the whitelist expires
	ExpiresAt int64 `json:"expires_at"`

	AppName  string  `gorm:"uniqueIndex:idx_allow_usage_identity" json:"appname"`
	Hostname *string `gorm:"uniqueIndex:idx_allow_usage_identity" json:"hostname"`
}

type SandboxExecutionLog struct {
	ID         int64   `gorm:"primaryKey;autoIncrement" json:"id"`
	Context    string  `json:"context" gorm:"type:text;nullable"`
	Response   *string `json:"response" gorm:"type:text;nullable"`
	Logs       string  `json:"logs" gorm:"type:text;nullable"`
	CreatedAt  int64   `json:"created_at" gorm:"index:idx_created_at"`
	FinishedAt *int64  `json:"finished_at" gorm:"index:idx_finished_at;nullable"`
	Error      *string `json:"error" gorm:"type:text;nullable"`
	Type       string  `json:"type" gorm:"index:idx_type"`
}

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

type TerminationDecision struct {
	Mode      TerminationMode
	Reasoning string
	Source    TerminationModeSource
}

type TerminationMode string

type TerminationModeSource string

type UnpauseRequest struct {
	Reason string `json:"reason"`
}

type UnwhitelistRequest struct {
	ID int64 `json:"id"`
}

type UsageAggregation struct {
	Application   Application `json:"application"`
	TotalDuration int         `json:"total_duration"` // in seconds
	UsageCount    int         `json:"usage_count"`
}

type WhitelistRequest struct {
	AppName         string `json:"app_name"`
	Hostname        string `json:"hostname"`
	DurationSeconds int    `json:"duration_seconds"`
}