package v1.public.events.dbt_wizard
Get desktop application:
View/edit binary Protocol Buffers messages
message
dbt_wizard.proto:109Emitted immediately at binary launch, before onboarding or thread creation.
optional enrichment = 1
string event_id = 2
string user_id = 3
Anonymous UUID from ~/.dbt/.user.yml (created on first run).
string account_id = 4
dbt Cloud account ID (empty if unauthenticated).
string account_identifier = 5
string version = 6
string os = 7
string arch = 8
bool is_first_run = 9
Whether this is the first time the binary has run (no .user.yml existed).
string launch_source = 10
How the app was launched: "cli", "vscode", "desktop", "mcp_server".
int64 launched_at = 11
Unix timestamp of launch.
bool is_wizard_internal = 12
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:202Emitted on structured errors (sidecar crashes, provider auth failures, panics).
optional enrichment = 1
string event_id = 2
string session_id = 3
Empty if error occurs before session starts.
string error_category = 4
"sidecar_startup" | "provider_auth" | "thread_start" | "turn_failure" | "panic" | "connection_lost"
string error_code = 5
Structured code: "health_timeout", "401", "connection_refused", etc.
string error_class = 6
Rust error type name (no message content).
string component = 7
"litellm_sidecar" | "app_server" | "tui" | "core" | "provider" | "cloud_requirements" | "mcp"
string provider = 8
"anthropic" | "openai" | "bedrock" | "" if not provider-related.
string model = 9
bool is_recoverable = 10
int32 retry_count = 11
string version = 12
string os = 13
string arch = 14
string user_id = 15
string account_id = 16
string account_identifier = 17
int64 occurred_at = 18
bool is_wizard_internal = 19
Whether the WIZARD_INTERNAL env var was set for this session.
string anonymous_id = 20
Stable anonymous client id, present even before a session exists.
message
dbt_wizard.proto:237Emitted when a user submits feedback via /feedback.
optional enrichment = 1
string event_id = 2
Unique identifier for this event.
string session_id = 3
Session correlation ID (thread_id).
string category = 4
Feedback category: "bad_result", "good_result", "bug", "safety_check", "other".
string reason = 5
Optional user-provided note describing the feedback.
bool include_logs = 6
Deprecated; feedback no longer uploads logs.
string user_id = 7
Authenticated dbt Cloud user ID (JWT sub claim); falls back to anonymous UUID from ~/.dbt/.user.yml when unauthenticated.
string account_id = 8
Numeric dbt Cloud account ID (from JWT claims or dbt_cloud.yml).
string account_identifier = 9
Global dbt Cloud account identifier slug (from /api/v2/accounts/{id}/).
string version = 10
dbt-wizard binary version.
string os = 11
Operating system: "macos", "linux", "windows".
string arch = 12
CPU architecture: "aarch64", "x86_64".
string turn_id = 13
Turn correlation ID (which turn the feedback is about).
string model = 14
Model slug active during the session (e.g. "claude-sonnet-4-6").
bool is_wizard_internal = 15
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:134Emitted once per onboarding step transition.
optional enrichment = 1
string event_id = 2
string user_id = 3
string account_id = 4
string account_identifier = 5
string step = 6
Step name: "auth", "trust_directory", "dbt_project_setup", "provider_setup".
string step_status = 7
Step outcome: "started", "completed", "skipped", "abandoned".
int64 step_duration_ms = 8
Time spent on this step.
bool is_first_run = 9
First time user ever onboards (no prior .user.yml).
string version = 10
string os = 11
string arch = 12
string auth_method = 13
Auth step: "dbt_platform" | "api_key" | "chatgpt"
string provider_configured = 14
Provider step: "anthropic" | "openai" | "bedrock" | "azure" | "snowflake" | "dbt"
string trust_decision = 15
Trust step: "trust" | "deny"
bool dbt_project_detected = 16
dbt project step: whether a dbt_project.yml was found
int32 step_index = 17
Position in the flow (0-based)
int32 total_steps_shown = 18
Total steps shown to this user
bool is_wizard_internal = 19
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:10Emitted once at session start and once at session end.
optional enrichment = 1
string event_id = 2
Unique identifier for this event.
string session_id = 3
Session correlation ID (thread_id).
string progress = 4
"start" or "end".
string session_source = 5
Client name: "cli", "vscode", "desktop", "mcp_server".
string model = 6
Model slug (e.g. "claude-sonnet-4-20250514").
string version = 7
dbt-wizard binary version.
string os = 8
Operating system: "macos", "linux", "windows".
string arch = 9
CPU architecture: "aarch64", "x86_64".
string user_id = 10
Authenticated dbt Cloud user ID (JWT sub claim); falls back to anonymous UUID from ~/.dbt/.user.yml when unauthenticated.
int64 duration_ms = 11
0 on start; total session wall-clock time on end.
string result_type = 12
Empty on start; "completed", "failed", or "interrupted" on end.
int32 turn_count = 13
0 on start; total turn count on end.
int64 total_tokens = 14
0 on start; cumulative token usage on end.
string account_id = 15
Numeric dbt Cloud account ID (from JWT claims or dbt_cloud.yml).
string account_identifier = 16
Global dbt Cloud account identifier slug (from /api/v2/accounts/{id}/).
bool is_wizard_internal = 17
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:171Emitted at subagent start and end to track full lifecycle.
optional enrichment = 1
string event_id = 2
string session_id = 3
Parent session (the main thread_id).
string subagent_thread_id = 4
The subagent's own thread_id.
string subagent_source = 5
"review" | "compact" | "thread_spawn" | "memory_consolidation" | "other"
string model = 6
string progress = 7
"start" | "end"
string status = 8
Only on "end": "completed" | "failed" | "interrupted"
int64 duration_ms = 9
0 on start; populated on end.
int32 turn_count = 10
int64 total_tokens = 11
int32 depth = 12
Nesting depth (0 = direct child of main session).
string user_id = 13
string account_id = 14
string account_identifier = 15
bool is_wizard_internal = 16
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:85Emitted once per tool invocation.
optional enrichment = 1
string event_id = 2
Unique identifier for this event.
string session_id = 3
Session correlation ID (thread_id).
string turn_id = 4
Turn correlation ID.
string tool_type = 5
Tool category: "builtin", "mcp", "shell", "subagent".
string tool_name = 6
Specific tool name (e.g. "dbt_index.search", "apply_patch").
bool is_error = 7
Whether the tool call resulted in an error.
int64 execution_time_ms = 8
Tool execution wall-clock time.
bool is_wizard_internal = 9
Whether the WIZARD_INTERNAL env var was set for this session.
message
dbt_wizard.proto:51Emitted once per turn completion.
optional enrichment = 1
string event_id = 2
Unique identifier for this event.
string session_id = 3
Session correlation ID (thread_id).
string turn_id = 4
Turn correlation ID.
string model = 5
Model slug used for this turn.
string status = 6
Turn outcome: "completed", "failed", "interrupted".
int64 duration_ms = 7
Turn wall-clock duration.
int64 input_tokens = 8
Token usage breakdown.
int64 cached_input_tokens = 9
int64 output_tokens = 10
int64 reasoning_output_tokens = 11
int64 total_tokens = 12
int32 tool_call_count = 13
Number of tool calls made during this turn.
bool is_first_turn = 14
Whether this is the first turn in the session.
string collaboration_mode = 15
Collaboration mode: "Default", "Plan", etc.
bool is_wizard_internal = 16
Whether the WIZARD_INTERNAL env var was set for this session.