telemetry

type ActivationState struct {
	FirstConnectedServerEver      bool     `json:"first_connected_server_ever"`
	FirstMCPClientEver            bool     `json:"first_mcp_client_ever"`
	FirstRetrieveToolsCallEver    bool     `json:"first_retrieve_tools_call_ever"`
	MCPClientsSeenEver            []string `json:"mcp_clients_seen_ever"`
	RetrieveToolsCalls24h         int      `json:"retrieve_tools_calls_24h"`
	EstimatedTokensSaved24hBucket string   `json:"estimated_tokens_saved_24h_bucket"`
	ConfiguredIDECount            int      `json:"configured_ide_count"`
}

type ActivationStore interface {
	// Load reads the full activation state. Missing bucket or keys yield
	// zero values.
	Load(db *bbolt.DB) (ActivationState, error)

	// Save writes the full activation state, enforcing monotonic flags
	// (true cannot revert to false).
	Save(db *bbolt.DB, st ActivationState) error

	// MarkFirstConnectedServer sets first_connected_server_ever=true if not
	// already set. No-op if already true.
	MarkFirstConnectedServer(db *bbolt.DB) error

	// MarkFirstMCPClient sets first_mcp_client_ever=true if not already set.
	MarkFirstMCPClient(db *bbolt.DB) error

	// MarkFirstRetrieveToolsCall sets first_retrieve_tools_call_ever=true
	// if not already set.
	MarkFirstRetrieveToolsCall(db *bbolt.DB) error

	// RecordMCPClient adds sanitized client name to the seen list. Dedups
	// on insert; drops when cap (16) is reached.
	RecordMCPClient(db *bbolt.DB, name string) error

	// IncrementRetrieveToolsCall bumps the 24h window counter by 1,
	// rolling the window if it has expired.
	IncrementRetrieveToolsCall(db *bbolt.DB) error

	// AddTokensSaved adds n to the 24h token-savings estimator counter.
	AddTokensSaved(db *bbolt.DB, n int) error

	// SetInstallerPending writes the installer_heartbeat_pending flag.
	SetInstallerPending(db *bbolt.DB, v bool) error

	// IsInstallerPending reports whether installer_heartbeat_pending is
	// currently set.
	IsInstallerPending(db *bbolt.DB) (bool, error)
}

type AnonymityViolation struct {
	// Rule is a short stable identifier ("blocked_prefix", "blocked_value",
	// "env_markers_non_bool") suitable for metrics labels.
	Rule string
	// Pattern is the literal substring or env-var name that matched.
	Pattern string
	// Reason is a human-readable summary (no payload contents).
	Reason string
}

type AutostartReader struct {
	// Path is the filesystem location of the tray-written sidecar. Tests
	// override this; production uses DefaultAutostartReader.
	Path string
	// contains filtered or unexported fields
}

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

type DoctorCheckResult interface {
	GetName() string
	IsPass() bool
}

type DoctorCounts struct {
	Pass int64 `json:"pass"`
	Fail int64 `json:"fail"`
}

type EnvDisabledReason string

type EnvKind string

type EnvMarkers struct {
	// HasCIEnv is true when any known CI env var is set (e.g., CI=true,
	// GITHUB_ACTIONS, GITLAB_CI, JENKINS_URL, CIRCLECI).
	HasCIEnv bool `json:"has_ci_env"`

	// HasCloudIDEEnv is true when a cloud-IDE env var is set (e.g.,
	// CODESPACES, GITPOD_WORKSPACE_ID, REPL_ID, STACKBLITZ_WORKER,
	// DAYTONA_WORKSPACE_ID, CODER_AGENT_TOKEN).
	HasCloudIDEEnv bool `json:"has_cloud_ide_env"`

	// IsContainer is true when /.dockerenv or /run/.containerenv exists, or
	// the $container env var is set.
	IsContainer bool `json:"is_container"`

	// HasTTY is true when stdin is attached to a terminal.
	HasTTY bool `json:"has_tty"`

	// HasDisplay is true when DISPLAY or WAYLAND_DISPLAY env var is set
	// (Linux desktop session indicator).
	HasDisplay bool `json:"has_display"`
}

