:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
// Analytics event types and properties
import type { Adapter, ModelAccess } from "@posthog/agent-contracts/adapter";
import type { EffortLevel } from "@posthog/agent-contracts/domain-types";
import type { SourceProduct } from "@posthog/agent-contracts/inbox-types";
export interface PromptHistoryOpenedProperties {
entry_count: number;
}
export interface PromptHistorySelectedProperties {
entry_count: number;
entry_age_seconds: number | null;
had_pending_draft: boolean;
had_search_query: boolean;
prompt_length: number;
}
type ExecutionType = "cloud" | "local";
export type RepositoryProvider = "github" | "gitlab" | "local" | "none";
export type SpaceContextMode =
| "none"
| "legacy_inline"
| "context_wiki_reference";
type TaskCreatedFrom = "cli" | "command-menu" | "sidebar-worktree";
type RepositorySelectSource = "task-creation" | "task-detail";
type GitActionType =
| "push"
| "pull"
| "sync"
| "publish"
| "commit"
| "commit-push"
| "create-pr"
| "view-pr"
| "update-pr"
| "branch-here";
export type FeedbackType = "good" | "bad" | "general";
type FileOpenSource = "sidebar" | "agent-suggestion" | "search" | "diff";
export type FileChangeType = "added" | "modified" | "deleted";
type StopReason = "user_cancelled" | "completed" | "error" | "timeout";
export type SkillButtonId =
| "add-analytics"
| "create-feature-flags"
| "run-experiment"
| "add-error-tracking"
| "instrument-llm-calls"
| "add-logging";
export type CommandMenuAction =
| "home"
| "new-task"
| "create-channel"
| "settings"
| "logout"
| "toggle-theme"
| "toggle-left-sidebar"
| "toggle-notifications-pause"
| "open-review-panel"
| "archive-task"
| "go-back"
| "go-forward"
| "open-task"
| "open-task-from-pull-request"
| "open-artifact"
| "open-canvas"
| "open-channel"
| "open-command-center"
| "save-feed"
| "complete-filter"
| "show-all-matches"
| "repair-query"
| "open-feed"
| "open-inbox"
| "open-archived"
| "open-loops"
| "open-usage"
| "open-cost-management"
| "send-feedback"
| "search-files"
| "open-file"
| "reload-window"
| "show-log-folder"
| "zoom-in"
| "zoom-out"
| "zoom-reset";
// Event property interfaces
export interface TaskListViewProperties {
filter_type?: string;
sort_field?: string;
view_mode?: string;
}
export interface TaskCreateProperties {
task_id: string;
auto_run: boolean;
created_from: TaskCreatedFrom;
repository_provider?: RepositoryProvider;
workspace_mode?: "local" | "worktree" | "cloud";
has_branch?: boolean;
/** Worktree mode: a project environment with a setup script was selected */
has_environment_setup?: boolean;
/** Cloud mode: a sandbox environment was selected */
has_sandbox_environment?: boolean;
cloud_run_source?: "manual" | "signal_report";
cloud_pr_authorship_mode?: "user" | "bot";
signal_report_id?: string;
/** Worktree mode: repo has a non-empty .worktreelink file */
uses_worktree_link?: boolean;
/** Worktree mode: repo has a non-empty .worktreeinclude file */
uses_worktree_include?: boolean;
adapter?: Adapter;
codex_model_access?: ModelAccess;
claude_model_access?: ModelAccess;
/** Space that owns the task, when it was created from a Space. */
channel_id?: string;
/** How shared Space context was delivered to the task. */
space_context_mode: SpaceContextMode;
}
export interface TaskViewProperties {
task_id: string;
}
export interface TaskRunProperties {
task_id: string;
execution_type: ExecutionType;
}
export interface RepositorySelectProperties {
repository_provider: RepositoryProvider;
source: RepositorySelectSource;
}
export interface UserIdentifyProperties {
email?: string;
uuid?: string;
project_id?: string;
region?: string;
}
export interface TaskRunStartedProperties {
task_id: string;
execution_type: ExecutionType;
model?: string;
initial_mode?: string;
adapter?: string;
gateway_mode?: "legacy" | "go";
}
export interface TaskRunCompletedProperties {
task_id: string;
execution_type: ExecutionType;
duration_seconds: number;
prompts_sent: number;
stop_reason: StopReason;
}
export interface TaskRunCancelledProperties {
task_id: string;
execution_type: ExecutionType;
duration_seconds: number;
prompts_sent: number;
}
export interface TaskRunStoppedProperties {
task_id: string;
execution_type: ExecutionType;
duration_seconds?: number;
prompts_sent?: number;
}
export interface PromptSentProperties {
task_id: string;
is_initial: boolean;
execution_type: ExecutionType;
prompt_length_chars: number;
}
/** Sentiment captured by the thumbs under an agent turn. */
export type AgentTurnFeedbackSentiment = "positive" | "negative";
/**
* A reader's verdict on one agent turn, from the thumbs in the turn footer.
* Feedback is analytics-only: it never changes the session. `turn_id` is
* stable for the life of the thread, so switching thumbs re-fires the event
* and the last one wins.
*/
export interface AgentTurnFeedbackProperties {
task_id: string | null;
turn_id: string;
sentiment: AgentTurnFeedbackSentiment;
}
// Git operations
export interface GitActionExecutedProperties {
action_type: GitActionType;
success: boolean;
task_id?: string;
/** Number of staged files at time of action */
staged_file_count?: number;
/** Number of unstaged files at time of action */
unstaged_file_count?: number;
/** Whether user chose to commit all changes (vs staged only) */
commit_all?: boolean;
/** Whether stagedOnly mode was used for the commit */
staged_only?: boolean;
}
export interface PrCreatedProperties {
task_id?: string;
success: boolean;
}
export interface AgentFileActivityProperties {
task_id: string;
branch_name: string | null;
}
// Branch link events. "auto" marks self-healing unlinks of branches that no
// longer exist anywhere (e.g. deleted after a PR merge).
type BranchLinkSource = "agent" | "user" | "auto" | "unknown";
export interface BranchLinkedProperties {
task_id: string;
branch_name: string;
source: BranchLinkSource;
}
export interface BranchUnlinkedProperties {
task_id: string;
source: BranchLinkSource;
}
export interface BranchLinkDefaultBranchUnknownProperties {
task_id: string;
branch_name: string;
}
// File interactions
export interface FileOpenedProperties {
file_extension: string;
source: FileOpenSource;
task_id?: string;
}
export interface FileDiffViewedProperties {
file_extension: string;
change_type: FileChangeType;
task_id?: string;
}
export interface ReviewPanelViewedProperties {
task_id: string;
}
export interface DiffViewModeChangedProperties {
from_mode: "split" | "unified";
to_mode: "split" | "unified";
}
export interface ReviewFileBrowserToggledProperties {
task_id: string;
collapsed: boolean;
}
// Workspace events
export interface WorkspaceCreatedProperties {
task_id: string;
mode: "cloud" | "worktree" | "local";
}
export interface WorkspaceScriptsStartedProperties {
task_id: string;
scripts_count: number;
}
export interface FolderRegisteredProperties {
path_hash: string;
}
// Navigation events
export interface CommandMenuActionProperties {
action_type: CommandMenuAction;
/** Channel acted on for the bluebird `open-channel` / `open-task` actions. */
channel_id?: string;
}
export type SidebarNavItem =
| "home"
| "spaces"
| "new_task"
| "search"
| "inbox"
| "agents"
| "skills"
| "mcp_servers"
| "command_center"
| "contexts"
| "activity"
| "canvases"
| "configure"
| "loops"
| "more";
export interface CommentSentToAgentProperties {
surface: "artifact" | "canvas" | "task";
with_context: boolean;
with_screenshot: boolean;
}
/** Which sidebar shell the click came from, so the two can be compared. */
export type SidebarLayout = "code" | "channels";
export interface SidebarNavItemClickedProperties {
item: SidebarNavItem;
/** True when the row was clicked inside the expanded More section. */
in_more: boolean;
/**
* Which shell rendered the row. Both shells fire this event with the same
* item names, so without it the layouts are indistinguishable — and comparing
* them is the whole point of running one behind a flag.
*/
layout?: SidebarLayout;
/** How a rail destination was picked. Only the channels rail sends it. */
source?: "click" | "shortcut";
}
/** Every row of the account / project / org menu, plus opening it. */
export type ProjectMenuAction =
| "open"
| "switch_project"
| "switch_organization"
| "create_project"
| "create_organization"
| "discord"
| "changelog"
| "website"
| "privacy_policy"
| "keyboard_shortcuts"
| "archived"
| "settings"
| "log_out";
export interface ProjectMenuActionProperties {
action: ProjectMenuAction;
/** The rail draws the trigger as an icon, the code sidebar as a footer row. */
appearance: "row" | "icon";
/** For switch_project / switch_organization: whether the pick moved anywhere. */
changed?: boolean;
}
export interface DesktopAccessScreenShownProperties {
status: "blocked" | "error";
/** Null on a block means new sign-ups are paused. */
reason: "startup_plan" | "prepaid_credits" | null;
}
export interface DesktopAccessLinkOpenedProperties {
link: "games";
}
export type TaskListSurface = "sidebar" | "space" | "saved_search";
export interface TaskListGroupingChangedProperties {
group_by: "repository" | "date" | "space";
sort_by: "updated" | "created" | "alpha";
surface: TaskListSurface;
}
export interface BrowserTabTiledProperties {
edge: "left" | "right" | "top" | "bottom";
source: "strip" | "tile" | "sidebar";
tile_count: number;
}
export interface BrowserTabTileCountProperties {
tile_count: number;
}
export interface TaskListAppearanceChangedProperties {
secondary_fields: (
| "space"
| "repository"
| "branch"
| "creator"
| "activity"
)[];
secondary_field_count: number;
surface: TaskListSurface;
}
export interface BrainrotActivatedProperties {
/** Grid layout preset, e.g. "2x2". */
layout: string;
/** Cells already holding a task when Brainrot was chosen. */
filled_cells: number;
}
export interface BrainrotPlayerErrorProperties {
/** YouTube player error code (e.g. 153), or null when the widget went silent. */
error_code: number | null;
/**
* "player_error" when the embed reported an onError message;
* "no_widget_messages" when the widget sent nothing after loading, which
* usually means the player failed before the postMessage API came up.
*/
reason: "player_error" | "no_widget_messages";
}
// Settings events
export interface SettingChangedProperties {
setting_name: string;
new_value: string | boolean | number;
old_value?: string | boolean | number;
}
type SettingsBackupScope = "all" | "sounds";
export interface SettingsBackupExportProperties {
scope: SettingsBackupScope;
sound_count: number;
}
export interface SettingsBackupExportFailedProperties
extends SettingsBackupExportProperties {
error: string;
}
export interface SettingsBackupImportedProperties {
scope: SettingsBackupScope;
setting_count: number;
sound_count: number;
added_sound_count: number;
warning_count: number;
backup_app_version: string;
version_matches: boolean;
}
export interface SettingsBackupImportFailedProperties {
scope: SettingsBackupScope;
/** "open" = reading and validating the file; "apply" = writing the settings. */
stage: "open" | "apply";
error: string;
}
export interface CloudCredentialRelayProperties {
credential: "claude_subscription_token";
outcome: "sent" | "no_token" | "expired" | "rejected";
}
export interface CustomSoundAddedProperties {
// How the clip was captured.
source: "recording" | "import";
// Whether the user applied the offered leading/trailing-silence trim.
trimmed: boolean;
// Length of the saved clip in ms (no clip contents or name — no PII).
duration_ms: number;
}
// Error events
export interface TaskCreationFailedProperties {
error_type: string;
failed_step?: string;
}
export interface AgentSessionErrorProperties {
task_id: string;
error_type: string;
failure_reason?: "startup_timeout" | "startup_failed" | "other";
startup_step?: string;
}
export interface CloudStreamDisconnectedProperties {
task_id: string;
run_id: string;
team_id: number;
error_title: string;
retryable: boolean;
reconnect_attempts: number;
stream_error_attempts: number;
cumulative_reconnect_attempts: number;
was_bootstrapping: boolean;
}
export interface CloudStreamIdleTimeoutProperties {
task_id: string;
run_id: string;
team_id: number;
idle_timeout_ms: number;
bytes_received: number;
events_received: number;
}
// Permission events
export interface PermissionRespondedProperties {
task_id: string;
tool_name?: string;
option_id?: string;
option_kind?: string;
custom_input?: string;
}
export interface PermissionCancelledProperties {
task_id: string;
tool_name?: string;
}
// Session config events
export interface SessionConfigChangedProperties {
task_id: string;
category: string;
from_value: string;
to_value: string;
}
export interface ModelSwitchWarningShownProperties {
task_id?: string;
from_model: string;
to_model: string;
context_tokens?: number;
}
export interface ModelSwitchWarningActionProperties
extends ModelSwitchWarningShownProperties {
action: "cancel" | "switch_now";
result?: "failed" | "succeeded";
}
export interface SessionSummaryRequestedProperties {
task_id: string;
source: "retry" | "task_menu";
}
export interface SessionSummaryActionProperties {
task_id: string;
action: "copied" | "dismissed" | "stopped_waiting";
/** How long the summary had been running when the action happened. */
wait_ms: number;
}
// Tour events
type TourAction = "started" | "step_advanced" | "dismissed" | "completed";
export interface TourEventProperties {
tour_id: string;
action: TourAction;
step_id?: string;
step_index?: number;
total_steps?: number;
}
// Branch mismatch events
type BranchMismatchAction = "switch" | "continue" | "cancel";
export interface BranchMismatchWarningShownProperties {
task_id: string;
linked_branch: string;
current_branch: string;
has_uncommitted_changes: boolean;
}
export interface BranchMismatchActionProperties {
task_id: string;
action: BranchMismatchAction;
linked_branch: string;
current_branch: string;
}
// Deep link events
export interface DeepLinkNewTaskProperties {
has_prompt: boolean;
has_repo: boolean;
mode?: string;
model?: string;
}
export interface DeepLinkPlanProperties {
has_repo: boolean;
mode?: string;
model?: string;
plan_length_chars: number;
}
export interface DeepLinkIssueProperties {
owner: string;
repo: string;
issue_number: number;
mode?: string;
model?: string;
}
export interface DeepLinkIssueFailedProperties {
owner: string;
repo: string;
issue_number: number;
reason: "not_found" | "fetch_failed";
error_message?: string;
}
export interface DeepLinkCanvasProperties {
channel_id: string;
dashboard_id: string;
}
export interface DeepLinkChannelProperties {
channel_id: string;
/** Present when the link targets a thread inside the channel. */
task_id?: string;
}
// PostHog's reserved LLM analytics feedback events, same shape as the PostHog AI
// web client (products/posthog_ai/frontend/utils/feedbackEvents.ts).
// `$ai_session_id` is the task id because every `$ai_generation` of a run
// carries it as `task_id`; `$ai_trace_id` is null until the sandbox exposes
// per-turn trace ids.
export type AiFeedbackProduct = "posthog_code";
export type AiQualityRating = "good" | "bad";
export interface AiFeedbackContextProperties {
$ai_session_id: string | null;
$ai_trace_id: string | null;
ai_product: AiFeedbackProduct;
task_id: string | null;
task_run_id?: string;
turn_id?: string;
feedback_type?: FeedbackType;
event_count?: number;
}
export interface AiMetricProperties extends AiFeedbackContextProperties {
$ai_metric_name: "quality";
$ai_metric_value: AiQualityRating;
}
export interface AiFeedbackProperties extends AiFeedbackContextProperties {
$ai_feedback_text: string;
}
// Onboarding events
export type OnboardingStepId =
| "project-select"
| "consent"
| "connect-github"
| "install-cli";
type OnboardingSkipReason = "dev_skip";
export interface OnboardingStepViewedProperties {
step_id: OnboardingStepId;
step_index: number;
total_steps: number;
}
export interface OnboardingStepCompletedProperties {
step_id: OnboardingStepId;
step_index: number;
total_steps: number;
duration_seconds: number;
github_connected?: boolean;
git_installed?: boolean;
gh_installed?: boolean;
gh_authenticated?: boolean;
}
export interface OnboardingStepSkippedProperties {
step_id: OnboardingStepId;
step_index: number;
reason: OnboardingSkipReason;
}
export interface OnboardingSignInInitiatedProperties {
region: string;
}
export interface OnboardingProjectSelectedProperties {
had_multiple_orgs: boolean;
had_multiple_projects: boolean;
}
export interface OnboardingCliCheckCompletedProperties {
git_installed: boolean;
gh_installed: boolean;
gh_authenticated: boolean;
}
export interface OnboardingCliRunCompletedProperties {
command: "install_git" | "install_gh" | "auth_gh";
exit_code: number;
}
export interface OnboardingCompletedProperties {
duration_seconds: number;
github_connected: boolean;
}
export type OnboardingGithubConnectFlow =
| "team_existing"
| "team_alternative"
| "user_new";
export interface OnboardingGithubConnectStartedProperties {
flow_type: OnboardingGithubConnectFlow;
is_retry: boolean;
}
export interface OnboardingGithubConnectFailedProperties {
reason: "timeout" | "error";
error_type?: string;
}
export interface OnboardingGithubConnectPendingAdminProperties {
flow_type: OnboardingGithubConnectFlow;
}
export interface OnboardingGithubConnectAbandonedProperties {
flow_type: OnboardingGithubConnectFlow;
seconds_since_started: number;
}
export interface OnboardingAbandonedProperties {
last_step_id: OnboardingStepId;
duration_seconds: number;
}
export interface AiConsentGateShownProperties {
is_org_admin: boolean;
outstanding_ai_consent: boolean;
outstanding_beta_terms: boolean;
surface: "onboarding_step" | "standalone_gate";
}
export interface ConsentAdminLinkCopiedProperties {
consent_type: "ai" | "desktop_beta_terms";
success: boolean;
}
// Setup / onboarding events
type SetupDiscoveredTaskCategory =
| "bug"
| "security"
| "dead_code"
| "duplication"
| "performance"
| "stale_feature_flag"
| "error_tracking"
| "event_tracking"
| "funnel"
| "posthog_setup"
| "experiment";
export interface SetupDiscoveryStartedProperties {
discovery_task_id: string;
discovery_task_run_id: string;
}
export interface SetupDiscoveryCompletedProperties {
discovery_task_id: string;
discovery_task_run_id: string;
task_count: number;
duration_seconds: number;
signal_source: "structured_output" | "terminal_status" | "missing_output";
}
export interface SetupDiscoveryFailedProperties {
discovery_task_id?: string;
discovery_task_run_id?: string;
reason: "failed" | "cancelled" | "timeout" | "startup_error";
error_message?: string;
}
export interface SetupTaskSelectedProperties {
discovered_task_id: string;
category: SetupDiscoveredTaskCategory;
position: number;
total_discovered: number;
}
export interface SetupTaskDismissedProperties {
discovered_task_id: string;
category: SetupDiscoveredTaskCategory;
position: number;
total_discovered: number;
}
// Inbox events
type InboxReportOpenMethod =
| "click"
| "click_cmd"
| "click_shift"
| "keyboard"
| "deeplink"
| "unknown";
export type InboxReportCloseMethod =
| "next_report"
| "deselected"
| "navigated_away"
| "unmount";
export type InboxReportActionType =
| "dismiss"
| "resolve"
| "restore"
| "snooze"
| "delete"
| "reingest"
| "implement"
| "create_pr"
| "refund"
| "open_pr"
| "open_task"
| "copy_link"
| "discuss"
| "expand_signal"
| "collapse_signal"
| "expand_signal_section"
| "view_signal_external"
| "expand_why"
| "click_suggested_reviewer"
| "add_suggested_reviewer"
| "remove_suggested_reviewer"
| "expand_task_section"
| "play_session_recording"
| "create_canvas";
export type InboxReportActionSurface =
| "detail_pane"
| "detail_footer"
| "toolbar"
| "keyboard"
| "list_row"
| "context_menu"
| "triage";
export type InboxReportActionOutcome = "succeeded" | "failed";
export type InboxReportActionFailureCode =
| "offline"
| "missing_repository"
| "missing_integration"
| "signed_out"
| "missing_model"
| "usage_limit"
| "existing_task"
| "request_failed"
| "task_creation_failed"
| "unexpected_error";
export type InboxReviewerScope = "for-you" | "entire-project" | "teammate";
export interface InboxTriageStartedProperties {
/** Correlates one Desktop triage run across its start, actions, and end. */
triage_id?: string;
queue_size: number;
scope: InboxReviewerScope;
has_active_filters: boolean;
}
export interface InboxTriageEndedProperties
extends InboxTriageStartedProperties {
reports_reviewed: number;
duration_ms: number;
end_reason: "completed" | "exited";
}
/** Sentiment captured by the report usefulness thumbs. */
export type InboxReportFeedbackSentiment = "positive" | "negative";
export interface InboxViewedProperties {
report_count: number;
total_count: number;
ready_count: number;
has_active_filters: boolean;
source_product_filter: string[];
status_filter_count: number;
is_empty: boolean;
/** Breakdown of the visible report_count by priority (P0–P4, or "unknown"). */
priority_p0_count: number;
priority_p1_count: number;
priority_p2_count: number;
priority_p3_count: number;
priority_p4_count: number;
priority_unknown_count: number;
/** Breakdown of the visible report_count by actionability. */
actionability_immediately_actionable_count: number;
actionability_requires_human_input_count: number;
actionability_not_actionable_count: number;
actionability_unknown_count: number;
/**
* Tab badge counts shown in the inbox header on load — the actual numbers
* the user sees (Pull requests / Reports), sent whatever tab is open. Distinct
* from `report_count`, which is only the loaded rows of the active tab.
* Optional: the mobile event omits them.
*/
pulls_tab_count?: number;
reports_tab_count?: number;
/** Reviewer scope on Desktop. Mobile omits this until it exposes the same control. */
scope?: InboxReviewerScope;
}
export interface InboxReportOpenedProperties {
report_id: string;
report_age_hours: number;
status: string | null;
priority: string | null;
actionability: string | null;
source_products: string[];
rank: number;
list_size: number;
open_method: InboxReportOpenMethod;
previous_report_id: string | null;
}
export interface InboxReportClosedProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
time_spent_ms: number;
scrolled: boolean;
close_method: InboxReportCloseMethod;
}
export interface InboxReportScrolledProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
rank: number;
list_size: number;
time_since_open_ms: number;
}
export interface UsageViewedProperties {
/** Monthly bucket percent (0-100), null when usage is unavailable. */
sustained_used_percent: number | null;
/** Daily bucket percent (0-100), null when usage is unavailable. */
burst_used_percent: number | null;
/** Which meter the page rendered: org dollars, the valve bucket, or nothing. */
meter_kind: "dollars" | "bucket" | "hidden";
/** The dollar figure the meter rendered, null when it rendered no dollars. */
org_used_usd: number | null;
/** The org limit the figure is measured against, null when no dollars render. */
org_limit_usd: number | null;
/**
* The viewer's own 30-day spend, null when it has not loaded. Read against
* `org_used_usd` to see the two figures disagree.
*/
personal_spend_30d_usd: number | null;
}
export interface SpendAnalysisTaskOpenedProperties {
/** Total LLM spend in USD across all products for the analysed window. */
total_cost_usd: number;
/** Desktop app spend in USD for the analysed window (subset of total). */
scoped_cost_usd: number;
/** Number of `$ai_generation` events in the analysed window. */
scoped_event_count: number;
/** Length of the analysed window in days. */
window_days: number;
/** Number of tool rows the receiving agent will see (capped at 10 in the prompt). */
tool_row_count: number;
/** Number of model rows the receiving agent will see. */
model_row_count: number;
}
export interface InboxReportActionProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
action_type: InboxReportActionType;
surface: InboxReportActionSurface;
is_bulk: boolean;
bulk_size: number;
rank: number;
list_size: number;
triage_id?: string;
dismissal_reason?: string;
dismissal_note?: string;
refund_reason?: string;
refund_note?: string;
signal_id?: string;
signal_source_product?: string;
signal_source_type?: string;
signal_section?: "relevant_code" | "data_queried";
why_field?: "priority" | "actionability";
task_section?: "research" | "implementation";
suggested_reviewer_login?: string;
suggested_reviewer_uuid?: string;
// True when the user submitted Discuss with a first question via the popover.
has_question?: boolean;
// True when the user submitted Create PR with extra feedback via the popover.
has_feedback?: boolean;
}
export interface InboxReportActionResultProperties {
report_id: string;
action_type: InboxReportActionType;
surface: InboxReportActionSurface;
outcome: InboxReportActionOutcome;
duration_ms: number;
is_bulk: boolean;
bulk_size: number;
triage_id?: string;
failure_code?: InboxReportActionFailureCode;
}
/**
* A report's product suggestion was rendered under its evidence, or its link
* to the product was followed. Mirrors cloud's `Inbox report source
* suggestion shown` / `clicked`, so the clients are comparable in one PostHog
* project.
*/
export interface InboxReportSourceSuggestionProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
/** Whether the report already has an implementation PR. */
has_pr: boolean;
product: string;
}
/**
* Thumbs-up/down verdict on a report's usefulness, fired from the feedback
* footer at the end of the report body. Feedback-only: unlike a dismiss, the
* report keeps its state. The sentiment is the label ranking work trains
* against, so it carries the same report classification as the impression and
* open events. Mirrors cloud's `Inbox report feedback`
* (`frontend/src/scenes/inbox/inboxAnalytics.ts`) so the clients are
* comparable in one PostHog project.
*/
export interface InboxReportFeedbackProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
sentiment: InboxReportFeedbackSentiment;
/** Whether the report already has an implementation PR. */
has_pr: boolean;
surface: InboxReportActionSurface;
}
/**
* Optional note, offered only once a rating is already recorded. It
* rides on its own event rather than re-firing {@link InboxReportFeedbackProperties}
* so sentiment stays exactly one event per rating; join back to the rating on
* `report_id`. Carries `sentiment` too so a note can be read without that join.
*/
export interface InboxReportFeedbackNoteProperties {
report_id: string;
report_age_hours: number;
priority: string | null;
actionability: string | null;
sentiment: InboxReportFeedbackSentiment;
has_pr: boolean;
surface: InboxReportActionSurface;
note: string;
}
// Scout events
export type ScoutChatType =
| "fleet_overview"
| "recent_signals"
| "scout_checkin"
| "finding_discuss"
| "author_scout";
export type ScoutSurface =
| "fleet_list"
| "scout_detail"
| "empty_state"
| "scout_findings";
type ScoutActionType =
| "expand_run"
| "collapse_run"
| "expand_emission"
| "collapse_emission"
| "open_task_run"
| "open_skill_in_posthog"
| "open_helper_skill"
| "copy_finding_link"
| "open_linked_report"
| "show_more_emitted_runs"
| "filter_runs"
| "toggle_hide_disabled"
| "filter_created_by"
| "open_settings"
| "close_settings"
| "open_findings"
| "filter_findings"
| "sort_findings"
| "run_now"
| "open_new_agent"
| "accept_suggestion"
| "draft_suggestion"
| "dismiss_suggestion"
| "filter_origin"
| "search_agents"
| "switch_detail_tab";
/**
* How the fleet materialization that preceded this view ended. Without it an
* `is_empty: true` view from a viewer whose sync was refused looks exactly like
* one from a project whose fleet genuinely failed to arrive.
*/
export type ScoutFleetSyncOutcome =
/** The sync ran and answered with the fleet. */
| "synced"
/** No sync was issued — no project was resolved when the section opened. */
| "not_attempted"
/** 403: a member without `signal_scout:write`. The list query still fills the section. */
| "skipped_permission"
/** 404: a stale project id. */
| "not_found"
/** Anything else, including a 5xx. */
| "failed";
export interface ScoutFleetViewedProperties {
scout_count: number;
enabled_count: number;
dry_run_count: number;
custom_count: number;
is_empty: boolean;
sync_outcome: ScoutFleetSyncOutcome;
}
export interface ScoutDetailViewedProperties {
skill_name: string;
scout_origin: "canonical" | "custom";
/** False when the runs window has data but no config exists for this scout. */
has_config: boolean;
enabled: boolean | null;
/** Live (true) vs dry run (false); null when no config was found. */
emit: boolean | null;
run_interval_minutes: number | null;
/** Run stats cover the fleet runs window (currently 24h). */
run_count: number;
emitted_signal_count: number;
failed_run_count: number;
}
export interface ScoutConfigChangedProperties {
skill_name: string;
scout_origin: "canonical" | "custom";
setting:
| "enabled"
| "emit"
| "run_interval_minutes"
| "run_cron_schedule"
| "auto_pause_exempt";
new_value: boolean | number | string | null;
/** Null when the backend predates the setting and never sent a value. */
old_value: boolean | number | string | null;
/** False when the server rejected the update and the change rolled back. */
success: boolean;
}
export interface ScoutChatStartedProperties {
chat_type: ScoutChatType;
surface: ScoutSurface;
/** Set for per-scout check-ins; absent for fleet-level questions. */
skill_name?: string;
}
export interface ScoutActionProperties {
action_type: ScoutActionType;
surface: ScoutSurface;
skill_name?: string;
run_id?: string;
run_status?: string;
emitted_count?: number;
severity?: string | null;
filter?: string;
filter_match_count?: number;
helper_skill?: string;
hide_disabled?: boolean;
created_by_me?: boolean;
/** Status of the linked inbox report, for `open_linked_report`. */
report_status?: string;
}
export interface SignalSourceConnectedProperties {
source_product: SourceProduct;
/** True when this is a brand-new createSignalSourceConfig, false for re-enable of an existing config. */
is_first_connection: boolean;
/** True when the connection went through the DataSourceSetup wizard (warehouse OAuth path). */
via_setup_wizard: boolean;
}
// Agents page events (the `/agents` configuration surface)
type AgentsActionType = "run_setup_agent" | "open_mcp_servers";
export interface AgentsViewedProperties {
/** Whether code access (GitHub) is connected — gates responder configuration. */
has_github_integration: boolean;
/** Total number of responder source products on the page. */
responder_total_count: number;
/** How many of those responders are currently enabled. */
responder_enabled_count: number;
/** User's PR auto-start threshold priority (P0–P4), or null when set to "Never". */
autostart_priority: string | null;
/** Whether the agent-driven setup entry point is shown (feature-flagged). */
setup_task_available: boolean;
}
export interface AgentsActionProperties {
action_type: AgentsActionType;
/** Whether `run_setup_agent` successfully created the setup task. */
success?: boolean;
}
// ── Project Bluebird / Channels (Website) space events ──
/** Where within the Channels space an interaction originated. */
export type ChannelsSurface =
| "header_button"
| "title_bar"
| "nav"
| "sidebar"
| "command_menu"
| "new_task"
| "task_input"
| "channel_home"
| "channel_history"
| "pinned"
| "dashboards_grid"
| "canvas"
| "context"
| "thread_panel"
| "activity_panel"
| "activity"
| "canvases_pane"
| "spaces_index";
type ChannelActionType =
| "enter_space"
| "leave_space"
| "toggle_channels"
| "leave_feedback"
| "nav_click"
| "open_channel"
/** Slid the sidebar back from a channel to the channel list. */
| "browse_channels"
| "collapse_channel"
| "view_more_tasks"
| "create"
| "rename"
| "auto_archive_update"
| "delete"
| "star"
| "unstar"
| "edit_context_open"
| "new_task_open"
| "new_task_suggestion"
| "view_context"
| "view_history"
| "file_task"
| "unfile_task"
| "archive_task"
| "open_task"
| "collapse_thread"
| "expand_thread"
| "copy_link"
| "mention_member"
| "view_activity"
| "open_mention"
| "activity_tab_change"
/** Sessions ↔ Canvases in a space's sidebar list. */
| "space_tab_change"
| "expand_channel"
| "activity_unreads_toggle"
| "activity_mark_all_read"
| "mark_task_read"
| "mark_task_unread"
| "activity_load_more";
type TaskFeedActionType = "create" | "update" | "delete" | "open";
export interface TaskFeedActionProperties {
action_type: TaskFeedActionType;
surface: "sidebar" | "feed_home" | "command_menu";
feed_id: string;
/** Length of the saved query. Do not record its text. */
query_length?: number;
}
export interface ChannelActionProperties {
action_type: ChannelActionType;
surface: ChannelsSurface;
/** The channel acted on, when one is in scope. */
channel_id?: string;
/** For file/unfile/archive/open task actions; for copy_link of a thread. */
task_id?: string;
/** For file_task: destination channel when different from `channel_id`. */
target_channel_id?: string;
/**
* For nav_click: which destination ("home"|"activity"|"inbox"|"canvas"|"agents"|"files"|"settings").
* A space's sidebar rows send their page key, where "home" is the row labelled "Feed".
*/
nav_target?: string;
/** For mention_member: the tagged teammate's user uuid. */
mentioned_user_id?: string;
/** For new_task_suggestion: the starter-prompt card label. */
suggestion_label?: string;
/** The tab landed on; space_tab_change sends the kind it lists ("task" reads "Sessions"). */
tab?: string;
/** For activity_unreads_toggle: the state being entered. */
enabled?: boolean;
/** Whether the underlying mutation resolved successfully. */
success?: boolean;
/** For auto_archive_update: the selected inactivity window. Null disables it. */
inactivity_days?: number | null;
}
type DashboardActionType =
| "open"
| "create"
| "delete"
| "rename"
| "save"
| "fork"
| "edit_toggle"
| "revert"
| "refresh"
| "poll_mode_change"
| "date_range_apply"
| "link_copied"
| "delete_undo"
| "pin"
| "unpin";
export interface DashboardActionProperties {
action_type: DashboardActionType;
surface: ChannelsSurface;
channel_id?: string;
dashboard_id?: string;
/** Template chosen on create. */
template_id?: string;
/** edit_toggle: the state being entered. */
editing?: boolean;
/** poll_mode_change: the new value ("static"|"10s"|"10min"). */
poll_mode?: string;
/** date_range_apply: the named range, when not custom. */
range_name?: string;
/** Whether the underlying mutation resolved successfully. */
success?: boolean;
}
export type CanvasPromptSurface = "json" | "freeform";
export interface CanvasPromptSentProperties {
surface: CanvasPromptSurface;
dashboard_id?: string;
/** True when sent via a suggestion chip rather than free-typed. */
from_suggestion: boolean;
/** "ask_agent_to_fix" for the freeform self-repair path; absent otherwise. */
intent?: "ask_agent_to_fix";
prompt_length_chars: number;
}
export interface CommandCenterCanvasViewedProperties {
dashboard_id: string;
canvas_kind: "freeform" | "grid" | "component";
}
export interface CanvasRenderedProperties {
channel_id?: string;
dashboard_id?: string;
/** The published build whose artifact rendered; absent for head-source renders. */
build_id?: string;
}
export interface CanvasViewedProperties {
channel_id: string;
dashboard_id: string;
canvas_kind: "freeform" | "grid" | "component";
template_id: string;
}
export interface CanvasUnavailableProperties {
dashboard_id: string;
/** `no_access`: the canvas is in a space not shared with the viewer. `missing`: any other miss. */
reason: "no_access" | "missing";
}
export interface CanvasRuntimeErrorProperties {
channel_id?: string;
dashboard_id?: string;
/** The published build whose artifact threw; absent for head-source renders. */
build_id?: string;
/**
* The error's class name (e.g. "TypeError"), or "unknown". Deliberately not the
* raw message: canvas source is user/agent-authored and its exceptions can carry
* source fragments, query results, or secrets that must not cross into analytics.
*/
error_type: string;
/** CSP directive only; blocked URLs never cross into analytics. */
csp_directive?: string;
}
export interface CanvasDataRequestRejectedProperties {
/** Which host bridge refused it: the authoring sandbox or a published build. */
surface: "freeform" | "built";
/**
* Why the host refused it. The request method only — never the payload, which
* is agent-authored and can carry query results.
*/
reason:
| "payload-too-large"
| "data-queue-full"
| "connector-queue-full"
| "needs-user-action"
| "agent-needs-user-action";
method: string;
}
export type ContextActionType =
| "save_version"
| "generate_started"
| "setup_started"
| "discard";
export interface ContextActionProperties {
action_type: ContextActionType;
channel_id: string;
/** generate_started only. */
execution_type?: "local" | "cloud";
/** setup_started only: what the space was set up for. */
setup_kind?: "goal" | "feature";
/** save_version: whether this created the first version vs. an update. */
is_first_version?: boolean;
success?: boolean;
}
export interface ChannelsSpaceViewedProperties {
/** Total channels visible when the space mounts. */
channel_count: number;
starred_count: number;
/** Which shell the space was entered through. */
layout?: SidebarLayout;
}
// Subscription / billing events
type UpgradePromptShownSurface =
| "usage_limit_modal"
| "titlebar_card"
| "billing_announcement"
| "model_picker";
export type UpgradePromptClickedSurface =
| "usage_limit_modal"
| "sidebar"
| "titlebar"
| "titlebar_card"
| "plan_page_card"
| "billing_announcement"
| "model_picker";
type UpgradePromptCause =
| "model_gate"
| "model_unavailable"
| "org_limit"
| "user_limit";
export interface UpgradePromptShownProperties {
surface: UpgradePromptShownSurface;
cause?: UpgradePromptCause;
}
export interface UpgradePromptClickedProperties {
surface: UpgradePromptClickedSurface;
cause?: UpgradePromptCause;
}
export interface CloudTaskUsageBlockedProperties {
bucket: "burst" | "sustained" | null;
}
// Claude Code session import events
/** Where in the new-task suggestions the import was launched from. */
export type ClaudeSessionImportSource = "inline_card" | "picker_dialog";
/**
* Import status of a listed CLI session. "imported" sessions are hidden from
* the suggestions, so an import is only ever started from a "new" or "updated"
* one; the wider union mirrors the domain status field.
*/
type ClaudeSessionImportStatus = "new" | "imported" | "updated";
export interface ClaudeSessionsShownProperties {
/** Resumable Claude Code CLI sessions surfaced for the repo. */
sessions_count: number;
}
export interface ClaudeSessionImportedProperties {
source: ClaudeSessionImportSource;
session_status: ClaudeSessionImportStatus;
has_git_branch: boolean;
/** Resumable sessions available when this one was imported. */
sessions_available_count: number;
}
export interface ClaudeSessionImportFailedProperties {
source: ClaudeSessionImportSource;
session_status: ClaudeSessionImportStatus;
/** Saga step that failed, e.g. "import_claude_session" or "task_creation". */
failed_step?: string;
}
/** Fired when a user arms autoresearch mode on the new-task composer. */
export interface AutoresearchArmedProperties {
/** Hands-off mode auto-applied on arm so the unattended loop isn't blocked on permission prompts. */
default_mode: "bypassPermissions" | "acceptEdits";
workspace_mode?: "local" | "worktree" | "cloud";
}
/** Fired when an armed autoresearch task is submitted and its run kicks off. */
export interface AutoresearchRunStartedProperties {
direction: "maximize" | "minimize";
/** Whether the user set a target metric value to stop early at. */
has_target: boolean;
max_iterations: number;
/** Build and measure stages differ, so each iteration splits into a build turn and a measure turn. */
stages_split: boolean;
implement_model?: string;
measure_model?: string;
implement_effort?: string;
measure_effort?: string;
workspace_mode?: "local" | "worktree" | "cloud";
}
// Loops events
type LoopReasoningEffort = EffortLevel;
type LoopRunStatus =
| "not_started"
| "queued"
| "in_progress"
| "completed"
| "failed"
| "cancelled";
export interface LoopListViewedProperties {
loop_count: number;
global_loop_count: number;
space_count: number;
builder_session_count: number;
}
export interface LoopViewedProperties {
loop_id: string;
enabled: boolean;
model?: string;
reasoning_effort: LoopReasoningEffort | null;
repository_count: number;
trigger_count: number;
has_schedule_trigger: boolean;
has_github_trigger: boolean;
/** Backend-open string, not a closed enum. */
last_run_status: string | null;
recent_run_count: number;
}
export interface LoopSavedProperties {
loop_id: string;
model?: string;
reasoning_effort: LoopReasoningEffort | null;
repository_count: number;
trigger_count: number;
has_schedule_trigger: boolean;
has_github_trigger: boolean;
/** Count of notifications.{email,slack} that are enabled. */
notification_channel_count: number;
has_context_target: boolean;
}
export interface LoopDeletedProperties {
loop_id: string;
enabled: boolean;
trigger_count: number;
}
export interface LoopEnabledToggledProperties {
loop_id: string;
/** The new value the loop is being switched to. */
enabled: boolean;
success: boolean;
}
export interface LoopRunStartedProperties {
loop_id: string;
model?: string;
trigger_count: number;
}
export interface LoopRunViewedProperties {
loop_id: string;
run_id: string;
task_id: string;
status: LoopRunStatus;
environment: "local" | "cloud";
}
export interface LoopLinkCopiedProperties {
loop_id: string;
}
export interface AnnouncementProperties {
announcement_id: string;
announcement_kind: "announcement" | "required-update";
announcement_style: "banner" | "modal";
}
// Privacy: these events never carry the referenced id, name, query text, or
// result data. For a hogql reference the id is the SQL itself.
export interface EvidencePreviewShownProperties {
kind: string;
cache: "hit" | "miss";
reference_source: "link" | "tag";
}
export interface EvidencePreviewReadyProperties {
kind: string;
source: "hover" | "prefetch";
latency_ms: number;
has_preview: boolean;
}
export interface EvidencePreviewFailedProperties {
kind: string;
source: "hover" | "prefetch";
latency_ms: number;
}
export interface AnnouncementCtaClickedProperties
extends AnnouncementProperties {
cta_type: "external" | "deeplink" | "update";
}
export interface AnnouncementAcknowledgedProperties
extends AnnouncementProperties {
/** "ok" = the ack button; "update" = an update action counted as the ack. */
ack_type: "ok" | "update";
}
// Event names as constants
export const ANALYTICS_EVENTS = {
// App lifecycle
APP_STARTED: "App started",
APP_QUIT: "App quit",
// Authentication
USER_LOGGED_IN: "Desktop user logged in",
USER_LOGGED_OUT: "User logged out",
// Task management
TASK_LIST_VIEWED: "Task list viewed",
TASK_CREATED: "Task created",
TASK_VIEWED: "Task viewed",
TASK_RUN: "Task run",
TASK_RUN_STARTED: "Task run started",
TASK_RUN_COMPLETED: "Task run completed",
TASK_RUN_CANCELLED: "Task run cancelled",
TASK_RUN_STOPPED: "Task run stopped",
PROMPT_SENT: "Prompt sent",
AGENT_TURN_FEEDBACK: "Agent turn feedback",
// Claude Code session import
CLAUDE_SESSIONS_SHOWN: "Claude Code sessions shown",
CLAUDE_SESSION_IMPORTED: "Claude Code session imported",
CLAUDE_SESSION_IMPORT_FAILED: "Claude Code session import failed",
// Repository
REPOSITORY_SELECTED: "Repository selected",
// Git operations
GIT_ACTION_EXECUTED: "Git action executed",
PR_CREATED: "PR created",
AGENT_FILE_ACTIVITY: "Agent file activity",
BRANCH_LINKED: "Branch linked",
BRANCH_UNLINKED: "Branch unlinked",
BRANCH_LINK_DEFAULT_BRANCH_UNKNOWN: "Branch link default branch unknown",
// File interactions
FILE_OPENED: "File opened",
FILE_DIFF_VIEWED: "File diff viewed",
REVIEW_PANEL_VIEWED: "Review panel viewed",
DIFF_VIEW_MODE_CHANGED: "Diff view mode changed",
REVIEW_FILE_BROWSER_TOGGLED: "Review file browser toggled",
// Workspace events
WORKSPACE_CREATED: "Workspace created",
WORKSPACE_SCRIPTS_STARTED: "Workspace scripts started",
FOLDER_REGISTERED: "Folder registered",
// Navigation events
SETTINGS_VIEWED: "Settings viewed",
COMMAND_MENU_OPENED: "Command menu opened",
COMMAND_MENU_ACTION: "Command menu action",
COMMAND_CENTER_VIEWED: "Command center viewed",
COMMAND_CENTER_CANVAS_VIEWED: "Command center canvas viewed",
BRAINROT_ACTIVATED: "Brainrot activated",
BRAINROT_PLAYER_ERROR: "Brainrot player error",
POSTHOG_WEB_OPENED: "PostHog web opened",
SIDEBAR_NAV_ITEM_CLICKED: "Sidebar nav item clicked",
TASK_LIST_GROUPING_CHANGED: "Task list grouping changed",
TASK_LIST_APPEARANCE_CHANGED: "Task list appearance changed",
BROWSER_TAB_TILED: "Browser tab tiled",
BROWSER_TAB_UNTILED: "Browser tab untiled",
BROWSER_TAB_TILE_FOCUSED: "Browser tab tile focused",
BROWSER_TAB_SPLIT_RENAMED: "Browser tab split renamed",
// Permission events
PERMISSION_RESPONDED: "Permission responded",
PERMISSION_CANCELLED: "Permission cancelled",
// Session config events
SESSION_CONFIG_CHANGED: "Session config changed",
MODEL_SWITCH_WARNING_SHOWN: "Model switch warning shown",
MODEL_SWITCH_WARNING_ACTION: "Model switch warning action",
SESSION_SUMMARY_REQUESTED: "Session summary requested",
SESSION_SUMMARY_ACTION: "Session summary action",
// Settings events
SETTING_CHANGED: "Setting changed",
CUSTOM_SOUND_ADDED: "Custom sound added",
SETTINGS_BACKUP_EXPORTED: "Settings backup exported",
SETTINGS_BACKUP_EXPORT_FAILED: "Settings backup export failed",
SETTINGS_BACKUP_IMPORTED: "Settings backup imported",
SETTINGS_BACKUP_IMPORT_FAILED: "Settings backup import failed",
CUSTOM_SOUND_RECORDING_SILENT: "Custom sound recording silent",
CODEX_SUBSCRIPTION_CONNECTED: "Codex subscription connected",
CODEX_SUBSCRIPTION_SIGNED_OUT: "Codex subscription signed out",
CLAUDE_SUBSCRIPTION_CONNECTED: "Claude subscription connected",
CLAUDE_SUBSCRIPTION_SIGNED_OUT: "Claude subscription signed out",
CLAUDE_CLOUD_TOKEN_SAVED: "Claude cloud token saved",
CLAUDE_CLOUD_TOKEN_REMOVED: "Claude cloud token removed",
CODEX_CLOUD_ACCOUNT_CONNECTED: "Codex cloud account connected",
CODEX_CLOUD_ACCOUNT_DISCONNECTED: "Codex cloud account disconnected",
CLOUD_CREDENTIAL_RELAY: "Cloud credential relay",
// Feedback events
AI_METRIC: "$ai_metric",
AI_FEEDBACK: "$ai_feedback",
// Branch mismatch events
BRANCH_MISMATCH_WARNING_SHOWN: "Branch mismatch warning shown",
BRANCH_MISMATCH_ACTION: "Branch mismatch action",
// Tour events
TOUR_EVENT: "Tour event",
// Onboarding events
ONBOARDING_STARTED: "Onboarding started",
ONBOARDING_STEP_VIEWED: "Onboarding step viewed",
ONBOARDING_STEP_COMPLETED: "Onboarding step completed",
ONBOARDING_STEP_SKIPPED: "Onboarding step skipped",
ONBOARDING_SIGN_IN_INITIATED: "Onboarding sign in initiated",
ONBOARDING_PROJECT_SELECTED: "Onboarding project selected",
ONBOARDING_GITHUB_CONNECT_STARTED: "Onboarding github connect started",
ONBOARDING_GITHUB_CONNECT_FAILED: "Onboarding github connect failed",
ONBOARDING_GITHUB_CONNECT_PENDING_ADMIN:
"Onboarding github connect pending admin",
ONBOARDING_GITHUB_CONNECT_ABANDONED: "Onboarding github connect abandoned",
ONBOARDING_GITHUB_CONNECTED: "Onboarding github connected",
ONBOARDING_CLI_CHECK_COMPLETED: "Onboarding cli check completed",
ONBOARDING_CLI_RUN_COMPLETED: "Onboarding cli run completed",
ONBOARDING_COMPLETED: "Onboarding completed",
ONBOARDING_ABANDONED: "Onboarding abandoned",
AI_CONSENT_GATE_SHOWN: "Ai consent gate shown",
AI_CONSENT_APPROVED: "Ai consent approved",
AI_CONSENT_GRANTED_INAPP: "Ai consent granted in-app",
CONSENT_ADMIN_LINK_COPIED: "Consent admin link copied",
DESKTOP_BETA_TERMS_ACCEPTED: "Desktop beta terms accepted",
DESKTOP_BETA_TERMS_ACCEPTED_INAPP: "Desktop beta terms accepted in-app",
// Setup / onboarding events
SETUP_DISCOVERY_STARTED: "Setup discovery started",
SETUP_DISCOVERY_COMPLETED: "Setup discovery completed",
SETUP_DISCOVERY_FAILED: "Setup discovery failed",
SETUP_TASK_SELECTED: "Setup task selected",
SETUP_TASK_DISMISSED: "Setup task dismissed",
// Deep link events
DEEP_LINK_NEW_TASK: "Deep link new task",
DEEP_LINK_PLAN: "Deep link plan",
DEEP_LINK_ISSUE: "Deep link issue",
DEEP_LINK_ISSUE_FAILED: "Deep link issue failed",
DEEP_LINK_CANVAS: "Deep link canvas",
DEEP_LINK_CHANNEL: "Deep link channel",
// Error events
TASK_CREATION_FAILED: "Task creation failed",
AGENT_SESSION_ERROR: "Agent session error",
CLOUD_STREAM_DISCONNECTED: "Cloud stream disconnected",
CLOUD_STREAM_IDLE_TIMEOUT: "Cloud stream idle timeout",
// Inbox events
INBOX_VIEWED: "Inbox viewed",
INBOX_REPORT_OPENED: "Inbox report opened",
INBOX_REPORT_CLOSED: "Inbox report closed",
INBOX_REPORT_ACTION: "Inbox report action",
INBOX_REPORT_ACTION_RESULT: "Inbox report action result",
INBOX_REPORT_SCROLLED: "Inbox report scrolled",
INBOX_REPORT_FEEDBACK: "Inbox report feedback",
INBOX_REPORT_FEEDBACK_NOTE: "Inbox report feedback note",
INBOX_REPORT_SOURCE_SUGGESTION_SHOWN: "Inbox report source suggestion shown",
INBOX_REPORT_SOURCE_SUGGESTION_CLICKED:
"Inbox report source suggestion clicked",
INBOX_TRIAGE_STARTED: "Inbox triage started",
INBOX_TRIAGE_ENDED: "Inbox triage ended",
SIGNAL_SOURCE_CONNECTED: "Signal source connected",
// Agents page events
AGENTS_VIEWED: "Agents viewed",
AGENTS_ACTION: "Agents action",
// Scout events
SCOUT_FLEET_VIEWED: "Scout fleet viewed",
SCOUT_DETAIL_VIEWED: "Scout detail viewed",
SCOUT_CONFIG_CHANGED: "Scout config changed",
SCOUT_CHAT_STARTED: "Scout chat started",
SCOUT_ACTION: "Scout action",
// Usage and spend analysis events
USAGE_VIEWED: "Usage viewed",
SPEND_ANALYSIS_TASK_OPENED: "Spend analysis task opened",
// Prompt history events
PROMPT_HISTORY_OPENED: "Prompt history opened",
PROMPT_HISTORY_SELECTED: "Prompt history selected",
// Subscription events
UPGRADE_PROMPT_SHOWN: "Upgrade prompt shown",
UPGRADE_PROMPT_CLICKED: "Upgrade prompt clicked",
CLOUD_TASK_USAGE_BLOCKED: "Cloud task usage blocked",
// Project Bluebird (Channels) events
CHANNELS_SPACE_VIEWED: "Channels space viewed",
CHANNEL_ACTION: "Channel action",
TASK_FEED_ACTION: "Task feed action",
DASHBOARD_ACTION: "Dashboard action",
CANVAS_PROMPT_SENT: "Canvas prompt sent",
CANVAS_VIEWED: "Canvas viewed",
CANVAS_UNAVAILABLE: "Canvas unavailable",
CANVAS_RENDERED: "Canvas rendered",
CANVAS_RUNTIME_ERROR: "Canvas runtime error",
CANVAS_DATA_REQUEST_REJECTED: "Canvas data request rejected",
CONTEXT_ACTION: "Context action",
PROJECT_MENU_ACTION: "Project menu action",
DESKTOP_ACCESS_SCREEN_SHOWN: "Desktop access screen shown",
DESKTOP_ACCESS_LINK_OPENED: "Desktop access link opened",
// Autoresearch events
AUTORESEARCH_ARMED: "Autoresearch armed",
AUTORESEARCH_RUN_STARTED: "Autoresearch run started",
TASK_ANALYSIS_REQUESTED: "Task analysis requested",
// Evidence (insight link) preview events
EVIDENCE_PREVIEW_SHOWN: "Evidence preview shown",
EVIDENCE_PREVIEW_READY: "Evidence preview ready",
EVIDENCE_PREVIEW_FAILED: "Evidence preview failed",
// Remote in-app announcement events
ANNOUNCEMENT_SHOWN: "Announcement shown",
ANNOUNCEMENT_DISMISSED: "Announcement dismissed",
ANNOUNCEMENT_CTA_CLICKED: "Announcement CTA clicked",
ANNOUNCEMENT_ACKNOWLEDGED: "Announcement acknowledged",
// Loops events
LOOP_LIST_VIEWED: "Loop list viewed",
LOOP_VIEWED: "Loop viewed",
LOOP_CREATED: "Loop created",
LOOP_UPDATED: "Loop updated",
LOOP_DELETED: "Loop deleted",
LOOP_ENABLED_TOGGLED: "Loop enabled toggled",
LOOP_RUN_STARTED: "Loop run started",
LOOP_RUN_VIEWED: "Loop run viewed",
LOOP_LINK_COPIED: "Loop link copied",
COMMENT_SENT_TO_AGENT: "Comment sent to agent",
} as const;
// Event property mapping
export type EventPropertyMap = {
[ANALYTICS_EVENTS.TASK_LIST_VIEWED]: TaskListViewProperties | undefined;
[ANALYTICS_EVENTS.TASK_CREATED]: TaskCreateProperties;
[ANALYTICS_EVENTS.TASK_VIEWED]: TaskViewProperties;
[ANALYTICS_EVENTS.TASK_RUN]: TaskRunProperties;
[ANALYTICS_EVENTS.REPOSITORY_SELECTED]: RepositorySelectProperties;
[ANALYTICS_EVENTS.USER_LOGGED_IN]: UserIdentifyProperties | undefined;
[ANALYTICS_EVENTS.USER_LOGGED_OUT]: never;
// Task execution events
[ANALYTICS_EVENTS.TASK_RUN_STARTED]: TaskRunStartedProperties;
[ANALYTICS_EVENTS.TASK_RUN_COMPLETED]: TaskRunCompletedProperties;
[ANALYTICS_EVENTS.TASK_RUN_CANCELLED]: TaskRunCancelledProperties;
[ANALYTICS_EVENTS.TASK_RUN_STOPPED]: TaskRunStoppedProperties;
[ANALYTICS_EVENTS.PROMPT_SENT]: PromptSentProperties;
[ANALYTICS_EVENTS.AGENT_TURN_FEEDBACK]: AgentTurnFeedbackProperties;
// Claude Code session import
[ANALYTICS_EVENTS.CLAUDE_SESSIONS_SHOWN]: ClaudeSessionsShownProperties;
[ANALYTICS_EVENTS.CLAUDE_SESSION_IMPORTED]: ClaudeSessionImportedProperties;
[ANALYTICS_EVENTS.CLAUDE_SESSION_IMPORT_FAILED]: ClaudeSessionImportFailedProperties;
// Git operations
[ANALYTICS_EVENTS.GIT_ACTION_EXECUTED]: GitActionExecutedProperties;
[ANALYTICS_EVENTS.PR_CREATED]: PrCreatedProperties;
[ANALYTICS_EVENTS.AGENT_FILE_ACTIVITY]: AgentFileActivityProperties;
[ANALYTICS_EVENTS.BRANCH_LINKED]: BranchLinkedProperties;
[ANALYTICS_EVENTS.BRANCH_UNLINKED]: BranchUnlinkedProperties;
[ANALYTICS_EVENTS.BRANCH_LINK_DEFAULT_BRANCH_UNKNOWN]: BranchLinkDefaultBranchUnknownProperties;
// File interactions
[ANALYTICS_EVENTS.FILE_OPENED]: FileOpenedProperties;
[ANALYTICS_EVENTS.FILE_DIFF_VIEWED]: FileDiffViewedProperties;
[ANALYTICS_EVENTS.REVIEW_PANEL_VIEWED]: ReviewPanelViewedProperties;
[ANALYTICS_EVENTS.DIFF_VIEW_MODE_CHANGED]: DiffViewModeChangedProperties;
[ANALYTICS_EVENTS.REVIEW_FILE_BROWSER_TOGGLED]: ReviewFileBrowserToggledProperties;
// Workspace events
[ANALYTICS_EVENTS.WORKSPACE_CREATED]: WorkspaceCreatedProperties;
[ANALYTICS_EVENTS.WORKSPACE_SCRIPTS_STARTED]: WorkspaceScriptsStartedProperties;
[ANALYTICS_EVENTS.FOLDER_REGISTERED]: FolderRegisteredProperties;
// Navigation events
[ANALYTICS_EVENTS.SETTINGS_VIEWED]: never;
[ANALYTICS_EVENTS.COMMAND_MENU_OPENED]: never;
[ANALYTICS_EVENTS.COMMAND_MENU_ACTION]: CommandMenuActionProperties;
[ANALYTICS_EVENTS.COMMAND_CENTER_VIEWED]: never;
[ANALYTICS_EVENTS.COMMAND_CENTER_CANVAS_VIEWED]: CommandCenterCanvasViewedProperties;
[ANALYTICS_EVENTS.BRAINROT_ACTIVATED]: BrainrotActivatedProperties;
[ANALYTICS_EVENTS.BRAINROT_PLAYER_ERROR]: BrainrotPlayerErrorProperties;
[ANALYTICS_EVENTS.POSTHOG_WEB_OPENED]: never;
[ANALYTICS_EVENTS.SIDEBAR_NAV_ITEM_CLICKED]: SidebarNavItemClickedProperties;
[ANALYTICS_EVENTS.TASK_LIST_GROUPING_CHANGED]: TaskListGroupingChangedProperties;
[ANALYTICS_EVENTS.TASK_LIST_APPEARANCE_CHANGED]: TaskListAppearanceChangedProperties;
[ANALYTICS_EVENTS.BROWSER_TAB_TILED]: BrowserTabTiledProperties;
[ANALYTICS_EVENTS.BROWSER_TAB_UNTILED]: BrowserTabTileCountProperties;
[ANALYTICS_EVENTS.BROWSER_TAB_TILE_FOCUSED]: BrowserTabTileCountProperties;
[ANALYTICS_EVENTS.BROWSER_TAB_SPLIT_RENAMED]: BrowserTabTileCountProperties;
// Permission events
[ANALYTICS_EVENTS.PERMISSION_RESPONDED]: PermissionRespondedProperties;
[ANALYTICS_EVENTS.PERMISSION_CANCELLED]: PermissionCancelledProperties;
// Session config events
[ANALYTICS_EVENTS.SESSION_CONFIG_CHANGED]: SessionConfigChangedProperties;
[ANALYTICS_EVENTS.MODEL_SWITCH_WARNING_SHOWN]: ModelSwitchWarningShownProperties;
[ANALYTICS_EVENTS.MODEL_SWITCH_WARNING_ACTION]: ModelSwitchWarningActionProperties;
[ANALYTICS_EVENTS.SESSION_SUMMARY_REQUESTED]: SessionSummaryRequestedProperties;
[ANALYTICS_EVENTS.SESSION_SUMMARY_ACTION]: SessionSummaryActionProperties;
// Settings events
[ANALYTICS_EVENTS.SETTING_CHANGED]: SettingChangedProperties;
[ANALYTICS_EVENTS.CLAUDE_CLOUD_TOKEN_SAVED]: never;
[ANALYTICS_EVENTS.CLAUDE_CLOUD_TOKEN_REMOVED]: never;
[ANALYTICS_EVENTS.CODEX_CLOUD_ACCOUNT_CONNECTED]: never;
[ANALYTICS_EVENTS.CODEX_CLOUD_ACCOUNT_DISCONNECTED]: never;
[ANALYTICS_EVENTS.CLOUD_CREDENTIAL_RELAY]: CloudCredentialRelayProperties;
[ANALYTICS_EVENTS.CUSTOM_SOUND_ADDED]: CustomSoundAddedProperties;
[ANALYTICS_EVENTS.SETTINGS_BACKUP_EXPORTED]: SettingsBackupExportProperties;
[ANALYTICS_EVENTS.SETTINGS_BACKUP_EXPORT_FAILED]: SettingsBackupExportFailedProperties;
[ANALYTICS_EVENTS.SETTINGS_BACKUP_IMPORTED]: SettingsBackupImportedProperties;
[ANALYTICS_EVENTS.SETTINGS_BACKUP_IMPORT_FAILED]: SettingsBackupImportFailedProperties;
[ANALYTICS_EVENTS.CUSTOM_SOUND_RECORDING_SILENT]: never;
[ANALYTICS_EVENTS.CODEX_SUBSCRIPTION_CONNECTED]: never;
[ANALYTICS_EVENTS.CODEX_SUBSCRIPTION_SIGNED_OUT]: never;
[ANALYTICS_EVENTS.CLAUDE_SUBSCRIPTION_CONNECTED]: never;
[ANALYTICS_EVENTS.CLAUDE_SUBSCRIPTION_SIGNED_OUT]: never;
// Feedback events
[ANALYTICS_EVENTS.AI_METRIC]: AiMetricProperties;
[ANALYTICS_EVENTS.AI_FEEDBACK]: AiFeedbackProperties;
// Branch mismatch events
[ANALYTICS_EVENTS.BRANCH_MISMATCH_WARNING_SHOWN]: BranchMismatchWarningShownProperties;
[ANALYTICS_EVENTS.BRANCH_MISMATCH_ACTION]: BranchMismatchActionProperties;
// Tour events
[ANALYTICS_EVENTS.TOUR_EVENT]: TourEventProperties;
// Onboarding events
[ANALYTICS_EVENTS.ONBOARDING_STARTED]: never;
[ANALYTICS_EVENTS.ONBOARDING_STEP_VIEWED]: OnboardingStepViewedProperties;
[ANALYTICS_EVENTS.ONBOARDING_STEP_COMPLETED]: OnboardingStepCompletedProperties;
[ANALYTICS_EVENTS.ONBOARDING_STEP_SKIPPED]: OnboardingStepSkippedProperties;
[ANALYTICS_EVENTS.ONBOARDING_SIGN_IN_INITIATED]: OnboardingSignInInitiatedProperties;
[ANALYTICS_EVENTS.ONBOARDING_PROJECT_SELECTED]: OnboardingProjectSelectedProperties;
[ANALYTICS_EVENTS.ONBOARDING_GITHUB_CONNECT_STARTED]: OnboardingGithubConnectStartedProperties;
[ANALYTICS_EVENTS.ONBOARDING_GITHUB_CONNECT_FAILED]: OnboardingGithubConnectFailedProperties;
[ANALYTICS_EVENTS.ONBOARDING_GITHUB_CONNECT_PENDING_ADMIN]: OnboardingGithubConnectPendingAdminProperties;
[ANALYTICS_EVENTS.ONBOARDING_GITHUB_CONNECT_ABANDONED]: OnboardingGithubConnectAbandonedProperties;
[ANALYTICS_EVENTS.ONBOARDING_GITHUB_CONNECTED]: never;
[ANALYTICS_EVENTS.ONBOARDING_CLI_CHECK_COMPLETED]: OnboardingCliCheckCompletedProperties;
[ANALYTICS_EVENTS.ONBOARDING_CLI_RUN_COMPLETED]: OnboardingCliRunCompletedProperties;
[ANALYTICS_EVENTS.ONBOARDING_COMPLETED]: OnboardingCompletedProperties;
[ANALYTICS_EVENTS.ONBOARDING_ABANDONED]: OnboardingAbandonedProperties;
[ANALYTICS_EVENTS.AI_CONSENT_GATE_SHOWN]: AiConsentGateShownProperties;
[ANALYTICS_EVENTS.AI_CONSENT_APPROVED]: never;
[ANALYTICS_EVENTS.AI_CONSENT_GRANTED_INAPP]: never;
[ANALYTICS_EVENTS.CONSENT_ADMIN_LINK_COPIED]: ConsentAdminLinkCopiedProperties;
[ANALYTICS_EVENTS.DESKTOP_BETA_TERMS_ACCEPTED]: never;
[ANALYTICS_EVENTS.DESKTOP_BETA_TERMS_ACCEPTED_INAPP]: never;
// Setup / onboarding events
[ANALYTICS_EVENTS.SETUP_DISCOVERY_STARTED]: SetupDiscoveryStartedProperties;
[ANALYTICS_EVENTS.SETUP_DISCOVERY_COMPLETED]: SetupDiscoveryCompletedProperties;
[ANALYTICS_EVENTS.SETUP_DISCOVERY_FAILED]: SetupDiscoveryFailedProperties;
[ANALYTICS_EVENTS.SETUP_TASK_SELECTED]: SetupTaskSelectedProperties;
[ANALYTICS_EVENTS.SETUP_TASK_DISMISSED]: SetupTaskDismissedProperties;
// Deep link events
[ANALYTICS_EVENTS.DEEP_LINK_NEW_TASK]: DeepLinkNewTaskProperties;
[ANALYTICS_EVENTS.DEEP_LINK_PLAN]: DeepLinkPlanProperties;
[ANALYTICS_EVENTS.DEEP_LINK_ISSUE]: DeepLinkIssueProperties;
[ANALYTICS_EVENTS.DEEP_LINK_ISSUE_FAILED]: DeepLinkIssueFailedProperties;
[ANALYTICS_EVENTS.DEEP_LINK_CANVAS]: DeepLinkCanvasProperties;
[ANALYTICS_EVENTS.DEEP_LINK_CHANNEL]: DeepLinkChannelProperties;
// Error events
[ANALYTICS_EVENTS.TASK_CREATION_FAILED]: TaskCreationFailedProperties;
[ANALYTICS_EVENTS.AGENT_SESSION_ERROR]: AgentSessionErrorProperties;
[ANALYTICS_EVENTS.CLOUD_STREAM_DISCONNECTED]: CloudStreamDisconnectedProperties;
[ANALYTICS_EVENTS.CLOUD_STREAM_IDLE_TIMEOUT]: CloudStreamIdleTimeoutProperties;
// Inbox events
[ANALYTICS_EVENTS.INBOX_VIEWED]: InboxViewedProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_OPENED]: InboxReportOpenedProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_CLOSED]: InboxReportClosedProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_ACTION]: InboxReportActionProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_ACTION_RESULT]: InboxReportActionResultProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_SCROLLED]: InboxReportScrolledProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_FEEDBACK]: InboxReportFeedbackProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_FEEDBACK_NOTE]: InboxReportFeedbackNoteProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_SOURCE_SUGGESTION_SHOWN]: InboxReportSourceSuggestionProperties;
[ANALYTICS_EVENTS.INBOX_REPORT_SOURCE_SUGGESTION_CLICKED]: InboxReportSourceSuggestionProperties;
[ANALYTICS_EVENTS.INBOX_TRIAGE_STARTED]: InboxTriageStartedProperties;
[ANALYTICS_EVENTS.INBOX_TRIAGE_ENDED]: InboxTriageEndedProperties;
[ANALYTICS_EVENTS.SIGNAL_SOURCE_CONNECTED]: SignalSourceConnectedProperties;
// Agents page events
[ANALYTICS_EVENTS.AGENTS_VIEWED]: AgentsViewedProperties;
[ANALYTICS_EVENTS.AGENTS_ACTION]: AgentsActionProperties;
// Scout events
[ANALYTICS_EVENTS.SCOUT_FLEET_VIEWED]: ScoutFleetViewedProperties;
[ANALYTICS_EVENTS.SCOUT_DETAIL_VIEWED]: ScoutDetailViewedProperties;
[ANALYTICS_EVENTS.SCOUT_CONFIG_CHANGED]: ScoutConfigChangedProperties;
[ANALYTICS_EVENTS.SCOUT_CHAT_STARTED]: ScoutChatStartedProperties;
[ANALYTICS_EVENTS.SCOUT_ACTION]: ScoutActionProperties;
// Usage and spend analysis events
[ANALYTICS_EVENTS.USAGE_VIEWED]: UsageViewedProperties;
[ANALYTICS_EVENTS.SPEND_ANALYSIS_TASK_OPENED]: SpendAnalysisTaskOpenedProperties;
// Prompt history events
[ANALYTICS_EVENTS.PROMPT_HISTORY_OPENED]: PromptHistoryOpenedProperties;
[ANALYTICS_EVENTS.PROMPT_HISTORY_SELECTED]: PromptHistorySelectedProperties;
// Subscription events
[ANALYTICS_EVENTS.UPGRADE_PROMPT_SHOWN]: UpgradePromptShownProperties;
[ANALYTICS_EVENTS.UPGRADE_PROMPT_CLICKED]: UpgradePromptClickedProperties;
[ANALYTICS_EVENTS.CLOUD_TASK_USAGE_BLOCKED]: CloudTaskUsageBlockedProperties;
// Project Bluebird (Channels) events
[ANALYTICS_EVENTS.CHANNELS_SPACE_VIEWED]: ChannelsSpaceViewedProperties;
[ANALYTICS_EVENTS.CHANNEL_ACTION]: ChannelActionProperties;
[ANALYTICS_EVENTS.TASK_FEED_ACTION]: TaskFeedActionProperties;
[ANALYTICS_EVENTS.DASHBOARD_ACTION]: DashboardActionProperties;
[ANALYTICS_EVENTS.CANVAS_PROMPT_SENT]: CanvasPromptSentProperties;
[ANALYTICS_EVENTS.CANVAS_VIEWED]: CanvasViewedProperties;
[ANALYTICS_EVENTS.CANVAS_UNAVAILABLE]: CanvasUnavailableProperties;
[ANALYTICS_EVENTS.CANVAS_RENDERED]: CanvasRenderedProperties;
[ANALYTICS_EVENTS.CANVAS_RUNTIME_ERROR]: CanvasRuntimeErrorProperties;
[ANALYTICS_EVENTS.CANVAS_DATA_REQUEST_REJECTED]: CanvasDataRequestRejectedProperties;
[ANALYTICS_EVENTS.CONTEXT_ACTION]: ContextActionProperties;
[ANALYTICS_EVENTS.PROJECT_MENU_ACTION]: ProjectMenuActionProperties;
[ANALYTICS_EVENTS.DESKTOP_ACCESS_SCREEN_SHOWN]: DesktopAccessScreenShownProperties;
[ANALYTICS_EVENTS.DESKTOP_ACCESS_LINK_OPENED]: DesktopAccessLinkOpenedProperties;
// Autoresearch events
[ANALYTICS_EVENTS.AUTORESEARCH_ARMED]: AutoresearchArmedProperties;
[ANALYTICS_EVENTS.AUTORESEARCH_RUN_STARTED]: AutoresearchRunStartedProperties;
[ANALYTICS_EVENTS.TASK_ANALYSIS_REQUESTED]: {
task_id: string;
run_id: string;
created: boolean;
};
// Evidence (insight link) preview events
[ANALYTICS_EVENTS.EVIDENCE_PREVIEW_SHOWN]: EvidencePreviewShownProperties;
[ANALYTICS_EVENTS.EVIDENCE_PREVIEW_READY]: EvidencePreviewReadyProperties;
[ANALYTICS_EVENTS.EVIDENCE_PREVIEW_FAILED]: EvidencePreviewFailedProperties;
// Remote in-app announcement events
[ANALYTICS_EVENTS.ANNOUNCEMENT_SHOWN]: AnnouncementProperties;
[ANALYTICS_EVENTS.ANNOUNCEMENT_DISMISSED]: AnnouncementProperties;
[ANALYTICS_EVENTS.ANNOUNCEMENT_CTA_CLICKED]: AnnouncementCtaClickedProperties;
[ANALYTICS_EVENTS.ANNOUNCEMENT_ACKNOWLEDGED]: AnnouncementAcknowledgedProperties;
// Loops events
[ANALYTICS_EVENTS.LOOP_LIST_VIEWED]: LoopListViewedProperties;
[ANALYTICS_EVENTS.LOOP_VIEWED]: LoopViewedProperties;
[ANALYTICS_EVENTS.LOOP_CREATED]: LoopSavedProperties;
[ANALYTICS_EVENTS.LOOP_UPDATED]: LoopSavedProperties;
[ANALYTICS_EVENTS.LOOP_DELETED]: LoopDeletedProperties;
[ANALYTICS_EVENTS.LOOP_ENABLED_TOGGLED]: LoopEnabledToggledProperties;
[ANALYTICS_EVENTS.LOOP_RUN_STARTED]: LoopRunStartedProperties;
[ANALYTICS_EVENTS.LOOP_RUN_VIEWED]: LoopRunViewedProperties;
[ANALYTICS_EVENTS.LOOP_LINK_COPIED]: LoopLinkCopiedProperties;
[ANALYTICS_EVENTS.COMMENT_SENT_TO_AGENT]: CommentSentToAgentProperties;
};
/**
* The inbox event family. Every host stamps an `inbox_client` property (e.g.
* "code" on desktop, "mobile" on the mobile app, "cloud" on the PostHog web
* frontend) on exactly these events so the shared PostHog project can be sliced
* by surface. Mirrors posthog's `frontend/src/scenes/inbox/inboxAnalytics.ts`.
*
* Keep this in sync with the inbox entries in `EventPropertyMap` above.
*/
const INBOX_ANALYTICS_EVENT_NAMES: ReadonlySet<string> = new Set([
ANALYTICS_EVENTS.INBOX_VIEWED,
ANALYTICS_EVENTS.INBOX_REPORT_OPENED,
ANALYTICS_EVENTS.INBOX_REPORT_CLOSED,
ANALYTICS_EVENTS.INBOX_REPORT_ACTION,
ANALYTICS_EVENTS.INBOX_REPORT_ACTION_RESULT,
ANALYTICS_EVENTS.INBOX_REPORT_SCROLLED,
ANALYTICS_EVENTS.INBOX_REPORT_FEEDBACK,
ANALYTICS_EVENTS.INBOX_REPORT_FEEDBACK_NOTE,
ANALYTICS_EVENTS.INBOX_REPORT_SOURCE_SUGGESTION_SHOWN,
ANALYTICS_EVENTS.INBOX_REPORT_SOURCE_SUGGESTION_CLICKED,
ANALYTICS_EVENTS.INBOX_TRIAGE_STARTED,
ANALYTICS_EVENTS.INBOX_TRIAGE_ENDED,
ANALYTICS_EVENTS.SIGNAL_SOURCE_CONNECTED,
]);
/** True when `eventName` is an inbox event that should carry `inbox_client`. */
export function isInboxAnalyticsEvent(eventName: string): boolean {
return INBOX_ANALYTICS_EVENT_NAMES.has(eventName);
}