Struct EventBuilder 

pub struct EventBuilder { /* private fields */ }

Builder for creating Event instances with an ergonomic API.

Provides helper methods that group related fields together and accept non-Option values directly, reducing verbosity compared to chained with_* calls.

Method variants

• Regular setters (e.g., framework(), model()) accept values directly and always set the field.
• Optional setters (e.g., framework_opt(), model_opt()) accept Option<T> and only set the field if Some is passed; None preserves any previously set value.
• Grouped helpers (e.g., tokens(), cache_tokens(), tool()) set multiple related fields at once for common patterns.

Example

use mi6_core::{EventBuilder, EventType};

// Building an API request event
let event = EventBuilder::new("machine-1", EventType::ApiRequest, "session-123")
    .framework("claude")
    .tokens(1000, 500)
    .cache_tokens(200, 0)
    .cost(0.05)
    .model("claude-3-opus")
    .build();

// Building a hook event
let event = EventBuilder::new("machine-1", EventType::PreToolUse, "session-123")
    .framework("claude")
    .tool("toolu_123", "Bash")
    .payload(r#"{"command": "ls"}"#)
    .build();

// Using _opt methods to conditionally set fields
let maybe_model: Option<String> = Some("claude-3-opus".to_string());
let event = EventBuilder::new("machine-1", EventType::ApiRequest, "session-123")
    .model_opt(maybe_model)  // Sets model to "claude-3-opus"
    .model_opt(None)         // Does nothing, preserves "claude-3-opus"
    .build();

Implementations

impl EventBuilder

pub fn new( machine_id: impl Into<String>, event_type: EventType, session_id: impl Into<String>, ) -> Self

Create a new EventBuilder with required fields.

The timestamp is set to the current time; use timestamp() to override.

pub fn build(self) -> Event

Build the final Event.

pub fn tokens(self, input: i64, output: i64) -> Self

Set input and output tokens together.

pub fn cache_tokens(self, read: i64, write: i64) -> Self

Set cache read and cache write tokens together.

pub fn tool( self, tool_use_id: impl Into<String>, tool_name: impl Into<String>, ) -> Self

Set tool_use_id and tool_name together (common for tool events).

pub fn framework(self, framework: impl Into<String>) -> Self

Set the framework.

pub fn model(self, model: impl Into<String>) -> Self

Set the model.

pub fn cost(self, cost_usd: f64) -> Self

Set the cost in USD.

pub fn duration_ms(self, duration: i64) -> Self

Set the duration in milliseconds.

pub fn timestamp(self, timestamp: DateTime<Utc>) -> Self

Set the timestamp.

pub fn payload(self, payload: impl Into<String>) -> Self

Set the payload JSON string.

pub fn metadata(self, metadata: impl Into<String>) -> Self

Set the metadata JSON string.

pub fn tool_use_id(self, tool_use_id: impl Into<String>) -> Self

Set the tool_use_id.

pub fn tool_name(self, tool_name: impl Into<String>) -> Self

Set the tool_name.

pub fn spawned_agent_id(self, spawned_agent_id: impl Into<String>) -> Self

Set the spawned_agent_id.

pub fn subagent_type(self, subagent_type: impl Into<String>) -> Self

Set the subagent_type.

pub fn permission_mode(self, permission_mode: impl Into<String>) -> Self

Set the permission_mode.

pub fn transcript_path(self, transcript_path: impl Into<String>) -> Self

Set the transcript_path.

pub fn cwd(self, cwd: impl Into<String>) -> Self

Set the cwd.

pub fn git_branch(self, git_branch: impl Into<String>) -> Self

Set the git_branch.

pub fn pid(self, pid: i32) -> Self

Set the pid.

pub fn process_start_time(self, start_time: i64) -> Self

Set the process_start_time.

pub fn framework_opt(self, framework: Option<String>) -> Self

Set the framework if Some.

pub fn timestamp_opt(self, timestamp: Option<DateTime<Utc>>) -> Self

Set the timestamp if Some.

pub fn tool_use_id_opt(self, tool_use_id: Option<String>) -> Self

Set the tool_use_id if Some.

pub fn tool_name_opt(self, tool_name: Option<String>) -> Self

Set the tool_name if Some.

pub fn spawned_agent_id_opt(self, spawned_agent_id: Option<String>) -> Self

Set the spawned_agent_id if Some.

pub fn subagent_type_opt(self, subagent_type: Option<String>) -> Self

Set the subagent_type if Some.

pub fn permission_mode_opt(self, permission_mode: Option<String>) -> Self

Set the permission_mode if Some.

pub fn transcript_path_opt(self, transcript_path: Option<String>) -> Self

Set the transcript_path if Some.

pub fn cwd_opt(self, cwd: Option<String>) -> Self

Set the cwd if Some.

pub fn git_branch_opt(self, git_branch: Option<String>) -> Self

Set the git_branch if Some.

pub fn pid_opt(self, pid: Option<i32>) -> Self

Set the pid if Some.

pub fn process_start_time_opt(self, start_time: Option<i64>) -> Self

Set the process_start_time if Some.

pub fn model_opt(self, model: Option<String>) -> Self

Set the model if Some.

pub fn tokens_cache_read_opt(self, tokens: Option<i64>) -> Self

Set the tokens_cache_read if Some.

pub fn tokens_cache_write_opt(self, tokens: Option<i64>) -> Self

Set the tokens_cache_write if Some.

pub fn cost_opt(self, cost: Option<f64>) -> Self

Set the cost_usd if Some.

pub fn duration_ms_opt(self, duration: Option<i64>) -> Self

Set the duration_ms if Some.

pub fn metadata_opt(self, metadata: Option<String>) -> Self

Set the metadata if Some.

pub fn payload_opt(self, payload: Option<String>) -> Self

Set the payload if Some.

pub fn source(self, source: impl Into<String>) -> Self

Set the data source (hook, otel, transcript).

pub fn is_sidechain(self, is_sidechain: bool) -> Self

Set whether this is a sidechain request.

pub fn is_sidechain_opt(self, is_sidechain: Option<bool>) -> Self

Set is_sidechain if Some.

pub fn context_size(self, context_size: i64) -> Self

Set the context window size.

Trait Implementations

impl Clone for EventBuilder

fn clone(&self) -> EventBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EventBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.