Struct InvocationRecord 

pub struct InvocationRecord {

    pub id: Uuid,
    pub session_id: String,
    pub timestamp: DateTime<Utc>,
    pub duration_ms: Option<i64>,
    pub cwd: String,
    pub cmd: String,
    pub executable: Option<String>,
    pub exit_code: i32,
    pub format_hint: Option<String>,
    pub client_id: String,
    pub hostname: Option<String>,
    pub username: Option<String>,
    pub tag: Option<String>,
}

An invocation record (a captured command/process execution).

Fields

id: Uuid

Unique identifier (UUIDv7 for time-ordering).

session_id: String

Session identifier (groups related invocations).

timestamp: DateTime<Utc>

When the invocation started.

duration_ms: Option<i64>

How long the invocation took in milliseconds.

cwd: String

Working directory when invocation was executed.

cmd: String

The full command string.

executable: Option<String>

Extracted executable name (e.g., “make” from “make test”).

exit_code: i32

Exit code.

format_hint: Option<String>

Detected output format (e.g., “gcc”, “pytest”).

client_id: String

Client identifier (user@hostname).

hostname: Option<String>

Hostname where invocation was executed.

username: Option<String>

Username who executed the invocation.

tag: Option<String>

User-defined tag (unique alias for this invocation, like git tags).

Implementations

impl InvocationRecord

pub fn new( session_id: impl Into<String>, cmd: impl Into<String>, cwd: impl Into<String>, exit_code: i32, client_id: impl Into<String>, ) -> Self

Create a new invocation record.

If BIRD_INVOCATION_UUID is set in the environment, uses that UUID to enable deduplication across nested BIRD clients.

pub fn with_id( id: Uuid, session_id: impl Into<String>, cmd: impl Into<String>, cwd: impl Into<String>, exit_code: i32, client_id: impl Into<String>, ) -> Self

Create a new invocation record with an explicit UUID.

Use this when you need to control the UUID (e.g., for testing or when the UUID is provided externally).

pub fn is_inherited() -> bool

Check if this invocation was inherited from a parent BIRD client.

pub fn parent_client() -> Option<String>

Get the parent BIRD client name, if any.

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

Set the duration.

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

Set the format hint.

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

Set the tag (unique alias for this invocation).

pub fn date(&self) -> NaiveDate

Get the date portion of the timestamp (for partitioning).

Trait Implementations

impl Clone for InvocationRecord

fn clone(&self) -> InvocationRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InvocationRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InvocationRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InvocationRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.