type ErrorCategory string

type FeatureFlagSnapshot struct {
	EnableSocket                  bool     `json:"enable_socket"`
	EnableWebUI                   bool     `json:"enable_web_ui"`
	EnablePrompts                 bool     `json:"enable_prompts"`
	RequireMCPAuth                bool     `json:"require_mcp_auth"`
	EnableCodeExecution           bool     `json:"enable_code_execution"`
	QuarantineEnabled             bool     `json:"quarantine_enabled"`
	SensitiveDataDetectionEnabled bool     `json:"sensitive_data_detection_enabled"`
	OAuthProviderTypes            []string `json:"oauth_provider_types"`

	// Schema v3: DockerAvailable reports whether the host has a reachable
	// Docker daemon, as observed by the runtime's checkDockerDaemon probe.
	// Populated by the telemetry service at heartbeat time (not by
	// BuildFeatureFlagSnapshot) so the snapshot helper stays side-effect-free
	// and doesn't shell out to `docker info`.
	DockerAvailable bool `json:"docker_available"`
}

type FeedbackContext struct {
	Version              string `json:"version"`
	Edition              string `json:"edition"`
	OS                   string `json:"os"`
	Arch                 string `json:"arch"`
	ServerCount          int    `json:"server_count"`
	ConnectedServerCount int    `json:"connected_server_count"`
	RoutingMode          string `json:"routing_mode"`
}

type FeedbackRequest struct {
	Category string          `json:"category"` // bug, feature, other
	Message  string          `json:"message"`
	Email    string          `json:"email,omitempty"`
	Context  FeedbackContext `json:"context"`
}

type FeedbackResponse struct {
	Success  bool   `json:"success"`
	IssueURL string `json:"issue_url,omitempty"`
	Error    string `json:"error,omitempty"`
}

type FileProber interface {
	// Exists returns true if the file at path exists (any type: file, dir,
	// symlink). Errors other than "not exists" are treated as "exists" to
	// avoid mis-classifying a container due to permission issues.
	Exists(path string) bool
}

type HandshakeChecker interface {
	LaunchedViaTray() bool
}

type HeartbeatPayload struct {
	// v1 fields (preserved unchanged)
	AnonymousID          string `json:"anonymous_id"`
	Version              string `json:"version"`
	Edition              string `json:"edition"`
	OS                   string `json:"os"`
	Arch                 string `json:"arch"`
	GoVersion            string `json:"go_version"`
	ServerCount          int    `json:"server_count"`
	ConnectedServerCount int    `json:"connected_server_count"`
	ToolCount            int    `json:"tool_count"`
	UptimeHours          int    `json:"uptime_hours"`
	RoutingMode          string `json:"routing_mode"`
	QuarantineEnabled    bool   `json:"quarantine_enabled"`
	Timestamp            string `json:"timestamp"`

	// Spec 042 (Tier 2) additions
	SchemaVersion               int                         `json:"schema_version,omitempty"`
	AnonymousIDCreatedAt        string                      `json:"anonymous_id_created_at,omitempty"`
	CurrentVersion              string                      `json:"current_version,omitempty"`
	PreviousVersion             string                      `json:"previous_version"`
	LastStartupOutcome          string                      `json:"last_startup_outcome,omitempty"`
	SurfaceRequests             map[string]int64            `json:"surface_requests,omitempty"`
	BuiltinToolCalls            map[string]int64            `json:"builtin_tool_calls,omitempty"`
	UpstreamToolCallCountBucket string                      `json:"upstream_tool_call_count_bucket,omitempty"`
	RESTEndpointCalls           map[string]map[string]int64 `json:"rest_endpoint_calls,omitempty"`
	FeatureFlags                *FeatureFlagSnapshot        `json:"feature_flags,omitempty"`
	ErrorCategoryCounts         map[string]int64            `json:"error_category_counts,omitempty"`
	DoctorChecks                map[string]DoctorCounts     `json:"doctor_checks,omitempty"`

	// Schema v3 additions.
	// ServerProtocolCounts is a fixed-enum histogram over cfg.Servers by
	// Protocol. Keys are exactly: stdio, http, sse, streamable_http, auto.
	// Never contains server names, URLs, or unknown values (unknown/empty
	// protocols bucket into "auto").
	ServerProtocolCounts map[string]int `json:"server_protocol_counts,omitempty"`
	// ServerDockerIsolatedCount is the number of configured servers the
	// runtime actually wraps in Docker isolation. Distinct from "has Docker
	// available" — an install can have Docker but never use it for isolation.
	ServerDockerIsolatedCount int `json:"server_docker_isolated_count,omitempty"`

	// Spec 044 additions. schema_version stays at 3 (set by spec 042); these
	// fields are additive and forward-compatible.
	//
	// EnvKind: ground-truth classification of the process environment, computed
	// once at startup by DetectEnvKindOnce. One of the EnvKind* constants.
	EnvKind string `json:"env_kind,omitempty"`
	// EnvMarkers: raw boolean observations feeding EnvKind. Fields are ALL
	// booleans — the anonymity scanner re-asserts this on the serialized form.
	EnvMarkers *EnvMarkers `json:"env_markers,omitempty"`

	// Activation is the retention funnel snapshot: monotonic first-ever flags,
	// 24h sliding counters, and bucketed token-savings estimate. Loaded from
	// the BBolt activation bucket at heartbeat build time. nil when the store
	// is not wired (e.g. in short-lived CLI commands).
	Activation *ActivationState `json:"activation,omitempty"`

	// LaunchSource: how the process was launched. One of "installer", "tray",
	// "login_item", "cli", "unknown". Detected once at startup via
	// DetectLaunchSourceOnce, with a one-shot "installer" override driven by
	// the installer_heartbeat_pending BBolt flag (cleared after first heartbeat).
	LaunchSource string `json:"launch_source,omitempty"`

	// AutostartEnabled: tri-state login-item status.
	//   - *true  : tray reports the app IS registered as a login item
	//   - *false : tray reports the app is NOT registered
	//   - nil    : unknown (tray not running, Linux, or sidecar absent)
	// Pointer intentional so JSON null is distinguishable from false —
	// receivers need this to separate "user disabled" from "we don't know".
	AutostartEnabled *bool `json:"autostart_enabled"`
}

type LaunchSource string

type PPIDChecker interface {
	IsLoginItemParent() bool
}

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

type RegistrySnapshot struct {
	SurfaceCounts               map[string]int64            `json:"surface_requests"`
	BuiltinToolCalls            map[string]int64            `json:"builtin_tool_calls"`
	UpstreamToolCallCountBucket string                      `json:"upstream_tool_call_count_bucket"`
	RESTEndpointCalls           map[string]map[string]int64 `json:"rest_endpoint_calls"`
	ErrorCategoryCounts         map[string]int64            `json:"error_category_counts"`
	DoctorChecks                map[string]DoctorCounts     `json:"doctor_checks"`
}

type RuntimeStats interface {
	GetServerCount() int
	GetConnectedServerCount() int
	GetToolCount() int
	GetRoutingMode() string
	IsQuarantineEnabled() bool
	// Schema v3 additions.
	// IsDockerAvailable reports whether the host has a reachable Docker
	// daemon. Implementations should memoize the probe result (running
	// `docker info` on every heartbeat has cost) and return the cached value.
	IsDockerAvailable() bool
	// GetDockerIsolatedServerCount returns how many currently-configured
	// servers the runtime is actually wrapping in a Docker container.
	GetDockerIsolatedServerCount() int
}

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

type Surface int

type TTYChecker interface {
	IsTerminal() bool
}